v1 (deprecated)

Result

A DistanceAPI result consists of 2 main parts. The "points" array describes additional information about the waypoints of the requested route and the "steps" array describes distance, duration and travel information for the ways between each waypoints.

{
  "points": [...],
  "steps": [...]
}

Points

The points array describes all waypoints along the requested route:

{
  "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

The steps array describes all routes between each waypoints:

"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
    }
  ]

Last updated