Routing API
This Routing API calculates a route between two or more waypoints for cars, trucks, bicycles, transit, and walking. The API returns the route geometry in GeoJSON format, along with Route Directions or turn-by-turn instructions and time/distance values for each step.
The Routing API makes it easy to create applications that route vehicles and people from one location to another, such as delivery, logistics, or traveling-sales applications.
Try Routing API
Click on the map to set a starting point and destination points, choose the transportation mode - car, truck, bicycle, pedestrian, or transit:
Try more options with our Playground or get an API key and start using it now! We have a Freemium pricing model. Start now for Free and extend when you need it!
Features and options
Build routes according to your needs and preferences
Skip gates, roads, and countries
The Routing API lets to set barriers that do not allow building a route through them. It can be specific locations (tunnels and bridges), roads, and whole countries.
Avoid unwanted parts
Similar to barriers, you can avoid unwanted route parts - ferries, toll roads, highways. The Routing algorithms will offer alternative routes when it's possible.
Choose suitable roads
You can specify vehicle parameters to choose suitable roads. For example, provide the required height to avoid too low tunnels or passes.
Directions and instructions
The navigation instructions are provided within every route result. For example, “Drive west on Freisinger Straße/DAH 9” or “Enter the roundabout and take the 2nd exit”. The API supports instructions in English, German, Italian, Spanish, French, and other languages.
Transportation modes
We support different transportation modes, including "drive", "truck", "transit" (multi-modal public transportation), "walk", and "bicycle".
Transit routing uses the official bus, tram, and train schedules if available and falls back to approximated results where necessary.
Easy-to-use and permissive
The Routing API is accessible via HTTP GET requests and easy to integrate with any programming language. Moreover, it returns a GeoJSON object as a result.
Our Routing API is open-data-based. Therefore, you can store and redistribute the results!
Contact us if you need more features for the Routing API. We can provide you with other options on request.
Need to find an optimal route between multiple locations?
Use the Routing API combined with the Route Planner API to calculate the optimal routes between up to 1000 waypoints for multiple vehicles or agents.
Unlike the Routing API, which returns routes between waypoints in a pre-defined order, the Route Planner API solves a vehicle routing problem (VRP) and provides the optimal route between your stops.
Routing API pricing
Our platform is based on open data. As a result, we offer Affordable Prices for businesses of all sizes.
We use a system of credits to determine the price. For example, the Free plan includes up to 3000 credits/day. Therefore, each API call costs a certain number of credits:
- Each pair of waypoints costs at 1 credit.
- Additional credit is given for every 500 kilometers of result route length if the route length is more than 500 kilometers.
You can use the Pricing Calculator to estimate how many credits you need. For example, the route on the picture costs 4 units of credit.
Getting started
Works via HTTP and returns a GeoJSON object
Step 1. Register and get an API Key
You will require an API Key to use the API. Register on Geoapify MyProjects and get an API key.
Step 2. Generate and call HTTP Get request
Generate an HTTP Get request with input data and make the call. Use our Playground and Documentation to learn about Routing API request/response structure.
Here's an example of a Routing API URL that calculates a route between 5 waypoints for bicycle:
https://api.geoapify.com/v1/routing?waypoints=47.569664,10.7021002|47.575734,10.720492|47.567089,10.733584|47.557827,10.749579|47.544780,10.722865&mode=bicycle&apiKey=YOUR_API_KEYHere is the response object returned by the API call:
- [] 1 item▶
- {} 3 keys▶
- "Feature"
- {} 5 keys▶
- {} 2 keys▶
- {} 2 keys▶
- "bicycle"
- [] 5 items▶
- "FeatureCollection"
The response has one feature of MultiLineString. The feature properties contain waypoints and route legs. Each route leg includes time/distance information and Directions instructions.
The code samples below show you how to make an API call with different programming languages:
fetch('https://api.geoapify.com/v1/routing?waypoints=48.184731,11.547931|48.168254,11.581501|48.179391,11.612174&mode=drive&apiKey=YOUR_API_KEY')
.then(resp => resp.json())
.then((calculatedRouteGeoJSON) => {
console.log(calculatedRouteGeoJSON);
});
Find more code samples on calling the Routing API, parsing, and drawing results on the Documentation page >>
FAQ
How do you bill Routing API Requests?
A route between every pair of waypoints is counted as a credit. Learn more about the API pricing on the API Documentation page.
How is a 'Truck' mode is different from a 'Drive' mode?
The 'Truck' mode takes into account road restrictions for trucks, avoids thin roads and residential areas, prefers routes with fewer maneuvers.
I need to build routes for heavy transport. Can your API do that?
The Geoapify Routing API have a very flexible and powerful engine under the hood. Contact us and we will create a model that solves your business case.
How good is coverage for public transport?
We use official GTFS feeds when they are available and approximated model for other places. This let us to provide worldwide coverage for public transport. Contact us!
Can we use custom GTFS feeds with your Routing API?
Sure! We can setup a dedicated server for you that builds routes with your GTFS feeds.
Can you provide custom conditions for high volumes?
Yes! Contact us and we will find conditions beneficial for both sides!
More Routing APIs
We have more APIs that can be used in combination with Routing API or separately
Route Matrix API
Geoapify Route Matrix API lets to calculate a time-distance matrix for a large number of locations.
Map Matching API
Geoapify Map Matching API lets to span GPS-coordinates to existing roads and get detailed information about the roads.
Route Planner API
Geoapify Route Planner API solves route optimization and route planning problems (VRP and its variants) to find optimal delivery routes, generate schedules, and plan usage of shared resources.
