Anfrageparameter
Mit diesen Abfrageparametern fragen Sie einen bestimmten Flughafen ab, suchen Flughäfen nach Standort oder exportieren das Verzeichnis.
| Parameter | Pflicht | Standard | Beschreibung |
|---|
apikey |
Ja | Keiner | Ihr zugewiesener API-Schlüssel. Kostenlosen API-Testschlüssel anfordern. |
|---|
iata |
Bedingt | Keiner | Dreistelliger IATA-Flughafencode, z. B. LHR. |
|---|
icao |
Bedingt | Keiner | Vierstelliger ICAO-Flughafencode, z. B. EGLL. |
|---|
city_code |
Bedingt | Keiner | Dreistelliger IATA-Stadtcode, z. B. LON, um die zu einer Stadt gehörenden Flughäfen zu finden. |
|---|
country_code |
Bedingt | Keiner | Zweistelliger ISO-Ländercode, z. B. GB, um die Flughäfen eines Landes zu finden. |
|---|
name |
Bedingt | Keiner | Flughafenname oder Teil des Namens, z. B. Heathrow. |
|---|
dump |
Bedingt | 0 | Mit 1 exportieren Sie die Datenbank. Hat Vorrang vor den übrigen Abfrageparametern; Filter zur Abdeckung gelten weiterhin. |
|---|
show_disabled |
Nein | 0 | Mit 1 werden auch inaktive oder deaktivierte Datensätze geliefert. Standardmäßig erhalten Sie nur aktive Datensätze. |
|---|
response_type |
Nein | JSON | Antwortformat: JSON, XML oder CSV. Bei CSV startet ein Dateidownload. |
|---|
major_only |
Nein | 0 | Mit 1 erhalten Sie nur Flughäfen mit kommerziellem Flugbetrieb. |
|---|
Geben Sie mindestens einen der Parameter iata, icao, city_code, country_code, name oder dump=1 an. dump=1 hat Vorrang vor den übrigen Abfrageparametern.
Alle Anfrageparameter ansehen →
Typische Aufgaben bei der Umsetzung
Verzeichnis der ICAO-Flughafencodes herunterladen
Exportieren Sie das Verzeichnis der aktiven Flughäfen als CSV und bauen Sie aus Datensätzen mit gefülltem Feld icao einen lokalen Index. Behalten Sie iata, soweit vorhanden, für den Abgleich mit Buchungsdaten. Ergänzen Sie major_only=1, wenn Ihr Produkt nur Flughäfen mit kommerziellem Flugbetrieb braucht.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'dump=1' \
--data-urlencode 'response_type=CSV' \
--output airports.csv
ICAO-Code über einen IATA-Code finden
Übergeben Sie LHR in iata und lesen Sie icao aus der Antwort. So ordnet Ihre Anwendung die Flughafenkennung eines Buchungslieferanten einer Quelle mit ICAO-Codes zu, mit beiden Codes aus demselben Flughafendatensatz.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'iata=LHR'
ICAO-Code über den Flughafennamen finden
Suchen Sie mit name und prüfen Sie das gelieferte Feld icao. Teilnamen können mehrere Treffer liefern. Vergleichen Sie daher Flughafenname, Land und weitere Kennungen, bevor Sie einen Datensatz auswählen.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'name=Heathrow'
Häufig gestellte Fragen
Worin unterscheiden sich ICAO- und IATA-Flughafencodes?
ICAO-Flughafencodes bestehen aus vier Buchstaben, z. B. EGLL für London Heathrow. IATA-Flughafencodes haben drei Buchstaben, z. B. LHR. Verwenden Sie icao oder iata je nach Codesystem Ihrer Quelle; die Antwort enthält beide Felder, soweit vorhanden.
Kann ich ICAO-Flughafencodes IATA-Codes zuordnen?
Ja. Fragen Sie den Flughafen mit icao ab und lesen Sie das gelieferte Feld iata. Umgekehrt fragen Sie einen IATA-Code mit iata ab und lesen icao. Prüfen Sie vor der Zuordnung, ob das Zielfeld gefüllt ist; nicht jeder Datensatz hat beide Kennungen.
Kann ich einen Stadtcode als ICAO-Flughafencode verwenden?
Nein. Ein Stadtcode wie LON ist eine eigene Zielkennung. Nutzen Sie city_code, um die zu einer Stadt gehörenden Flughäfen zu finden, und verwenden Sie dann den Wert icao des jeweiligen Flughafens. Eine Stadt kann von mehreren Flughäfen bedient werden.
Welche Flughäfen sind standardmäßig enthalten?
Die Standardanfrage liefert aktive Datensätze und beschränkt die Ergebnisse nicht auf Flughäfen mit kommerziellem Flugbetrieb. Diese Einschränkung erreichen Sie mit major_only=1. Der breitere Datensatz kann weitere Standorttypen enthalten; prüfen Sie icao, bevor Sie Datensätze in Ihren ICAO-Abgleich aufnehmen, und unterscheiden Sie Einrichtungen mit major_airport und sub_type aus der vollständigen Antwort.
Kann ich inaktive Flughäfen für historische Datensätze einbeziehen?
Setzen Sie show_disabled=1, um inaktive oder deaktivierte Datensätze einzubeziehen, und prüfen Sie active in der Antwort. Behalten Sie diesen Status bei der Auflösung historischer Daten bei, damit eine alte Flughafenreferenz nicht automatisch als aktives Buchungsziel angeboten wird.
Kann ich das Verzeichnis der ICAO-Flughafencodes lokal speichern?
Ja, mit einer passenden GEO-Essentials-Lizenz. Exportieren Sie mit dump=1 als JSON, XML oder CSV und wählen Sie mit major_only und show_disabled die gewünschte Abdeckung. Indizieren Sie gefüllte Werte von icao für lokale Abfragen und behalten Sie airhex_id als dauerhafte Datensatzkennung.
Wie pflege ich Zuordnungen und behandle fehlende Treffer?
Behalten Sie airhex_id und updated aus der vollständigen Antwort und aktualisieren Sie Ihr lokales Verzeichnis regelmäßig. Prüfen Sie, ob Codefelder gefüllt sind, bevor Sie Zuordnungen anlegen. Lässt sich ein Code aus Ihrer Quelle nicht auflösen, behalten Sie den ursprünglichen Wert zur Prüfung, statt einen Treffer über einen ähnlichen Flughafennamen zu raten.
Liefert die ICAO-Abfrage Live-Daten zu Flughafen oder Flugbetrieb?
Nein. Dieser Endpunkt liefert Flughafen-Referenzdaten zum Identifizieren und Abgleichen von Standorten. Aktuellen Flugstatus, Verfügbarkeit von Start- und Landebahnen und Betriebshinweise beziehen Sie von einem geeigneten Betriebsdaten-Anbieter. Das Feld active beschreibt den Betriebsstatus des Flughafendatensatzes, nicht den aktuellen Flugbetrieb.