Entfernung & Kurs

Berechnen Sie die Großkreisentfernung (kürzester Weg zwischen zwei Punkten auf einer Kugel — keine gerade Linie auf einer flachen Karte), den anfänglichen Kurs (Kompassrichtung vom Start- zum Zielpunkt in Grad rechtweisend), die Himmelsrichtung nach der achtteiligen Windrose und den geografischen Mittelpunkt zwischen zwei Punkten. Jede Seite kann ein Flughafencode oder ein Paar roher WGS-84-Koordinaten sein — auch gemischt.

Geeignet für Routenvorschaukarten, Treibstoffrechner und Reichweitenring-Overlays, ohne dass Sie eine eigene Haversine-Implementierung pflegen müssen.

Anfrage

Geben Sie jede Seite entweder als Code oder als Koordinatenpaar an:

Antwort

{
  "from": "KJFK",
  "to": "EGLL",
  "distance_nm": 2991.61,
  "distance_km": 5539.91,
  "distance_mi": 3442.19,
  "bearing_deg": 51.35,
  "cardinal": "NE",
  "midpoint_lat": 52.216,
  "midpoint_lon": -41.306
}

Alle drei Entfernungseinheiten werden immer zurückgegeben, unabhängig vom Parameter unit. Verwenden Sie unit nur als Anzeigepräferenz.

Client-Typen

"""Distance endpoint response models for /distance."""from __future__ import annotationsfrom dataclasses import dataclass@dataclassclass DistanceRequest:    from_icao: str | None = None    to_icao: str | None = None    from_lat: float | None = None    from_lon: float | None = None    to_lat: float | None = None    to_lon: float | None = None    unit: str | None = None@dataclassclass DistanceResponse:    from_: str    to: str    distance_nm: float    distance_km: float    distance_mi: float    bearing_deg: float    cardinal: str    midpoint_lat: float    midpoint_lon: float

Integration

Berechnen Sie die Routengeometrie für eine Vorschaukarte mit expliziter Timeout-Behandlung.

import osimport requestsBASE = "https://data.skylinkapi.com/v3.1"HEADERS = {    "x-api-key": os.getenv("SKYLINK_API_KEY", "YOUR_API_KEY")}def fetch_distance(from_icao: str, to_icao: str) -> dict:    """Fetch great-circle distance and initial bearing between two airports."""    r = requests.get(        f"{BASE}/distance",        headers=HEADERS,        params={"from_icao": from_icao, "to_icao": to_icao},        timeout=(10, 15),    )    r.raise_for_status()    return r.json()if __name__ == "__main__":    import json    data = fetch_distance("KJFK", "KLAX")    print(json.dumps(data, indent=2, default=str))

Hinweise zur Implementierung

Eingabevalidierung. Prüfen Sie die Grenzen von Breiten- und Längengrad clientseitig, um vermeidbare 422-Antworten zu verhindern.

Himmelsrichtung. cardinal gibt nur den Anfangskurs wieder — weder Wind noch die Streckenführung über veröffentlichte Luftstraßen.

Routenauflösung. Für Paare aus Rufzeichen → Start-/Zielflughafen verwenden Sie Routen. Für die per ML vorhergesagte Blockzeit siehe Flugzeit.

Fehlerantworten

Gemeinsame Plattformfehler finden Sie unter Fehlerbehandlung. Endpoint-spezifisch:

422 - ungültige Punktdefinition

{
  "detail": [
    {
      "type": "value_error",
      "loc": ["query", "from_lat"],
      "msg": "from_lat must be between -90 and 90"
    }
  ]
}

curl -X GET "https://data.skylinkapi.com/v3.1/distance"

{
  "from_point": {
    "latitude": 40.639751,
    "longitude": -73.778925,
    "icao_code": "KJFK",
    "iata_code": "JFK",
    "name": "John F Kennedy International Airport"
  },
  "to_point": {
    "latitude": 51.4706,
    "longitude": -0.461941,
    "icao_code": "EGLL",
    "iata_code": "LHR",
    "name": "London Heathrow Airport"
  },
  "distance": 2991.01,
  "unit": "nm",
  "bearing": 51.35,
  "bearing_cardinal": "NE",
  "midpoint": {
    "latitude": 52.216674,
    "longitude": -41.302671
  }
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Siehe auch: Flughäfen · Routen · Flug-Briefing