# Flugplatzkarten
PDFs von Flugplatzkarten für 91 Länder – Quellen sowie die Kategorien GEN, GND, SID, STAR und APP mit automatischer Quellenauswahl.
Greifen Sie auf kategorisierte PDF-Links zu Flugplatzkarten (GEN, GND, SID, STAR, APP) für Flughäfen in 91 Ländern zu. Die passende nationale Kartenquelle wird automatisch anhand des ICAO-Präfixes ausgewählt – in den meisten Integrationen ist keine Überschreibung per `source` nötig. Die Antwortzeiten variieren je nach Land: Manche Quellen antworten in unter einer Sekunde, andere können 5–15 Sekunden benötigen.
| Endpoint | Einsatzzweck |
| ------------------------------------ | -------------------------------------------------------------------------------------- |
| `GET /charts/sources` | Unterstützte Kartenregionen und ICAO-Präfixe ermitteln — [siehe unten](#chart-sources) |
| `GET /charts/{icao_code}` | Vollständiger kategorisierter Kartenindex — [siehe unten](#fetch-charts) |
| `GET /charts/{icao_code}/{category}` | Einzelne Kategorie — [nach Kategorie](#by-category) |
**Wahl des Endpoints.** Rufen Sie `GET /charts/sources` einmal beim Start auf, um die Abdeckung zu prüfen. Verwenden Sie [Karten abrufen](#fetch-charts) für einen vollständigen Briefing-Index. Verwenden Sie [Karten nach Kategorie](#by-category), wenn Sie nur einen Kartentyp benötigen (z. B. `APP` für Anflugkarten-Panels).
Eine Kategorie ohne veröffentlichte Karten liefert ein leeres Array statt 404; ein völlig unbekannter Flughafen liefert `404`.
### Kartenkategorien [#chart-categories]
| Code | Inhalt |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `GEN` | Flughafenplan und allgemeine Informationen |
| `GND` | Karten für Bodenbewegungen und Rollwege |
| `SID` | [Standard-Instrumentenabflugverfahren](https://en.wikipedia.org/wiki/Standard_instrument_departure) |
| `STAR` | [Standard-Instrumentenanflugrouten](https://en.wikipedia.org/wiki/Standard_terminal_arrival_route) |
| `APP` | Anflugverfahren - [ILS](https://en.wikipedia.org/wiki/Instrument_landing_system), [RNAV](https://en.wikipedia.org/wiki/Area_navigation), [VOR](https://en.wikipedia.org/wiki/VHF_omnidirectional_range) usw. |
## Kartenquellen [#chart-sources]
Liefert alle unterstützten Kartendatenquellen und die ICAO-Präfixe, die jede davon abdeckt. Rufen Sie den Endpoint einmal beim Start auf, um eine Quellenauswahl zu befüllen oder die Abdeckung vor dem Abruf von Karten zu prüfen.
### Anfrage [#request]
Keine Query-Parameter.
### Antwort [#response]
```json
{
"sources": [
{
"source_id": "uk",
"name": "United Kingdom",
"icao_prefixes": ["EG"]
}
],
"total_count": 91
}
```
| Feld | Typ | Erforderlich | Beschreibung |
| ------------- | ------- | ------------ | ------------------------------------ |
| `sources` | array | **Ja** | Unterstützte nationale Kartenquellen |
| `total_count` | integer | **Ja** | Anzahl der zurückgegebenen Quellen |
#### Quelleneintrag (`sources[]`) [#source-item-sources]
| Feld | Typ | Erforderlich | Beschreibung |
| --------------- | ------ | ------------ | --------------------------------------------------------------------------------------------- |
| `source_id` | string | **Ja** | Quellen-Slug, der an die optionale Überschreibung per Query-Parameter `source` übergeben wird |
| `name` | string | **Ja** | Lesbare Bezeichnung der Quelle |
| `icao_prefixes` | array | **Ja** | ICAO-Ortskennungspräfixe, die diese Quelle abdeckt |
### Abdeckung [#coverage]
Karten sind für Flughäfen in **91 Ländern und Gebieten** verfügbar. Die passende Kartenquelle wird automatisch anhand des ICAO-Präfixes des Flughafens ausgewählt.
| Region | Länder / Gebiete |
| ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Afrika** | Algerien, Kap Verde, Dschibuti, Marokko, Somalia, Südafrika, Südsudan |
| **Afrika (West & Zentral - [ASECNA](https://www.asecna.aero/))** | Benin, Burkina Faso, Kamerun, Zentralafrikanische Republik, Tschad, Komoren, Kongo, Côte d'Ivoire, Gabun, Guinea, Guinea-Bissau, Madagaskar, Mali, Mauretanien, Niger, Senegal, Togo |
| **Amerika - Nord** | Kanada, Vereinigte Staaten |
| **Amerika - Mittelamerika** | Belize, Costa Rica, El Salvador, Guatemala, Honduras, Nicaragua, Panama |
| **Amerika - Karibik** | Aruba, Kaimaninseln, Kuba, Dominikanische Republik, Haiti |
| **Amerika - Süd** | Argentinien, Brasilien, Chile, Kolumbien, Uruguay, Venezuela |
| **Asien - Ost** | China, Hongkong, Japan, Mongolei, Südkorea, Taiwan |
| **Asien - Süd** | Bangladesch, Bhutan, Indien, Malediven, Nepal, Pakistan, Sri Lanka |
| **Asien - Südost** | Brunei, Malaysia, Myanmar, Singapur, Thailand |
| **Asien - Zentral** | Kasachstan, Kirgisistan, Tadschikistan, Turkmenistan, Usbekistan |
| **Naher Osten** | Bahrain, Israel, Kuwait, Oman, Katar, Saudi-Arabien, VAE |
| **Europa - West** | Österreich, Belgien, Frankreich, Deutschland, Island, Irland, Luxemburg, Niederlande, Norwegen, Portugal, Spanien, Schweden, Vereinigtes Königreich |
| **Europa - Nord** | Dänemark, Estland, Finnland, Lettland, Litauen |
| **Europa - Ost** | Belarus, Tschechien, Ungarn, Polen, Rumänien, Russland, Slowakei, Ukraine |
| **Europa - Süd** | Zypern, Georgien, Griechenland, Malta, Slowenien |
| **Europa - Balkan** | Albanien, Bosnien und Herzegowina, Kosovo, Nordmazedonien, Serbien |
| **Ozeanien** | Australien, Neuseeland |
Für die Zuordnung von ICAO-Präfixen zu Ländern verwenden Sie das Feld `icao_prefixes` des jeweiligen Quelleneintrags.
## Karten für einen Flugplatz abrufen [#fetch-charts-for-an-aerodrome]
Ruft alle kategorisierten PDF-Links zu Karten für einen ICAO-Code ab. Dreistellige US-Codes erhalten automatisch das Präfix `K` (z. B. `JFK` → `KJFK`).
### Anfrage [#request-1]
| Parameter | Typ | Erforderlich | Standard | Beschreibung |
| ----------- | ------ | ------------ | -------- | ----------------------------------------------------------------------------- |
| `icao_code` | string | Ja | - | ICAO-Flughafencode (3–4 Zeichen) |
| `source` | string | Nein | auto | Automatisch erkannte Kartenquelle überschreiben (z. B. `faa`, `france`, `uk`) |
Planen Sie für Länder mit langsamerem Karten-Hosting längere Lese-Timeouts (30–60 s) ein.
### Antwort [#response-1]
```json
{
"icao_code": "KJFK",
"source": "faa",
"charts": {
"GND": [
{
"name": "KJFK - Airport Diagram",
"url": "https://...",
"category": "GND"
}
],
"SID": [
{
"name": "KENNEDY TWO",
"url": "https://...",
"category": "SID"
}
]
},
"total_count": 42,
"fetched_at": "2026-02-11T12:00:00Z"
}
```
| Feld | Typ | Erforderlich | Null? | Beschreibung |
| ------------- | ------- | ------------ | ------ | ---------------------------------------------------------- |
| `icao_code` | string | **Ja** | Nie | Aufgelöster ICAO-Code |
| `source` | string | **Ja** | Nie | Für diesen Abruf verwendeter Kartenanbieter |
| `charts` | object | Nein | **Ja** | Karten nach Kategorie (`GEN`, `GND`, `SID`, `STAR`, `APP`) |
| `total_count` | integer | **Ja** | Nie | Gesamtzahl der Karten über alle Kategorien |
| `fetched_at` | string | Nein | **Ja** | ISO-8601-Zeitstempel des Kartenabrufs |
### Karteneintrag (`charts[category][]`) [#chart-item-chartscategory]
| Feld | Typ | Erforderlich | Beschreibung |
| ---------- | ------ | ------------ | ------------------------------------------------------------------------------------------------ |
| `name` | string | **Ja** | Kartentitel, wie von der Quelle veröffentlicht |
| `url` | string | **Ja** | Direkte URL zum Karten-PDF |
| `category` | string | **Ja** | Einer der Werte `GEN`, `GND`, `SID`, `STAR`, `APP` - siehe [Kartenkategorien](#chart-categories) |
## Karten nach Kategorie [#charts-by-category]
Ruft für einen Flughafen nur die Karten einer einzelnen Kategorie (`GEN`, `GND`, `SID`, `STAR` oder `APP`) ab. Die Hülle der Antwort entspricht dem oben beschriebenen Endpoint für alle Karten, `charts` enthält jedoch nur den Schlüssel der angefragten Kategorie.
### Anfrage [#request-2]
| Parameter | Typ | Erforderlich | Standard | Beschreibung |
| ----------- | ------ | ------------ | -------- | ------------------------------------------------------- |
| `icao_code` | string | Ja | - | ICAO-Flughafencode (3–4 Zeichen) |
| `category` | string | Ja | - | Kartenkategorie: `GEN`, `GND`, `SID`, `STAR` oder `APP` |
| `source` | string | Nein | auto | Automatisch erkannte Kartenquelle überschreiben |
### Antwort [#response-2]
Gleiche Struktur wie die Antwort für alle Karten, wobei `charts` auf die angefragte Kategorie beschränkt ist. Ein leeres Kategorie-Array ist eine normale Erfolgsantwort. Karteneinträge verwenden dieselbe Feldtabelle wie unter [Karteneintrag](#chart-item).
**Wichtig:** Fehlende Kategorie → leeres Array in einer `200`-Antwort. Unbekannter Flughafen → `404`. Planen Sie für Länder mit langsamerem Karten-Hosting längere Lese-Timeouts (30–60 s) ein.
## Client-Typen [#client-types]
## Integration [#integration]
Anflugkarten für ein Briefing-Panel abrufen und in eine flache Liste von Download-Links umwandeln.
Das folgende Beispiel speichert Kartenantworten 24 Stunden im Cache, da sich Kartenveröffentlichungen selten ändern. Die Lese-Timeouts sind auf 45 s verlängert, weil einige Länder langsam antworten. Die Hilfsfunktion liefert eine flache `ChartLink`-Liste und behandelt `404` als „keine Karten verfügbar“ statt als harten Fehler.
### Hinweise zur Implementierung [#implementation-notes]
**US-Code-Präfix.** Übergeben Sie `JFK` oder `KJFK` – beides wird bei US-Flughäfen zu `KJFK` aufgelöst.
**Filtern nach Kategorie.** Verwenden Sie [Karten nach Kategorie](#by-category) mit `APP`, wenn Sie nur Anflugkarten benötigen; so vermeiden Sie das Herunterladen von SID/STAR-Metadaten, die Sie nicht anzeigen.
**PDF-Auslieferung.** Die `url`-Werte der Karten verweisen auf gehostete PDF-Dateien. Öffnen Sie sie in einem neuen Tab oder leiten Sie sie über Ihren Server weiter (Proxy), wenn Sie ein einheitliches CORS-Verhalten benötigen.
**Leer vs. 404.** Fehlende Kategorie → leeres Array in einer `200`-Antwort. Unbekannter Flughafen → `404`.
## Fehlerantworten [#error-responses]
Plattformweite Fehler: [Fehlerbehandlung](/docs/errors). Endpoint-spezifisch:
### 422 - ungültige Kategorie oder ICAO-Länge [#422---invalid-category-or-icao-length]
```json
{
"detail": [
{
"type": "enum",
"loc": ["path", "category"],
"msg": "Input should be 'GEN', 'GND', 'SID', 'STAR' or 'APP'"
}
]
}
```
### 404 - keine Karten für den Flughafen [#404---no-charts-for-airport]
Wird zurückgegeben, wenn Skylink in keiner konfigurierten Quelle Karten für den ICAO-Code finden kann.
***
Siehe auch: [Flughäfen](/docs/v31/airports) · [Flug-Briefing](/docs/v31/flight-briefing) · [Briefing-PDF](/docs/v31/briefing-pdf)