Isochrones
Reachability polygons.
Reachability polygons
The area you can reach from one or more locations within the time or distance ranges you give.
What it costs
locations × 100 × (largest range ÷ reference)² elements.
- The reference is 300 seconds for a time range, or 10 km for a distance range.
- Only your largest range counts. Three bands up to 15 minutes cost the same as one band of 15 minutes.
| Request | Elements |
|---|---|
| 1 location, 5 minutes | 100 |
| 1 location, 3 bands to 15 minutes | 900 |
| 1 location, 1 hour | 14,400 |
| 2 locations, 10 minutes | 800 |
Longer ranges cost much more, because the area to search grows with the square of the range.
Limits
- The number of locations, the number of ranges and the longest range are all capped.
- On the smaller plans, a maximum-range isochrone is over the per-request limit. It's refused and not charged.
Errors
Going over a limit returns 400 (code 3004 or 3012), and the message says which limit.
path Parameters
profileThe routing profile. Only driving-car is served. Any other value returns an
"incorrect value" error.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Reachability polygons › Request Body
locationsThe centers of the isochrones.
rangeThe ranges to compute, in seconds or meters depending on range_type. There's a
maximum; going over it returns 400 (code 3004), and the message names the limit.
range_typeWhether range is seconds or meters. Default time.
intervalProduce intermediate bands at this step within each range.
unitsarea_unitslocation_typeWhether the locations are origins (start, the default) or destinations — the
difference matters on one-way roads.
attributesintersectionssmoothingidReachability polygons › Responses
Reachability polygons, as GeoJSON.
typebboxDetails about the request and the data behind the answer, plus element_count.
Reachability polygons (explicit GeoJSON form)
Identical to POST /v2/isochrones/{profile}.
path Parameters
profileThe routing profile. Only driving-car is served. Any other value returns an
"incorrect value" error.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Reachability polygons (explicit GeoJSON form) › Request Body
locationsThe centers of the isochrones.
rangeThe ranges to compute, in seconds or meters depending on range_type. There's a
maximum; going over it returns 400 (code 3004), and the message names the limit.
range_typeWhether range is seconds or meters. Default time.
intervalProduce intermediate bands at this step within each range.
unitsarea_unitslocation_typeWhether the locations are origins (start, the default) or destinations — the
difference matters on one-way roads.
attributesintersectionssmoothingidReachability polygons (explicit GeoJSON form) › Responses
Reachability polygons, as GeoJSON.
typebboxDetails about the request and the data behind the answer, plus element_count.