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
Codes für Ihre Flughafenauswahl herunterladen
Exportieren Sie aktive Flughäfen mit kommerziellem Flugbetrieb als CSV und bauen Sie aus Codes, Namen und Standortkennungen Ihren lokalen Suchindex. Verwenden Sie major_only=0, wenn Ihr Produkt auch andere Standorttypen braucht. Prüfen Sie, ob iata gefüllt ist, bevor Sie eine codebasierte Abfrage aufbauen.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'dump=1' \
--data-urlencode 'major_only=1' \
--data-urlencode 'response_type=CSV' \
--output airports.csv
Flughafencodes einer Stadt finden
Mit city_code=LON rufen Sie die zu London gehörenden Flughäfen ab. Behalten Sie IATA-Code und Namen jedes Flughafens, damit Reisende Abflug- und Ankunftsflughäfen innerhalb derselben Stadt unterscheiden können.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'city_code=LON' \
--data-urlencode 'major_only=1'
IATA-Code über den Flughafennamen finden
Suchen Sie mit name und lesen Sie iata aus den gelieferten Datensätzen. Teilnamen können mehrere Datensätze treffen. Vergleichen Sie daher Flughafennamen und Standortfelder, bevor Sie einen Treffer auswählen.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'name=Heathrow'
ICAO-Flughafencode einem IATA-Code zuordnen
Übergeben Sie den vierstelligen ICAO-Code in icao und lesen Sie das Feld iata aus der Antwort, um Luftfahrtdaten mit den Flughafenkennungen Ihres Buchungslieferanten zu verbinden.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'icao=EGLL'
Häufig gestellte Fragen
Worin unterscheiden sich IATA-Flughafencodes von Stadtcodes?
Ein Flughafencode bezeichnet einen bestimmten Flughafen, z. B. LHR für London Heathrow. Ein Stadtcode fasst ein Ziel zusammen, z. B. LON für London. Verwenden Sie iata für die Flughafenabfrage und city_code, um die zu einer Stadt gehörenden Flughäfen zu finden. Halten Sie beide Felder getrennt, wenn Sie die Zieloption „alle Flughäfen“ eines Lieferanten verarbeiten.
Kann ich Abflug- und Ankunftscodes meines Buchungslieferanten auflösen?
Ja, wenn die gelieferten Werte IATA-Flughafencodes sind. Fragen Sie jeden Code mit iata ab, um Flughafenname und Standort zu erhalten. Klären Sie, ob das Feld Ihres Lieferanten einen Flughafen oder eine Stadt meint, bevor Sie den Abfrageparameter wählen. Verwenden Sie den ursprünglichen Lieferantencode als Ersatz, wenn sich kein Treffer auflösen lässt.
Steht jeder gelieferte Datensatz für einen Flughafen mit kommerziellem Flugbetrieb?
Nein. Der breitere Datensatz kann weitere Standorttypen enthalten, z. B. Bahnhöfe, Busbahnhöfe und Hubschrauberlandeplätze. Setzen Sie major_only=1 für Flughäfen mit kommerziellem Flugbetrieb. Die vollständige Antwort enthält major_airport und sub_type, damit Ihre Anwendung Datensätze unterscheiden kann. Prüfen Sie, ob iata gefüllt ist, bevor Sie eine codebasierte Zuordnung aufbauen.
Sind inaktive Flughäfen enthalten?
Standardmäßig werden nur aktive Datensätze geliefert. Setzen Sie show_disabled=1, wenn Sie inaktive Datensätze für historische Reisepläne oder Berichte brauchen, und prüfen Sie active, bevor Sie einen Flughafen in einer Buchungsauswahl anbieten.
Kann ich ein Verzeichnis der Flughafencodes herunterladen und speichern?
Ja, mit einer passenden GEO-Essentials-Lizenz. Verwenden Sie dump=1 und wählen Sie mit response_type JSON, XML oder CSV. Legen Sie mit major_only und show_disabled die Abdeckung fest, die Ihr Produkt braucht. Mit einem lokalen Verzeichnis lösen Sie Codes auf und bauen die Flughafensuche, ohne jeden Flughafen einzeln abzufragen.
Soll ich den IATA-Code als dauerhaften Datenbankschlüssel verwenden?
Behalten Sie airhex_id als dauerhafte Datensatzkennung und nutzen Sie iata als Abfragewert. Speichern Sie beim Import updated aus der vollständigen Antwort und planen Sie regelmäßige Aktualisierungen Ihres lokalen Verzeichnisses. So behalten Sie auch Datensätze ohne gefüllten IATA-Code.
Kann ich einen Flughafen stattdessen über den ICAO-Code abfragen?
Ja. Übergeben Sie einen vierstelligen ICAO-Flughafencode, z. B. EGLL, in icao und lesen Sie iata aus der Antwort. ICAO-Flughafencodes sind von den dreistelligen ICAO-Codes der Fluggesellschaften in der Airline-API zu unterscheiden.
Liefert die API Flüge, Preise oder Live-Abflüge eines Flughafens?
Nein. Dieser Endpunkt liefert Flughafen-Referenzdaten. Flugpläne, Verfügbarkeit, Preise und Live-Fluginformationen beziehen Sie von Ihrem Fluglieferanten. Ein aktiver Flughafendatensatz oder ein Kennzeichen für kommerziellen Flugbetrieb belegt nicht, dass eine bestimmte Strecke buchbar ist.