Request
Learn more about the request parameter
getGet distance
get
https://distanceto.p.mashape.com/get
Get distance, duration and travel information about the route along the requested waypoints
Request
Response
Request
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
Response
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}]}
Authentication is made via the X-RapidAPI-Key. You can find more information about api keys and authentication in the RapidAPI docs.
The route array contains multiple objects of waypoints
[{"t": "Berlin"},{"t": "Hamburg"}];
You should JSON.stringify the waypoints array before adding as query params.
{"t": "Berlin", // required"c": "DEU" // optional}
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)
​what3words​
Coordinate (latitude,longitude)
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".
If you need distances and durations of car routes between the waypoints
If you need distances and durations of foot route between the waypoints
Last updated 2 years ago