Delivery route optimization task example

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:

Collecting milk from farms
Find the best route for trucks according to capacity constraints
Catering service planner
Plan routes and scheduling for daily lunch delivery
Repair and maintenance service
Manage workflows and schedules according to time windows available
School buses route optimization
Find optimal routes for school buses
Deliver post / pickup returns
Plan cost-efficient post truck routes
Newspaper / Advertisement distribution
Find optimal walking routes for distributors
Food delivery with priorities
Calculate optimal bicycles routes for delivery boys according to priorities
Optimize repairman routes
Plan routes and schedules according to each worker's tools and skills
Waste collection optimization
Optimize routes for gabage trucks according to truck capacities
Car sharing planning
Organize people pickups for shared cars
Collecting milk from farms
Find the best route for trucks according to capacity constraints
Catering service planner
Plan routes and scheduling for daily lunch delivery

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

Pickup and delivery, scheduling, logistics problems

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
Solve problems with capacity and capability constraints

VRP with Constraints

Solve routing problems with constraints:

  • Set vehicle/agent capacity constraints
  • Add vehicle/agent capabilities: feature, tools, skills
  • Add job requirements
Set working hours, service hours, opening hours

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:

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!

World map

Add Route Planning to your platform!

Solve business tasks and optimize workflows with Route Planner API!

Contact us in case of any questions, and we will be happy to answer them!