v1 (deprecated)
Learn more about the request parameter
Last updated
Learn more about the request parameter
Last updated
GET
https://distanceto.p.mashape.com/get
Get distance, duration and travel information about the route along the requested waypoints
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
{
"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)
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