Isochrone Tool
isochrone_toolRead-onlyIdempotent
Compute areas reachable within a given travel time or distance from a coordinate. Returns GeoJSON contours for displaying 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'
Input Schema
TableJSON 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
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | ||
| features | Yes |