Route Planner API
Plan the most efficient route to save time and money
- Powerful and flexible in solving vehicle route and schedule optimization problems
- Create solutions for your business or provide them as a part of your platform to your customers
- Get started with the Route Planner API for free!
Visit our Documentation page to learn more about opportunities and features, or try it now in our Playground!
Use cases of Route Planning
Route planning is an integral part of a business as it will help you get the best route to any destination, which is essential for companies that deal with logistics, delivery services, etc. Here are use cases of Route Planning for different businesses:
Live demo
We've prepared a few examples of Route Planner API in action, which you can try out with our Live Demo. The demo allows to generate a Vehicle Route Optimization task for the selected area on the map and solve it.
1. Select a task from the list
The simulator will search for locations that fit the task description and show them on the map - vehicle starting positions, residence buildings, warehouses, etc. We use Places API to search locations on the map.
2. Press Optimize to calculate routes
The Route Planner API will find the best route for vehicles or agents. You can view the results on the map and in a timeline.
3. Select a new map view to regenerate the task
You can move the map to choose a different view and press "Regenerate the task" to get new locations for the Route Planner.
Solving real-life Vehicle Routing Problems
Supporting constraints, time windows, and priorities
Types of tasks supported
Route Planner API lets develop solutions for the most well-known route optimization problems:
- Multiple vehicle routing problems
- Pickup-delivery routing optimization
- Schedules and routes for professional services
VRP with Constraints
Solve routing problems with constraints:
- Set vehicle/agent capacity constraints
- Add vehicle/agent capabilities: feature, tools, skills
- Add job requirements
VRP with Time Windows
Set Time Windows for vehicles/agents and jobs:
- Set service times
- Set working/opening hours
- Set lunch breaks
Getting started
Start quickly with API Documentation, Playground, and Code samples
The Route Planner API is a powerful and flexible tool for route optimization. It lets you define VRP tasks with restrictions and time windows.
1. Learn Route Planner API features, input, and output parameters in the Playground
We've prepared examples of tasks that can be solved with Routing Planner API in the API Playground. Choose a task that is similar to yours from a dropdown list, and check the API request object and result structure.
2. API Specification, input and output parameters
The documentation page contains detailed information about the API Specification, billing details, and code samples.
3. Get Geoapify API key
To use the API, you'll need an API Key. Register on MyProject Geoapify and get one.
4. Generate HTTP Post request
Generate an HTTP Post request with input data and make the call. You can use request objects from The API Playground as examples to yours.
Here is an example of calling Route Planner API with JavaScript:
- HTTP POST call
- Request Object Example
fetch('https://api.geoapify.com/v1/routeplanner?apiKey=YOUR_API_KEY', {
method: 'post',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify(requestObject)
}).then(res=>res.json())
.then(result => console.log(result));5. Process and visualize results
The API returns a FeatureCollection GeoJSON object as a result. As most map client libraries (MapLibre GL, Mapbox GL, Leaflet, OpenLayers, etc.) natively support GeoJSON, the result can be easily visualized on the map. Find code samples of Route Planner API data processing and GeoJSON visualization on Geoapify APIDocs.
6. Have question? Contact us!
Do not hesitate to contact us in case of any questions!
FAQ
How much does the Route Planner API cost?
The cost of a request depends on the number of locations (Agent Start & End locations, Shipment Pickup & Delivery locations, Job locations) you specify in the request. You can estimate the cost with the Pricing Details page. You can start developing your application for Free and then extend depending on your needs. We offer unmetered tariffs from 700€ / month. Check our Pricing Plans to learn more >>
Is the Route Planner API GDPR compliant?
We are a German company and provide GDPR-compliant services. Our default API endpoints always use European data centers only. Dedicated endpoints can utilize other server locations, even located in your intranet.
Which variants of VRP can be solved by Geoapify Route Planner API?
You can solve the Travelling salesman problem (TSP), Capacitated Vehicle Optimization Problem (CVRP), Vehicle Routing Problem with Time Windows (VRPTW), Multi-Depot Vehicle Routing Problem (MDVRP), and Pickup and Delivery Problem with Time Windows (PDPTW) types of vehicle routing problems.
Can I combine Constraints and Time Windows in one task?
Sure! You can solve any mix of the supported VRP variants.
We plan to integrate the Route Planner API into our ERP system and sell it to our customers. Can we do that?
Sure! You can develop your own Route Planner that uses the API and sell it.
We expect to have High Volumes of the API requests. Can we have custom conditions?
Yes! Contact us, and we will find conditions beneficial for both sides!
