A route between multiple locations in Belgium

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

Set route barriers

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 tolls, ferries, highways

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.

Road restrictions

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 stap-by-step instructions

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.

Drive, truck, transit, bicycle, and walk modes

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.

Works on every platform and with any programming language

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.

Find optimal routes

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

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_KEY

Here 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

        Time-distance matrix

        Route Matrix API

        Geoapify Route Matrix API lets to calculate a time-distance matrix for a large number of locations.

        Map Matching API

        Map Matching API

        Geoapify Map Matching API lets to span GPS-coordinates to existing roads and get detailed information about the roads.

        Solve VRP with Route Planner API

        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.

        World map

        Need to calculate routes?

        Get an API key and start using Geoapify Routing API!