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
Zeitzonen der Flughäfen für Ihre Reisepläne herunterladen
Exportieren Sie aktive Flughäfen mit kommerziellem Flugbetrieb als CSV und behalten Sie timezone zusammen mit airhex_id und Flughafencodes. Ihre Anwendung kann dann die Zeitzone jedes Reiseabschnitts aus einem lokalen Verzeichnis auflösen.
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 airport-timezones.csv
Zeitzone über einen ICAO-Code abrufen
Verwenden Sie icao, wenn Ihre Quelle Flughäfen mit vierstelligen Codes angibt. Diese Anfrage führt EGLL zum selben Datensatz von Heathrow und zur selben Zeitzone wie die IATA-Abfrage für LHR.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'icao=EGLL'
Einen gelieferten UTC-Zeitstempel in der Ortszeit des Flughafens anzeigen
Übergeben Sie timezone nach dem Abruf zusammen mit einem eindeutigen Zeitstempel Ihres Fluglieferanten an die Datums- und Zeitformatierung Ihrer Anwendung. Das JavaScript-Beispiel verwendet Europe/London aus der Antwort. Der Zeitstempel dient nur zur Veranschaulichung; die Flughafen-API liefert keine Flugzeiten.
const airportTimeZone = 'Europe/London';
const departureUtc = '2026-07-15T12:00:00Z';
const localDeparture = new Intl.DateTimeFormat('en-GB', {
timeZone: airportTimeZone,
dateStyle: 'medium',
timeStyle: 'short'
}).format(new Date(departureUtc));
// 15 Jul 2026, 13:00
Häufig gestellte Fragen
Worin unterscheiden sich timezone und utc?
timezone nennt eine benannte Zone wie Europe/London. utc liefert einen Offset aus dem Flughafendatensatz. Ein Offset allein sagt nichts über Sommerzeitregeln oder Änderungen über das Jahr aus. Verwenden Sie für die Umrechnung die benannte Zone mit dem tatsächlichen Reisezeitstempel.
Wie gehe ich mit der Sommerzeit um?
Verwenden Sie timezone mit einer datumsfähigen Bibliothek, die aktuelle Zeitzonenregeln nutzt. Die Bibliothek bestimmt den Offset für das umzurechnende Datum. Wenden Sie den UTC-Offset aus dem Beispiel nicht auf jeden Flug an und halten Sie die Zeitzonendaten Ihrer Anwendung aktuell, da sich Regeln ändern können.
Rechnet die API Flugzeiten für mich um?
Nein. Sie liefert Flughafen-Referenzdaten, darunter Zeitzonenkennungen. Die Umrechnung führt Ihre Anwendung mit den Zeitstempeln Ihres Fluganbieters durch. Einen Parameter für Reisedatum oder Zeitumrechnung gibt es bei diesem Endpunkt nicht.
Was gilt, wenn mein Lieferant schon Ortszeiten sendet?
Klären Sie das Zeitstempelformat des Lieferanten, bevor Sie umrechnen. Interpretieren Sie eine Ortszeit nicht als UTC und rechnen Sie nicht doppelt um. Ortsdatum und -uhrzeit ohne Offset können rund um Sommerzeit-Wechsel mehrdeutig sein; verwenden Sie, wenn möglich, einen Zeitstempel des Lieferanten mit ausdrücklichem Offset oder in UTC.
Wie behandle ich Abflug und Ankunft in verschiedenen Zeitzonen?
Lösen Sie jeden Flughafen einzeln auf und formatieren Sie jeden Zeitstempel mit der timezone dieses Flughafens. Zeigen Sie das Ortsdatum, wenn die Reise Mitternacht überschreitet. Berechnen Sie die Reisedauer aus eindeutigen Zeitstempeln und nicht durch Subtrahieren der angezeigten Ortszeiten.
Kann ich annehmen, dass alle Flughäfen eines Landes dieselbe Zeitzone haben?
Nein. Rufen Sie die Zeitzone für den jeweiligen Flughafen-Datensatz ab, statt sie aus dem Land abzuleiten. Wenn Sie mit city_code oder country_code suchen, lesen Sie timezone aus jedem gelieferten Flughafen.
Kann ich Flughafen-Zeitzonen in meiner eigenen Datenbank speichern?
Ja, mit einer passenden GEO-Essentials-Lizenz. Exportieren Sie mit dump=1 und wählen Sie mit response_type JSON, XML oder CSV. Behalten Sie airhex_id und updated aus der vollständigen Antwort, aktualisieren Sie Ihre Flughafenzuordnungen regelmäßig und pflegen Sie in der Software, die umrechnet, aktuelle Zeitzonenregeln.
Was tue ich, wenn eine Zeitzone fehlt oder nicht unterstützt wird?
Prüfen Sie die gelieferte timezone, bevor Sie sie an Ihre Formatierung übergeben. Behalten Sie den ursprünglichen Zeitstempel und, falls vorhanden, den Offset des Lieferanten und markieren Sie nicht aufgelöste Zuordnungen zur Prüfung. Ersetzen Sie sie nicht stillschweigend durch die Zeitzone des Nutzergeräts oder einen geschätzten landesweiten Offset.