Request

Learn more about the request parameter

get
Get distance

https://distanceto.p.mashape.com/get
Get distance, duration and travel information about the route along the requested waypoints
Request
Response
Headers
X-RapidAPI-Key
required
string
Your RapidAPI apiKey
Query Parameters
route
required
string
Stringified array of waypoints
car
optional
boolean
car route distance and duration
foot
optional
boolean
foot route distance and duration
200: OK
Full response of the route between Berlin and Hamburg
{
"points": [
{
"type": "Feature",
"properties": {
"type": "name",
"geocode": {
"id": 7,
"typ": "",
"name": "Berlin",
"lat": 52.523403,
"lng": 13.4114,
"visit": 10958617,
"lang": "de",
"formatted_address": "Berlin, Deutschland",
"country": "DE",
"moved": 1,
"checked": "de ",
"clean": 1,
"tz": "Europe/Berlin",
"regions": [
{
"id": 51477,
"name": "Deutschland",
"int": "Germany",
"name_en": "Germany",
"level": 2
},
{
"id": 62422,
"name": "Berlin",
"int": "Berlin",
"name_en": "Berlin",
"level": 4
},
{
"id": 16347,
"name": "Mitte",
"int": "Mitte",
"name_en": null,
"level": 9
},
{
"id": 16566,
"name": "Mitte",
"int": "Mitte",
"name_en": null,
"level": 10
}
]
},
"airports": [
{
"name": "Berlin-Tegel International Airport",
"icao": "EDDT",
"iata": "TXL",
"lat": 52.5597,
"lng": 13.2877,
"city": "Berlin",
"country": "Germany",
"distance": 9.291129591215062
},
{
"name": "Berlin-Tegel International Airport",
"icao": "EDDT",
"iata": "TXL",
"lat": 52.5597,
"lng": 13.2877,
"city": "Berlin",
"country": "Germany",
"distance": 9.291129591215062
},
{
"name": "Berlin-Schönefeld International Airport",
"icao": "EDDB",
"iata": "SXF",
"lat": 52.38,
"lng": 13.5225,
"city": "Berlin",
"country": "Germany",
"distance": 17.63921879423453
}
],
"stats": {
"antipodia": [
-166.58859999999999,
-52.523403
],
"equator": {
"distance": 5842.169356341,
"bearing": "S"
},
"northpole": 4168.515634322877,
"southpole": 15853.93626081537
}
},
"geometry": {
"type": "Point",
"coordinates": [
13.4114,
52.523403
]
}
},
{
"type": "Feature",
"properties": {
"type": "name",
"geocode": {
"id": 6,
"typ": "",
"name": "Hamburg",
"lat": 53.553406,
"lng": 9.992196,
"visit": 8759091,
"lang": "de",
"formatted_address": "Hamburg, Hamburg, Deutschland",
"country": "DE",
"moved": 1,
"checked": "de ",
"clean": 1,
"tz": "Europe/Berlin",
"regions": [
{
"id": 51477,
"name": "Deutschland",
"int": "Germany",
"name_en": "Germany",
"level": 2
},
{
"id": 62782,
"name": "Hamburg",
"int": "Hamburg",
"name_en": "Hamburg",
"level": 4
},
{
"id": 28971,
"name": "Hamburg-Mitte",
"int": "Hamburg-Mitte",
"name_en": null,
"level": 9
},
{
"id": 296011,
"name": "Neustadt",
"int": "Neustadt",
"name_en": null,
"level": 10
}
]
},
"airports": [
{
"name": "Hamburg Airport",
"icao": "EDDH",
"iata": "HAM",
"lat": 53.6304,
"lng": 9.98823,
"city": "Hamburg",
"country": "Germany",
"distance": 8.56803131953995
},
{
"name": "Hamburg Airport",
"icao": "EDDH",
"iata": "HAM",
"lat": 53.6304,
"lng": 9.98823,
"city": "Hamburg",
"country": "Germany",
"distance": 8.56803131953995
},
{
"name": "Hamburg-Finkenwerder Airport",
"icao": "EDHI",
"iata": "XFW",
"lat": 53.5353,
"lng": 9.83556,
"city": "Hamburg",
"country": "Germany",
"distance": 10.546580968714048
}
],
"stats": {
"antipodia": [
-170.007804,
-53.553406
],
"equator": {
"distance": 5956.736418256986,
"bearing": "S"
},
"northpole": 4053.948572406891,
"southpole": 15968.516797572453
}
},
"geometry": {
"type": "Point",
"coordinates": [
9.992196,
53.553406
]
}
}
],
"steps": [
{
"start": [
13.4114,
52.523403
],
"end": [
9.992196,
53.553406
],
"distance": {
"haversine": 255.73436986056421,
"greatCircle": 255.65447544186136,
"vincenty": 256.364192,
"radians": 0.0401277843810708,
"dagrees": 2.2991526862463414,
"flight": [
{
"start": "TXL",
"dest": "HAM",
"distance": 250.4652476791421,
"time": "0h 47min"
},
{
"start": "TXL",
"dest": "HAM",
"distance": 250.4652476791421,
"time": "0h 47min"
},
{
"start": "TXL",
"dest": "XFW",
"distance": 255.0300373121645,
"time": "0h 48min"
},
{
"start": "TXL",
"dest": "HAM",
"distance": 250.4652476791421,
"time": "0h 47min"
},
{
"start": "TXL",
"dest": "HAM",
"distance": 250.4652476791421,
"time": "0h 47min"
},
{
"start": "TXL",
"dest": "XFW",
"distance": 255.0300373121645,
"time": "0h 48min"
},
{
"start": "SXF",
"dest": "HAM",
"distance": 274.365865778507,
"time": "0h 49min"
},
{
"start": "SXF",
"dest": "HAM",
"distance": 274.365865778507,
"time": "0h 49min"
},
{
"start": "SXF",
"dest": "XFW",
"distance": 278.42069351973436,
"time": "0h 49min"
}
],
"foot": {
"distance": 285000,
"duration": 205770.2
},
"car": {
"distance": 288048,
"duration": 10873
}
},
"midpoint": {
"type": "Feature",
"properties": {
"type": "latlng",
"geocode": {},
"tz": "Europe/Berlin",
"regions": [
{
"id": 51477,
"name": "Deutschland",
"int": "Germany",
"name_en": "Germany",
"level": 2
},
{
"id": 62504,
"name": "Brandenburg",
"int": "Brandenburg",
"name_en": null,
"level": 4
},
{
"id": 62738,
"name": "Landkreis Prignitz",
"int": "Landkreis Prignitz",
"name_en": null,
"level": 6
},
{
"id": 1289786,
"name": "Wittenberge",
"int": "Wittenberge",
"name_en": null,
"level": 8
},
{
"id": 6910223,
"name": "Bentwisch",
"int": "Bentwisch",
"name_en": null,
"level": 9
}
],
"airports": [
{
"name": "Schwerin Parchim Airport",
"icao": "EDOP",
"iata": "SZW",
"lat": 53.427,
"lng": 11.7834,
"city": "Parchim",
"country": "Germany",
"distance": 42.05808061000665
},
{
"name": "Schwerin Parchim Airport",
"icao": "EDOP",
"iata": "SZW",
"lat": 53.427,
"lng": 11.7834,
"city": "Parchim",
"country": "Germany",
"distance": 42.05808061000665
},
{
"name": "Stendal-Borstel Airport",
"icao": "EDOV",
"iata": "ZSN",
"lat": 52.6289,
"lng": 11.8186,
"city": "Stendal",
"country": "Germany",
"distance": 47.356824697446264
}
],
"stats": {
"antipodia": [
-168.27777461177786,
-53.05065792096614
],
"equator": {
"distance": 5900.8158332695475,
"bearing": "S"
},
"northpole": 4109.869157394328,
"southpole": 15912.589879459474
}
},
"geometry": {
"type": "Point",
"coordinates": [
11.722225388222146,
53.05065792096614
]
}
},
"bearing": {
"exact": "WNW",
"rough": "W",
"bearing": 297.9699530000709
},
"time": 0
}
]
}

Headers

X-RapidAPI-Key

Authentication is made via the X-RapidAPI-Key. You can find more information about api keys and authentication in the RapidAPI docs.

Query parameter

route

The route array contains multiple objects of waypoints

[
{
"t": "Berlin"
},
{
"t": "Hamburg"
}
];

You should JSON.stringify the waypoints array before adding as query params.

Waypoint

{
"t": "Berlin", // required
"c": "DEU" // optional
}

t: Input data

The waypoints consists of a required "t" property which can include the following information to describe a waypoint:

  • Country, city or region

  • Postal address

  • Postal code (don't forget to set the correct country)

  • Airport code (iata)

  • Coordinate (latitude,longitude)

c: country

You can specify the country with the optional "c" property. Countries are defined with its ISO 3166-1 alpha-2 or alpha-3 codes (DE or DEU for germany).

If "c" is not set the first found result will be used. To use postal codes it is highly recommended to use "c".

car

If you need distances and durations of car routes between the waypoints

If you need distances and durations of foot route between the waypoints