Rufzeichen → Route
Ordnen Sie ein Live-Rufzeichen (das über ADS-B gesendete Rufzeichen eines Flugs, z. B. BAW178) Abflug- und Zielflughafen zu. Findet SkyLink eine exakte Übereinstimmung für das Rufzeichen, enthält die Antwort departure_icao und arrival_icao mit confidence: "high". Fehlt das exakte Rufzeichen, greift die API auf eine Routenliste auf Ebene der Fluggesellschaft im Array routes zurück (gleiche Struktur wie bei den Flughafenrouten).
Voraussetzungen
x-api-key bei jeder Anfrage (Direktabonnement). Mehr erfahren →Anfrage
https://data.skylinkapi.com/v3.1/routes/callsign/{callsign}| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
callsign | string | Ja | Pfadparameter für das Rufzeichen des Flugs — Kennung der Fluggesellschaft plus numerisches Suffix, z. B. BAW178 |
Antwort
Beispiel für eine exakte Übereinstimmung:
{
"callsign": "BAW178",
"callsign_prefix": "BAW",
"airline_code": "BAW",
"departure_icao": "KJFK",
"arrival_icao": "EGLL",
"airports": ["KJFK", "EGLL"],
"confidence": "high",
"source": "vrs"
}Beispiel für einen Fallback (keine exakte Zeile für das Rufzeichen — es werden Routen auf Ebene der Fluggesellschaft zurückgegeben):
{
"callsign": "BAW999",
"callsign_prefix": "BAW",
"airline_code": "BAW",
"departure_icao": null,
"arrival_icao": null,
"airports": null,
"confidence": "low",
"source": "vrs",
"routes": [
{
"departure": "LHR",
"arrival": "JFK",
"airlines": ["British Airways"],
"km": 5555,
"duration_min": 430
}
]
}| Feld | Typ | Erforderlich | Null? | Beschreibung |
|---|---|---|---|---|
callsign | string | Ja | Nie | Echo des angefragten Rufzeichens |
callsign_prefix | string | Ja | Nie | Aus dem Rufzeichen extrahiertes ICAO-Präfix der Fluggesellschaft |
airline_code | string | Ja | Nie | Aufgelöster ICAO-Code der Fluggesellschaft |
departure_icao | string | Bei exakter Übereinstimmung | Ja (Fallback) | ICAO-Code des Abflughafens, sofern bekannt |
arrival_icao | string | Bei exakter Übereinstimmung | Ja (Fallback) | ICAO-Code des Zielflughafens, sofern bekannt |
airports | array | Bei exakter Übereinstimmung | Ja (Fallback) | Geordnete ICAO-Codes [departure, arrival] |
confidence | string | Ja | Nie | Qualität der Übereinstimmung — high bei exakten Treffern für das Rufzeichen |
source | string | Ja | Nie | Opaker Bezeichner der Routendatenquelle aus der API |
routes | array | Beim Fallback | Ja (exakte Übereinstimmung) | Routenliste auf Ebene der Fluggesellschaft, wenn keine exakte Zeile für das Rufzeichen existiert — gleiche Elementstruktur wie bei den Flughafenrouten |
Wichtig: Behandeln Sie confidence: "high" als zuverlässiges Städtepaar mit departure_icao/arrival_icao. Ist nur routes[] vorhanden, zeigen Sie die oberste Route als Vorschlag an und lassen Sie den Nutzer bestätigen — gehen Sie nicht davon aus, dass die erste Zeile dem aktiven Flug entspricht.
Client-Typen
"""Route detection response models for /routes/* endpoints."""from __future__ import annotationsfrom dataclasses import dataclass@dataclassclass RoutePair: departure: str arrival: str airlines: list[str] km: int duration_min: int@dataclassclass CallsignRouteResponse: """Exact callsign match from GET /routes/callsign/{callsign}.""" callsign: str callsign_prefix: str airline_code: str departure_icao: str arrival_icao: str airports: list[str] confidence: str source: str routes: list[RoutePair] | None = None@dataclassclass AirportRoutesResponse: code: str direction: str count: int routes: list[RoutePair]@dataclassclass RoutePairsResponse: count: int routes: list[RoutePair]@dataclassclass RouteGuess: """Shape returned by route_guess() helper.""" callsign: str departure: str | None arrival: str | None confidence: str source: strIntegration
Lösen Sie ein Live-ADS-B-Rufzeichen in eine Schätzung von Abflug- und Zielflughafen für Karten-Overlays und Flugkarten auf.
Das folgende Beispiel speichert Rufzeichen-Abfragen 24 Stunden im Cache, da sich zugewiesene Routen selten ändern. Jede Anfrage verwendet explizite Timeouts (10 s Verbindungsaufbau / 15 s Lesen). Die Hilfsfunktion normalisiert sowohl Antworten mit exakter Übereinstimmung als auch Fallback-Antworten in ein einheitliches RouteGuess-Objekt für den UI-Code.
import osimport timefrom dataclasses import dataclassimport requestsHEADERS = { "x-api-key": os.getenv("SKYLINK_API_KEY", "YOUR_API_KEY")}BASE = "https://data.skylinkapi.com/v3.1"CACHE: dict[str, tuple[dict, float]] = {}ROUTE_TTL = 86_400 # 24 h@dataclassclass RouteGuess: callsign: str departure: str | None arrival: str | None confidence: str source: strdef fetch_route_by_callsign(callsign: str) -> dict: callsign = callsign.upper().strip() key = f"route:callsign:{callsign}" cached = CACHE.get(key) if cached and time.time() < cached[1]: return cached[0] try: r = requests.get( f"{BASE}/routes/callsign/{callsign}", headers=HEADERS, timeout=(10, 15), ) except requests.Timeout as exc: raise RuntimeError(f"SkyLink timeout resolving route for {callsign}") from exc r.raise_for_status() data = r.json() CACHE[key] = (data, time.time() + ROUTE_TTL) return datadef route_guess(callsign: str) -> RouteGuess | None: data = fetch_route_by_callsign(callsign) dep = data.get("departure_icao") arr = data.get("arrival_icao") if not dep and not arr: routes = data.get("routes") or [] if not routes: return None top = routes[0] dep, arr = top.get("departure"), top.get("arrival") return RouteGuess( callsign=data.get("callsign", callsign), departure=dep, arrival=arr, confidence=data.get("confidence", "unknown"), source=data.get("source", "vrs"), )if __name__ == "__main__": import json from dataclasses import asdict guess = route_guess("BAW178") print(json.dumps(asdict(guess), indent=2) if guess else "Route not found")Hinweise zur Implementierung
Normalisierung der Codes. Wandeln Sie Rufzeichen vor der Abfrage in Großbuchstaben um (baw178 → BAW178). Entfernen Sie Leerzeichen aus ADS-B-Feeds.
Gemischte Flughafencodes. Routenzeilen können je nach Quellzeile IATA- oder ICAO-Codes verwenden — normalisieren Sie diese über Flughäfen, bevor Sie sie mit anderen Datensätzen verknüpfen.
Fehlerantworten
Validierungsfehler 422: Übersicht Routen.
Your SkyLink licence key, for keys bought direct from skylinkapi.com.
In: header
Path Parameters
Response Body
application/json
application/json
curl -X GET "https://data.skylinkapi.com/v3.1/routes/callsign/UAL100"{
"callsign": "RYR86UK",
"callsign_prefix": "RYR",
"airline_code": "RYR",
"airline_iata": "FR",
"departure_icao": "LHBP",
"departure_iata": "BUD",
"arrival_icao": "LIME",
"arrival_iata": "BGY",
"airports": [
"LHBP",
"LIME"
],
"confidence": "high",
"source": "vrs"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}Routenerkennung
Rufzeichen in Städtepaare auflösen, Routennetze von Flughäfen auflisten und Statistiken zu Routenpaaren mit Fluggesellschaften, Entfernung und Blockzeit abfragen.
Flughafenrouten
Alle bekannten Routen ab oder zu einem Flughafen auflisten — Fluggesellschaften, Entfernung und typische Blockzeit je Städtepaar.