Isochrones
Reachability polygons.
Reachability polygons
Areas reachable within given time or distance ranges from one or more locations.
Cost: 100 elements per request, approved as a launch default on 2026-09-04. Isochrones are far more expensive to compute than a matrix lookup — a maximum-range isochrone occupies a CPU core for about twenty seconds, measured on the running engine — which is why they cost more per call than a route.
Limits today are the engine's own and are lower than hosted openrouteservice on
every axis: locations, intervals and maximum range. Exceeding any of them returns the
engine's 3004 or 3012 error naming the limit.
path Parameters
profileThe routing profile. driving-car is the only profile served. Any other value
returns the engine's own error, the same one hosted openrouteservice returns for a
profile it does not carry.
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 centres of the isochrones.
rangeThe ranges to compute, in seconds or metres depending on range_type. The engine
enforces a maximum; exceeding it returns error 3004 naming the limit.
range_typeWhether range is seconds or metres. 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.
typebboxThe engine's metadata block, passed through unchanged, plus our added element count.
Reachability polygons (explicit GeoJSON form)
Identical to POST /v2/isochrones/{profile}. This is the path openrouteservice-py
sends.
path Parameters
profileThe routing profile. driving-car is the only profile served. Any other value
returns the engine's own error, the same one hosted openrouteservice returns for a
profile it does not carry.
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 centres of the isochrones.
rangeThe ranges to compute, in seconds or metres depending on range_type. The engine
enforces a maximum; exceeding it returns error 3004 naming the limit.
range_typeWhether range is seconds or metres. 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.
typebboxThe engine's metadata block, passed through unchanged, plus our added element count.