# Funknavigationsanlagen (Navaids) Funknavigationsanlagen (VOR, NDB, ILS, DME, TACAN) nach Kennung, Flughafen, Typ, Land oder Begrenzungsrahmen suchen – mit kartenfertigen Koordinaten. Durchsuchen Sie die Funknavigationsinfrastruktur — **[VOR](https://en.wikipedia.org/wiki/VHF_omnidirectional_range)** (VHF Omnidirectional Range, die wichtigste Navigationsanlage auf der Strecke), **[NDB](https://en.wikipedia.org/wiki/Non-directional_beacon)** (Non-Directional Beacon, ungerichtetes Funkfeuer), **[ILS](https://en.wikipedia.org/wiki/Instrument_landing_system)** (Instrument Landing System, Instrumentenlandesystem), **[DME](https://en.wikipedia.org/wiki/Distance_measuring_equipment)** (Distance Measuring Equipment, Entfernungsmessgerät), **[TACAN](https://en.wikipedia.org/wiki/Tactical_air_navigation_system)** (Tactical Air Navigation) sowie kombinierte Anlagen wie **[VORTAC](https://en.wikipedia.org/wiki/VORTAC)** (am selben Standort befindliche [VOR](https://en.wikipedia.org/wiki/VHF_omnidirectional_range)- und [TACAN](https://en.wikipedia.org/wiki/Tactical_air_navigation_system)-Anlage). Verwenden Sie diesen Endpoint für Routen-Overlays, Kontextpanels zum Anflug oder Kartenebenen, wenn Sie mehr Navaids benötigen als die Teilmenge, die unter [Flughäfen](/docs/v31/airports) eingebettet ist. Mindestens ein Filter ist erforderlich (`ident`, `airport`, `type`, `country` oder `bbox`). Ein ungefilterter globaler Export ist gesperrt. ## Anfrage [#request] | Parameter | Typ | Erforderlich | Standard | Beschreibung | | --------- | ------- | ---------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------- | | `ident` | string | Mindestens ein Filter erforderlich | - | Kennung der Navigationsanlage, z. B. `JFK` | | `airport` | string | Mindestens ein Filter erforderlich | - | ICAO-Flughafencode für zugehörige Navaids | | `type` | string | Mindestens ein Filter erforderlich | - | Typ der Navigationsanlage, z. B. `VOR`, `NDB`, `VORTAC`, `ILS`, `DME` | | `country` | string | Mindestens ein Filter erforderlich | - | Ländercode nach ISO 3166-1 alpha-2 | | `bbox` | string | Mindestens ein Filter erforderlich | - | Begrenzungsrahmen: `lat1,lon1,lat2,lon2` — zuerst die südwestliche Ecke, dann die nordöstliche. Beispiel: `40,-74,41,-73` | | `limit` | integer | Nein | `100` | Maximale Anzahl zurückgegebener Datensätze (max. `500`) | Kombinieren Sie Filter (z. B. `country=US&type=[VOR](https://en.wikipedia.org/wiki/VHF_omnidirectional_range)`), um große Ergebnismengen einzugrenzen. ## Antwort [#response] ```json { "navaids": [ { "id": 89475, "ident": "JFK", "name": "Kennedy", "type": "VOR-DME", "frequency_khz": 115900.0, "latitude_deg": 40.63290023803711, "longitude_deg": -73.77140045166016, "elevation_ft": 11.0, "iso_country": "US", "dme_frequency_khz": 115900.0, "dme_channel": "106X", "slaved_variation_deg": -12.001, "magnetic_variation_deg": -13.182, "usageType": "BOTH", "power": "HIGH", "associated_airport": "KJFK" } ], "total": 1, "filters_applied": { "ident": "JFK" } } ``` ### Felder der obersten Ebene [#top-level-fields] | Feld | Typ | Erforderlich | Beschreibung | | ----------------- | ------- | ------------ | -------------------------------------------- | | `navaids` | array | **Ja** | Gefundene Navaid-Datensätze (kann `[]` sein) | | `total` | integer | **Ja** | Anzahl der zurückgegebenen Datensätze | | `filters_applied` | object | **Ja** | Wiedergabe der akzeptierten Filter | #### Navaid-Eintrag (`navaids[]`) [#navaid-item-navaids] | Feld | Typ | Erforderlich | Null? | Beschreibung | | ------------------------ | -------------- | ------------ | ------ | --------------------------------------------------------------------------------------------------------------- | | `id` | integer | **Ja** | Nie | Numerische Kennung des Datensatzes | | `ident` | string | **Ja** | Nie | Kennung der Navigationsanlage | | `name` | string | **Ja** | Nie | Name der Navigationsanlage | | `type` | string | **Ja** | Nie | Anlagentyp (`VOR-DME`, `NDB` usw.) | | `frequency_khz` | number \| null | Nein | **Ja** | Primärfrequenz in kHz | | `latitude_deg` | number | **Ja** | Nie | Breitengrad (WGS-84) | | `longitude_deg` | number | **Ja** | Nie | Längengrad (WGS-84) | | `elevation_ft` | number \| null | Nein | **Ja** | Höhe in Fuß MSL | | `iso_country` | string \| null | Nein | **Ja** | Ländercode | | `dme_frequency_khz` | number \| null | Nein | **Ja** | DME-Frequenz, sofern zutreffend | | `dme_channel` | string \| null | Nein | **Ja** | DME-Kanal, z. B. `106X` | | `slaved_variation_deg` | number \| null | Nein | **Ja** | Eingestellte (slaved) magnetische Missweisung | | `magnetic_variation_deg` | number \| null | Nein | **Ja** | Lokale magnetische Missweisung (Winkel zwischen geografischem und magnetischem Norden an der Navigationsanlage) | | `usageType` | string \| null | Nein | **Ja** | Nutzungsklasse (z. B. `BOTH`) | | `power` | string \| null | Nein | **Ja** | Leistungsklasse des Senders | | `associated_airport` | string \| null | Nein | **Ja** | ICAO-Flughafencode, falls einem Flughafen zugeordnet | `dme_frequency_khz`, `dme_channel`, `slaved_variation_deg` und `magnetic_variation_deg` sind je nach Anlagentyp häufig `null`. `associated_airport` kann bei Navaids auf der Strecke (En-Route) `null` sein. Behandeln Sie den Navaid-`type` als offenen String — unbekannte Werte dürfen keinen harten Fehler auslösen. ## Client-Typen [#client-types] ## Integration [#integration] Navaids rund um einen Flughafen abrufen und kartenfertige Objekte für Routen-Overlays zurückgeben. Das folgende Beispiel speichert Abfrageergebnisse 6 Stunden im Cache und verwendet explizite Timeouts, damit das Rendern der Karte bei einer langsamen Antwort nicht hängen bleibt. ### Hinweise zur Implementierung [#implementation-notes] **Früh filtern.** Kombinieren Sie die Filter `country`, `type` oder `airport`, um die Antwortgröße und die Unübersichtlichkeit der Karte zu reduzieren. **BBox-Format.** Verwenden Sie `lat1,lon1,lat2,lon2` (Südwest → Nordost), passend zu [Höhenwinde](/docs/v31/winds-aloft), [PIREPs](/docs/v31/pireps) und [AIRMET/SIGMET](/docs/v31/airsigmet) — nicht `minLon,minLat,maxLon,maxLat`. **Navaids am Flughafen.** [Flughäfen](/docs/v31/airports) bettet pro Platz eine Teilmenge ein. Verwenden Sie diesen Endpoint für bbox-Abfragen, Typ-/Länderfilter oder Overlays, die über die Abfrage eines einzelnen Flughafens hinausgehen. ## Fehlerantworten [#error-responses] Gemeinsame Fehler: [Fehlerbehandlung](/docs/errors). Endpoint-spezifisch: ### 400 - keine Filter angegeben [#400---no-filters-provided] ```json { "detail": "At least one filter is required: ident, airport, type, country, or bbox. Returning the full navaid dataset unfiltered is not supported." } ``` ### 400 - ungültige bbox [#400---invalid-bbox] ```json { "detail": "Invalid bbox: could not convert string to float: 'bad'" } ``` ### Integrationsleitfäden [#integration-guides] | Leitfaden | Inhalt | | --------------------------------------------------------------------- | ----------------------------------------------------------- | | [Flughäfen](/docs/v31/airports-integration) | Abfrage, Frequenzen, Vergleich von Start- und Landebahnen | | [Flughafensuche](/docs/v31/airport-search-integration) | Autovervollständigung und nächstgelegener Flughafen per GPS | | [Navaids](/docs/v31/navaids-integration) | Karten-Overlay und ILS-Filter | | [Fehlerbehandlung](/docs/v31/airport-data-integration-errors) | 404, leere Suche, Validierung | | [Caching & Monitoring](/docs/v31/airport-data-integration-production) | TTLs und Protokollierung des Kontingents | *** Siehe auch: [Flughäfen](/docs/v31/airports) · [Flughafensuche](/docs/v31/airport-search) · [Flugplatzkarten](/docs/v31/charts)