Isochrone Tool
isochrone_toolComputes reachable areas within a specified travel time from a location and returns them as GeoJSON polygon or line contours for map display, helping compare travel ranges by mode.
Instructions
Computes areas that are reachable within a specified amount of time from a location, and returns the reachable regions as contours of Polygons or LineStrings in GeoJSON format that you can display on a map. Common use cases: - Show a user how far they can travel in X minutes from their current location - Determine whether a destination is within a certain travel time threshold - Compare travel ranges for different modes of transportation'
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"coordinates": "<coordinates>",
"generalize": "<generalize>"
},
"name": "isochrone_tool"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| denoise | No | A floating point value that can be used to remove smaller contours. A value of 1.0 will only return the largest contour for a given value. | |
| exclude | No | Exclude certain road types and custom locations from routing. | |
| profile | No | Mode of travel. | mapbox/driving-traffic |
| polygons | No | Whether to return Polygons (true) or LineStrings (false). | |
| depart_at | No | An ISO 8601 date-time string representing the time to depart (format string: YYYY-MM-DDThh:mmss±hh:mm). | |
| generalize | Yes | Positive number in meters that is used to simplify geometries. - Walking: use 0-500. Prefer 50-200 for short contours (minutes < 10 or meters < 5000), 300-500 as they grow. - Driving: use 1000-5000. Start at 2000, use 3000 if minutes > 10 or meters > 20000. Use 4000-5000 if near 60 minutes or 100000 meters. | |
| coordinates | Yes | A coordinate object with longitude and latitude properties around which to center the isochrone lines. Longitude: -180 to 180, Latitude: -85.0511 to 85.0511 | |
| contours_colors | No | Contour colors as hex strings without starting # (for example ff0000 for red. must match contours_minutes or contours_meters length if provided). | |
| contours_meters | No | Distances in meters. Distances must be in increasing order. Must be specified either contours_minutes or contours_meters. | |
| contours_minutes | No | Contour times in minutes. Times must be in increasing order. Must be specified either contours_minutes or contours_meters. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | ||
| features | Yes | ||
| mapboxRender | No | Map-payload reference for `render_map_tool`. Surfaced so the LLM can chain the next call without re-emitting geometry. |