Routing

Routing API works via HTTP Get request and allows to build routes between two or multiple locations.

The typical request URL of Routing API looks like:


https://api.geoapify.com/v1/routing?waypoints=48.261712774007066,10.98564147949219|48.20911695037711,11.334800720214844&mode=drive&apiKey=YOUR_API_KEY


Required parameters:

  • waypoints - coordinates of locations separated with "|". Each coordinate is a pair of latitude and longitude, separated with a comma - lat,lon.
  • mode - travel mode
  • apiKey - your Geoapify key

Optional parameters:

  • lang - desirable language for addresses and turn-by-turn instructions. 2-character ISO 639-1 language code. Defaults to English (lang=en).

The response returned contains a GeoJSON FeatureCollection object with a feature of "MultiLineString" type, which represents the route. Properties of the feature contain information about time in seconds, distance in meters, and route steps for each consecutive pair of locations.

NOTE! Routing requests for multiple locations (more than 1 pair of locations) are charges as multiple requests (1 pair of locations as 1 request).