curl --request POST \
--url https://api.footstep.ai/v1/routing/isochrone \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"locations": [
{
"lat": 51.5322,
"lon": -0.124
}
],
"travel": "pedestrian",
"contours": [
{
"time": 5,
"color": "ff0000"
},
{
"time": 10,
"color": "ffff00"
},
{
"time": 15,
"color": "00ff00"
}
]
}
'{
"origin": {
"lat": 0,
"lon": 0
},
"travel": "<string>",
"contours": [
{
"metric": "time",
"value": 123,
"geometry": {
"type": "Polygon",
"coordinates": "<unknown>"
},
"reachable_places": [
{
"name": "<string>",
"label": "<string>",
"place_type": "<string>",
"coordinates": {
"lat": 123,
"lng": 123
}
}
]
}
]
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}Calculate Isochrone
Compute reachability polygons (isochrones) from an origin point. Pass from as a place name and the origin is geocoded for you, or pass locations if you already have coordinates. Returns one or more contour polygons capped by time or distance.
curl --request POST \
--url https://api.footstep.ai/v1/routing/isochrone \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"locations": [
{
"lat": 51.5322,
"lon": -0.124
}
],
"travel": "pedestrian",
"contours": [
{
"time": 5,
"color": "ff0000"
},
{
"time": 10,
"color": "ffff00"
},
{
"time": 15,
"color": "00ff00"
}
]
}
'{
"origin": {
"lat": 0,
"lon": 0
},
"travel": "<string>",
"contours": [
{
"metric": "time",
"value": 123,
"geometry": {
"type": "Polygon",
"coordinates": "<unknown>"
},
"reachable_places": [
{
"name": "<string>",
"label": "<string>",
"place_type": "<string>",
"coordinates": {
"lat": 123,
"lng": 123
}
}
]
}
]
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}Authorizations
Your Footstep API key
Body
1 - 4 elementsShow child attributes
Show child attributes
Single origin location as coordinates (length 1). Use this when you already have lat/lon; otherwise prefer from.
1 elementShow child attributes
Show child attributes
auto, bicycle, pedestrian, bus, truck Fine-tuning options. Include only the key matching your travel type.
Show child attributes
Show child attributes
0 = detailed, 1 = smoothed
0 <= x <= 1Response format. footstep = optimised for app developers (encoded polyline, flat structure). geojson = standard GeoJSON FeatureCollection (decoded coordinates, immediately usable in Leaflet/Mapbox GL/deck.gl).
footstep, geojson Origin place name (e.g. 'Kings Cross, London'). Geocoded internally. Provide either from OR locations, not both.