Developers

How to consume the openrouteservice API


Rate limits

Maximum distances for directions, isochrones and matrices

ModeMaximum
Pedestrian250 km
Bicycle500 km
Car & Heavy vehicle6.000 km
Car & Heavy vehicle (with dynamic weighting)1.000 km
Wheelchair50 km

Isochrones restrictions

OptionMaximum
Locations
5
Intervals10
Distance120 km

Geocoding

OptionMaximum
Limit20

Locations restrictions

OptionMaximum
Categories5
Search radius polyline1 km
Search radius polygon1 km
Search radius location50 km

Time-distance matrix

OptionMaximum
Locations2500 (50 x 50)

API documentation

For an API-Key please sign up for the openrouteservice API and request your key. To send actual requests within this documentation authorization is needed. To do so insert your API-Key in the Authorize field (in case of an ‘Authorization Error’ please reload the website and insert your api key again).
To fire a request specify the parameters first and then click the Try it out! button below the response messages section.

Please note that the generated curl command string may contain special characters which must be encoded (more here).

Additional information, examples and tables can be found here.