distance/route
Calculate distance (airline, car routing) between points
Calculate airline and car routing distances between multiple points.
Get car routing distances
Get flight distances
Get equal distances
POST /api/v2/distance/route HTTP/1.1
Host: api.distance.tools
X-Billing-Token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 44
{
"route": [
{
"name": "text",
"country": "text"
}
]
}{
"route": {
"vincenty": 1,
"haversine": 1,
"greatCircle": 1,
"car": {
"distance": 1,
"duration": 1,
"status": "text"
}
},
"steps": [],
"points": []
}Request Body
The route object defines a route with all its waypoints and has a minimum of two waypoints and a maximum of 75 waypoints.
{
"route": [{
"name": "Berlin", // Required: Any input text or lat,lng
"country": "DEU" // Optional: ISO 3166-1 alpha-3 country code
},{
"name": "Hamburg", // Required: Any input text or lat,lng
"country": "DEU" // Optional: ISO 3166-1 alpha-3 country code
},{
"name": "52.5162,13.37795"
},{
...
}]
}Waypoint
A waypoint describes each step of a route and is defined as its required name field and an optional country field to specify its specific location.
{
"name": "Berlin", // Required: Any input text or lat,lng
"country": "DEU" // Optional: ISO 3166-1 alpha-3 country code
}The name field can contain any textual information about the location like postal address, city or region, postal code, IATA code, what3words or a coordinate in the format latitude,longitude. If using coordinate or what3words you do not need to specify the country. Learn more about input and geocoding.
Response
A Distance API response consists of 3 main parts. route contains summarized info about route between all waypoints. points array contains additional information about the waypoints of the requested route. steps array describes distance, duration and travel information for the ways between each waypoints.
{
"route": { ... }, // Contains summarized info about route between all waypoints
"points": [...], // Contains geocoding & geographical information of waypoints
"steps": [...] // Contains routing information of each step of a route
}Route
The route object contains summarized information about the route between all waypoints. This object is available in responses from all endpoints returning route information.
Airline distance
{
"route": {
"vincenty": 709.63, // airline distance in Kilometer
"haversine": 708.6068727785872, // airline distance in Kilometer
"greatCircle": 708.6068950233187, // airline distance in Kilometer
}
}Learn more about airline distance calculation.
Car routing distance
{
"route": {
"car": {
"distance": 812.1059, // car routing distance in Kilometer
"duration": 39012.7, // car routing duration in Seconds
"status": "found" // Status weather a round was "found" or "not found"
}
}
}You'll get a HTTP status code 200 with waypoint information even if there could no car routing distance found. status flag indicates a car route was found or not found. If one of the waypoints could not be found and geocoded a 404 is returned. Learn more about response statuses.
Last updated