Flugzeugleistung

Rufen Sie Reisegeschwindigkeit, Reichweite und Wirbelschleppenkategorie für einen ICAO-Typcode ab (z. B. B738, A320). Die Referenzdaten stammen aus ICAO Doc 8643 (Aircraft Type Designators) — dem internationalen Verzeichnis der Typcodes, Herstellernamen, Triebwerkskategorien und Wirbelschleppen-Klassen. Der Endpoint liefert statische Referenzdaten für eine Typbezeichnung — keine Werte für ein bestimmtes Kennzeichen. Der richtige Workflow ist, zuerst icao_type über Luftfahrzeugabfrage aufzulösen und dann diesen Endpoint aufzurufen.

Die Antwort enthält die Reisegeschwindigkeit in KTAS (Knoten wahre Fluggeschwindigkeit — Geschwindigkeit relativ zur ungestörten Luft), die Dienstgipfelhöhe (maximale Höhe, die das Luftfahrzeug im Horizontalflug halten kann), die maximale Reichweite, Triebwerk und Wirbelschleppenkategorie (ICAO-Klassifizierung L/M/H/J auf Basis der MTOW — bestimmt die Mindestabstände zwischen Luftfahrzeugen) sowie physische Abmessungen einschließlich MTOW (maximale Startmasse in metrischen Tonnen) und maximaler Passagierzahl. Nutzen Sie diese Daten für Reichweitenringe auf Karten, Treibstoff- und Anschlussschätzungen sowie Hinweise zur Wirbelschleppenstaffelung in Dispatch-Tools.

Anfrage

Antwort

{
  "icao_type": "B738",
  "name": "BOEING 737-800",
  "engine_type": "Jet",
  "engine_code": "L2J",
  "wake_category": "M",
  "cruise_speed_ktas": 460.0,
  "service_ceiling_ft": 35000.0,
  "max_range_nm": 2900.0,
  "wing_span_m": 34.4,
  "length_m": 39.5,
  "mtow_t": 78.2,
  "max_passengers": 189
}

Alle Antwortfelder sind nicht null, wenn der Typcode erkannt wird — es gibt keine optionalen Nullwerte, gegen die Sie sich absichern müssen.

Client-Typen

"""Aircraft performance models for GET /aircraft/performance/{icao_type}."""from __future__ import annotationsfrom dataclasses import dataclass@dataclassclass AircraftPerformance:    icao_type: str    name: str    engine_type: str    engine_code: str    wake_category: str    cruise_speed_ktas: float    service_ceiling_ft: float    max_range_nm: float    wing_span_m: float    length_m: float    mtow_t: float    max_passengers: int@dataclassclass PerformanceSummary:    """Compact model for range rings and briefing cards."""    icao_type: str    name: str    cruise_speed_ktas: float    max_range_nm: float    wake_category: str

Integration

Rufen Sie die Leistungsdaten für einen Typcode ab und erstellen Sie daraus einen Reichweitenring oder eine Briefing-Zusammenfassung.

Das folgende Beispiel cacht Leistungsprofile 7 Tage lang, da sich Daten auf Typebene selten ändern. Jeder Aufruf verwendet Verbindungs-/Lese-Timeouts (10 s / 15 s). Der Helper liefert ein kompaktes Modell mit normalisierten Geschwindigkeits- und Reichweiteneinheiten für Karten-Overlays.

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]] = {}PERF_TTL = 604_800  # 7 days@dataclassclass PerformanceSummary:    icao_type: str    name: str    cruise_speed_ktas: float    max_range_nm: float    wake_category: strdef fetch_performance(icao_type: str) -> dict:    """Fetch performance profile for an ICAO aircraft type code."""    code = icao_type.strip().upper()    key = f"perf:{code}"    cached = CACHE.get(key)    if cached and time.time() < cached[1]:        return cached[0]    try:        r = requests.get(            f"{BASE}/aircraft/performance/{code}",            headers=HEADERS,            timeout=(10, 15),        )    except requests.Timeout as exc:        raise RuntimeError(f"SkyLink timeout fetching performance {code}") from exc    r.raise_for_status()    payload = r.json()    CACHE[key] = (payload, time.time() + PERF_TTL)    return payloaddef performance_summary(icao_type: str) -> PerformanceSummary:    data = fetch_performance(icao_type)    return PerformanceSummary(        icao_type=data["icao_type"],        name=data["name"],        cruise_speed_ktas=float(data["cruise_speed_ktas"]),        max_range_nm=float(data["max_range_nm"]),        wake_category=data["wake_category"],    )if __name__ == "__main__":    import json    from dataclasses import asdict    summary = performance_summary("B738")    print(json.dumps(asdict(summary), indent=2))

Hinweise zur Implementierung

Quelle des Typcodes. Lösen Sie icao_type über Luftfahrzeugabfrage oder die ADS-B-Anreicherung auf, bevor Sie diesen Endpoint aufrufen — übergeben Sie die ICAO-Bezeichnung (B738), nicht den langen Marketingnamen.

Nicht kennzeichenspezifisch. MTOW und Reichweite sind Flottendurchschnittswerte für den Typ, keine Werte für die Konfiguration eines einzelnen Luftfahrzeugs.

Wirbelschleppenkategorie. Verwenden Sie wake_category nur für Staffelungshinweise in Dispatch-Tools — es handelt sich um Referenzdaten, nicht um eine aktuelle ATC-Anweisung.

Caching. Kann sicher nach icao_type für Tage oder Wochen gecacht werden. Invalidieren Sie den Cache nur, wenn SkyLink Aktualisierungen des Datensatzes ankündigt.

Vorhersage der Blockzeit. Für ML-basierte Vorhersagen der Blockzeit anhand des Typs siehe Flugzeit.

Fehlerantworten

Für plattformweite Fehler (Authentifizierung, Rate Limits, Serverfehler) siehe Fehlerbehandlung. Endpoint-spezifisches Verhalten:

422 — unbekannter oder ungültiger Typcode

{
  "detail": [
    {
      "type": "value_error",
      "loc": ["path", "icao_type"],
      "msg": "Unknown ICAO aircraft type"
    }
  ]
}

Tritt auf, wenn die Typbezeichnung nicht im Leistungsdatensatz enthalten ist. Validieren Sie Codes vor dem Aufruf über den Lookup und behandeln Sie 422 mit einer Fallback-Bezeichnung in Ihrer UI.

curl -X GET "https://data.skylinkapi.com/v3.1/aircraft/performance/B738"

{
  "icao_type": "B77W",
  "name": "BOEING 777-300ER",
  "engine_type": "Jet",
  "engine_code": "L2J",
  "wake_category": "H",
  "cruise_speed_ktas": 490,
  "service_ceiling_ft": 43000,
  "max_range_nm": 7370,
  "wing_span_m": 64.8,
  "length_m": 73.9,
  "mtow_t": 351.5,
  "max_passengers": 396
}

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

Siehe auch: Luftfahrzeugabfrage · ADS-B · Entfernung & Peilung