With the GraphHopper Directions API you can integrate A-to-B route planning, turn-by-turn navigation, route optimization, isochrone calculations and other tools in your application.

The GraphHopper Directions API consists of the following RESTful web services:

Routing API,
Route Optimization API,
Isochrone API,
Map Matching API,
Matrix API,
Geocoding API and
Cluster API.

Explore our APIs

Get started

Each API part has its own documentation. Jump to the desired API part and learn about the API through the given examples and tutorials.

In addition, for each API there are specific sample requests that you can send via Insomnia or Postman to see what the requests and responses look like.

Insomnia

To explore our APIs with Insomnia, follow these steps:

Insomnia

Postman

To explore our APIs with Postman, follow these steps:

Postman

API Client Libraries

To speed up development and make coding easier, we offer the following client libraries:

JavaScript client - try the live examples
Others like C#, Ruby, PHP, Python, ... automatically created for the Route Optimization API

Bandwidth reduction

If you create your own client, make sure it supports http/2 and gzipped responses for best speed.

If you use the Matrix, the Route Optimization API or the Cluster API and want to solve large problems, we recommend you to reduce bandwidth by compressing your POST request and specifying the header as follows: Content-Encoding: gzip. This will also avoid the HTTP 413 error "Request Entity Too Large".

Contact Us

If you have problems or questions, please read the following information:

FAQ
Public forum
Contact us
GraphHopper Status Page

To stay informed about the latest developments, you can

follow us on twitter,
read our blog,
watch our documentation repository,
sign up for our newsletter or
our forum.

Select the channel you like the most.

Map Data and Routing Profiles

Currently, our main data source is OpenStreetMap. We also integrated other network data providers. This chapter gives an overview about the options you have.

OpenStreetMap

Geographical Coverage

OpenStreetMap covers the whole world. If you want to see for yourself if we can provide data suitable for your region, please visit GraphHopper Maps. You can edit and modify OpenStreetMap data if you find that important information is missing, e.g. a weight limit for a bridge. Here is a beginner's guide that shows how to add data. If you have edited data, we usually consider your data after 1 week at the latest.

Supported Vehicle Profiles

The Routing, Matrix and Route Optimization APIs support the following vehicle profiles:

Name | Description | Restrictions | Icon -----------|:----------------------|:--------------------------|:--------------------------------------------------------- car | Car mode | car access | car image small_truck| Small truck like a Mercedes Sprinter, Ford Transit or Iveco Daily | height=2.7m, width=2+0.4m, length=5.5m, weight=2080+1400 kg | small truck image truck | Truck like a MAN or Mercedes-Benz Actros | height=3.7m, width=2.6+0.5m, length=12m, weight=13000 + 13000 kg, hgv=yes, 3 Axes | scooter | Moped mode | Fast inner city, often used for food delivery, is able to ignore certain bollards, maximum speed of roughly 50km/h | scooter image foot | Pedestrian or walking without dangerous SAC-scales | foot access | foot image hike | Pedestrian or walking with priority for more beautiful hiking tours and potentially a bit longer than foot. Walking duration is influenced by elevation differences. | foot access | hike image bike | Trekking bike avoiding hills | bike access | bike image mtb | Mountainbike | bike access | Mountainbike image racingbike| Bike preferring roads | bike access | racingbike image

Please note:

all motor vehicles (car, small_truck, truck and scooter) support turn restrictions via turn_costs=true
the free package supports only the vehicle profiles car, bike or foot
up to 2 different vehicle profiles can be used in a single optimization request. The number of vehicles is unaffected and depends on your subscription.
we offer custom vehicle profiles with different properties, different speed profiles or different access options. To find out more about custom profiles, please contact us.
a sophisticated motorcycle profile is available up on request. It is powered by the Kurviger Routing API and favors curves and slopes while avoiding cities and highways.

TomTom

If you want to include traffic, you can purchase the TomTom Add-on. This Add-on only uses TomTom's road network and historical traffic information. Live traffic is not yet considered. If you are interested to learn how we consider traffic information, we recommend that you read this article.

Please note the following:

Currently we only offer this for our Route Optimization API.
In addition to our terms, you need to accept TomTom's End User License Aggreement.
We do not use TomTom's web services. We only use their data with our software.

Contact us for more details.

Geographical Coverage

We offer

Europe including Russia
North, Central and South America
Saudi Arabia
United Arab Emirates
South Africa
Australia

Supported Vehicle Profiles

Name | Description | Restrictions | Icon -----------|:----------------------|:--------------------------|:--------------------------------------------------------- car | Car mode | car access | car image small_truck| Small truck like a Mercedes Sprinter, Ford Transit or Iveco Daily | height=2.7m, width=2+0.4m, length=5.5m, weight=2080+1400 kg | small truck image

المشاريع

الإمارات

واجهات برمجة عامة مجانية

موارد المطورين

Web Risk API

Web Security Scanner API

Workflow Executions API

Workflows API

Workload Manager API

Cloud Workstations API

YouTube Data API v3

YouTube Analytics API

YouTube Reporting API

BC Data Catalogue API

BC Geographical Names Web Service - REST API

Geocoder REST API

GeoMark Web Service REST API

Groundwater Wells, Aquifers and Registry API

WorkBC Job Posting API

BC Gov News API Service 1.0

DriveBC's Open511 API

BC Route Planner REST API

GraphHopper Directions API

Greenwire Public API

Greip API

Groundhog Day API

Discovery Market Research

GSMTasks Project API

واجهات برمجة
عامة مجانية