# Flugzeugleistung
Leistungsprofile für Flugzeugtypen (ICAO Doc 8643) – Reisegeschwindigkeit, Gipfelhöhe, Reichweite, Wirbelschleppenkategorie, Abmessungen, MTOW, Sitzplätze.
Rufen Sie Reisegeschwindigkeit, Reichweite und Wirbelschleppenkategorie für einen ICAO-Typcode ab (z. B. `B738`, `A320`). Die Referenzdaten stammen aus **[ICAO Doc 8643](https://www.icao.int/operational-safety/doc-8643-aircraft-type-designators)** (*Aircraft Type Designators*) — dem internationalen Verzeichnis der Typcodes, Herstellernamen, Triebwerkskategorien und [Wirbelschleppen](https://en.wikipedia.org/wiki/Wake_turbulence)-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](/docs/v31/aircraft-lookup) aufzulösen und dann diesen Endpoint aufzurufen.
Die Antwort enthält die **Reisegeschwindigkeit** in **[KTAS](https://en.wikipedia.org/wiki/True_airspeed)** (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](https://skybrary.aero/articles/icao-wake-turbulence-category)** (ICAO-Klassifizierung L/M/H/J auf Basis der [MTOW](https://en.wikipedia.org/wiki/Maximum_takeoff_weight) — bestimmt die Mindestabstände zwischen Luftfahrzeugen) sowie physische Abmessungen einschließlich **[MTOW](https://en.wikipedia.org/wiki/Maximum_takeoff_weight)** (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 [#request]
| Parameter | Typ | Erforderlich | Standard | Beschreibung |
| ----------- | ------ | ------------ | -------- | ------------------------------------------------- |
| `icao_type` | string | Ja (Pfad) | - | ICAO-Typbezeichnung, z. B. `B738`, `A359`, `E190` |
## Antwort [#response]
```json
{
"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
}
```
| Feld | Typ | Erforderlich | Null? | Beschreibung |
| -------------------- | ------- | ------------ | ----- | ------------------------------------------------------------------ |
| `icao_type` | string | **Ja** | Nie | Aus dem Pfad übernommene ICAO-Typbezeichnung |
| `name` | string | **Ja** | Nie | Modellbezeichnung des Luftfahrzeugs |
| `engine_type` | string | **Ja** | Nie | Triebwerkskategorie, z. B. `Jet`, `Turboprop` |
| `engine_code` | string | **Ja** | Nie | ICAO-Code für Triebwerksanzahl/-typ, z. B. `L2J` |
| `wake_category` | string | **Ja** | Nie | ICAO-Wirbelschleppenkategorie (`L`, `M`, `H`, `J`) |
| `cruise_speed_ktas` | number | **Ja** | Nie | Typische Reisegeschwindigkeit in Knoten wahrer Fluggeschwindigkeit |
| `service_ceiling_ft` | number | **Ja** | Nie | Dienstgipfelhöhe in Fuß |
| `max_range_nm` | number | **Ja** | Nie | Maximale Reichweite in nautischen Meilen |
| `wing_span_m` | number | **Ja** | Nie | Spannweite in Metern |
| `length_m` | number | **Ja** | Nie | Rumpflänge in Metern |
| `mtow_t` | number | **Ja** | Nie | Maximale Startmasse in metrischen Tonnen |
| `max_passengers` | integer | **Ja** | Nie | Typische maximale Passagierkapazität |
Alle Antwortfelder sind nicht null, wenn der Typcode erkannt wird — es gibt keine optionalen Nullwerte, gegen die Sie sich absichern müssen.
## Client-Typen [#client-types]
## Integration [#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.
### Hinweise zur Implementierung [#implementation-notes]
**Quelle des Typcodes.** Lösen Sie `icao_type` über [Luftfahrzeugabfrage](/docs/v31/aircraft-lookup) oder die [ADS-B](https://www.faa.gov/air_traffic/technology/adsb)-Anreicherung auf, bevor Sie diesen Endpoint aufrufen — übergeben Sie die ICAO-Bezeichnung (`B738`), nicht den langen Marketingnamen.
**Nicht kennzeichenspezifisch.** [MTOW](https://en.wikipedia.org/wiki/Maximum_takeoff_weight) 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](/docs/v31/flight-time).
## Fehlerantworten [#error-responses]
Für plattformweite Fehler (Authentifizierung, Rate Limits, Serverfehler) siehe [Fehlerbehandlung](/docs/errors). Endpoint-spezifisches Verhalten:
### 422 — unbekannter oder ungültiger Typcode [#422--unknown-or-invalid-type-code]
```json
{
"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.
***
Siehe auch: [Luftfahrzeugabfrage](/docs/v31/aircraft-lookup) · [ADS-B](/docs/v31/adsb) · [Entfernung & Peilung](/docs/v31/distance)