Sign in

v1

latestOpenAPI 3.1.02026-08-0420183200.9 KB
Routing

Calculate areas of equal travel time from a location.

The isochrone API computes reachable areas within a time or distance constraint. The resulting polygon can be rendered on a map and used for assessing urban mobility, planning, or as a search filter of places within a constrained range.

post/isochrone/v1

Request body

idstring

An identifier to disambiguate requests (echoed by the server).

costing'auto' | 'auto_traffic' | 'auto_traffic_premium' | 'bus' | 'bus_traffic' | 'bus_traffic_premium' | 'taxi' | 'taxi_traffic' | 'taxi_traffic_premium' | 'truck' | 'truck_traffic' | 'truck_traffic_premium' | 'bicycle' | 'bikeshare' | 'motor_scooter' | 'motorcycle' | 'pedestrian' | 'low_speed_vehicle' required
polygonsboolean

If true, the generated GeoJSON will use polygons. The default is to use LineStrings. Polygon output makes it easier to render overlapping areas in some visualization tools (such as MapLibre renderers).

denoisenumber double

A value in the range [0, 1] which will be used to smooth out or remove smaller contours. A value of 1 will only return the largest contour for a given time value. A value of 0.5 drops any contours that are less than half the area of the largest contour in the set of contours for that same time value.

generalizenumber double

The value in meters to be used as a tolerance for Douglas-Peucker generalization.

show_locationsboolean

If true, then the output GeoJSON will include the input locations as two MultiPoint features: one for the exact input coordinates, and a second for the route network node location that the point was snapped to.

Example request

{
  "contours": [
    {
      "color": "aabbcc",
      "time": 5
    }
  ],
  "costing": "pedestrian",
  "id": "kesklinn",
  "locations": [
    {
      "lat": 59.436884,
      "lon": 24.742595
    }
  ],
  "polygons": true
}

Response

A GeoJSON object which can be integrated into your geospatial application.

idstring
type'FeatureCollection' required

Example response

{
  "features": [
    {
      "geometry": {
        "coordinates": [
          [
            -73.985021,
            40.753501
          ],
          [
            -73.983892,
            40.75163
          ],
          [
            -73.982508,
            40.751546
          ],
          [
            -73.981969,
            40.751014
          ],
          [
            -73.977881,
            40.739014
          ],
          [
            -73.979577,
            40.738083
          ],
          [
            -73.980361,
            40.737014
          ],
          [
            -73.988508,
            40.73467
          ],
          [
            -73.990508,
            40.733708
          ],
          [
            -73.991514,
            40.734008
          ],
          [
            -73.994628,
            40.733894
          ],
          [
            -73.995388,
            40.734134
          ],
          [
            -73.995662,
            40.73486
          ],
          [
            -73.996508,
            40.735006
          ],
          [
            -73.998508,
            40.734576
          ],
          [
            -74.003292,
            40.746014
          ],
          [
            -74.004016,
            40.749014
          ],
          [
            -74.002508,
            40.749907
          ],
          [
            -73.993508,
            40.751786
          ],
          [
            -73.987508,
            40.75397
          ],
          [
            -73.985021,
            40.753501
          ]
        ],
        "type": "LineString"
      },
      "properties": {
        "color": "#ff0000",
        "contour": 15,
        "fill": "#ff0000",
        "fill-opacity": 0.33,
        "fillColor": "#ff0000",
        "fillOpacity": 0.33,
        "metric": "time",
        "opacity": 0.33
      },
      "type": "Feature"
    }
  ],
  "type": "FeatureCollection"
}