Skip to content
Home
Isochrone API
API Reference

Isochrone API Reference

Try the API in your browser

Base URL

https://routing.maptoolkit.net

Endpoints

GET /isochrone

Get reachable area as a polygon

Returns the area reachable from point within time minutes. The default response is an array of [lat, lng] coordinate pairs. Set format=geojson to receive a GeoJSON Feature instead.

ParameterInTypeRequiredDescription
pointquerystringYesStarting point in lat,lng format.
routeTypequerystringYes

Travel mode. Accepted values:

  • car — fastest road route
  • bike — cycling route
  • foot — walking route
  • hike — hiking route (same profile as foot)
  • roads — road cycling
  • transit — public transit (available in NRW, Germany only)
One of: car, bike, foot, hike, roads, transit.
departurequerystringNoDeparture time for transit routing as an ISO 8601 date-time string. Default: current time.
formatquerystringNoSet to geojson to receive a GeoJSON Feature. Required when routeType=transit. One of: geojson.
timequerynumberNoTravel time limit in minutes. Must be between 1 and 60. Default: 10.
tolerancequerynumberNoPolygon simplification tolerance in meters. Maximum is capped at (time_limit_minutes × 3000) meters. Default: derived from travel time and speed.
vehiclequerystringNoDeprecated. Use routeType instead. One of: car, bike, foot, hike, roads, transit.
StatusDescription
200

Isochrone polygon.

  • Without format=geojson: array of [lat, lng] coordinate pairs.
  • With format=geojson: GeoJSON Feature with a Polygon geometry (coordinates in [lng, lat] order per GeoJSON spec).
400

Bad request.

Parameter validation errors

  • Missing required parameter: point — point parameter is missing or empty.
  • Parameter 'time' must be a positive number — time is not a valid positive number.
  • Parameter 'time' must not exceed 60 minutes — time exceeds the maximum limit of 60 minutes.

Transit errors

  • Cannot parse departure time! — departure value is not a valid date string.
  • format=geojson is mandatory on isochrone request for transit! — format=geojson must be set when using routeType=transit.

General errors

  • Upstream routing engine error message forwarded as-is.

POST /isochrone

Get reachable area as a polygon (POST)

Same as GET but accepts parameters in the request body. Useful when parameter values are long.

StatusDescription
200

Isochrone polygon.

  • Without format=geojson: array of [lat, lng] coordinate pairs.
  • With format=geojson: GeoJSON Feature with a Polygon geometry (coordinates in [lng, lat] order per GeoJSON spec).
400

Bad request.

Parameter validation errors

  • Missing required parameter: point — point parameter is missing or empty.
  • Parameter 'time' must be a positive number — time is not a valid positive number.
  • Parameter 'time' must not exceed 60 minutes — time exceeds the maximum limit of 60 minutes.

Transit errors

  • Cannot parse departure time! — departure value is not a valid date string.
  • format=geojson is mandatory on isochrone request for transit! — format=geojson must be set when using routeType=transit.

General errors

  • Upstream routing engine error message forwarded as-is.

Try it

The console below sends live requests against the endpoints above. You can browse it without an API key; Execute needs one, because every endpoint requires the api_key query parameter and returns 403 without it. Use Authorize to add your key. See First Steps if you do not have one yet.