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
Koordinaten für Ihre Flughafenkarte herunterladen
Exportieren Sie aktive Flughäfen mit kommerziellem Flugbetrieb als CSV. Behalten Sie Breitengrad, Längengrad, Codes und Namen, um Kartenmarkierungen aus einem lokalen Verzeichnis zu bauen. Verwenden Sie major_only=0, wenn Ihr Produkt auch andere Standorttypen braucht.
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-coordinates.csv
Koordinaten der Flughäfen einer Stadt finden
Mit city_code=LON rufen Sie die zu London gehörenden Flughäfen ab. Lesen Sie latitude und longitude jedes Datensatzes, um die einzelnen Flughafenstandorte zu zeigen, statt alle Flughäfen im Stadtzentrum zu platzieren.
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'
Koordinaten über einen ICAO-Code abrufen
Verwenden Sie icao, wenn Ihre Datenquelle Flughäfen mit vierstelligen Codes angibt. EGLL führt zum selben Datensatz von Heathrow 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'
Häufig gestellte Fragen
In welchem Format werden die Koordinaten geliefert?
latitude und longitude sind getrennte Felder mit Werten in Dezimalgrad. Im JSON-Beispiel sind es numerische Strings. Parsen Sie sie als Zahlen, wenn Ihre Kartenbibliothek numerische Eingaben braucht, und behalten Sie negative Vorzeichen und die verfügbare Nachkommagenauigkeit bei.
Welche Koordinate übergebe ich meiner Kartenbibliothek zuerst?
Prüfen Sie die erwartete Reihenfolge der Bibliothek. Manche Schnittstellen erwarten erst den Breitengrad, dann den Längengrad, andere umgekehrt. Die API liefert benannte Felder, sodass Sie jeden Wert ausdrücklich zuordnen können, statt sich auf die Reihenfolge in einem Array zu verlassen.
Findet dieser Endpunkt den nächstgelegenen Flughafen?
Nein. Er fragt Flughäfen über die dokumentierten Kennungen, den Namen oder Standortfilter ab oder exportiert das Verzeichnis. Für Flughäfen in der Nähe speichern Sie die Koordinaten und führen in Ihrer Anwendung eine Entfernungs- oder Raumabfrage durch. Einen Umkreis- oder Nächster-Flughafen-Parameter gibt es bei diesem Endpunkt nicht.
Kann ich mit den Koordinaten die Fahrzeit zu einem Hotel schätzen?
Die Koordinaten können Eingaben für Ihren Karten- oder Routingdienst sein. Eine Luftlinie ist weder eine Straßenentfernung noch eine Reisezeit. Nutzen Sie für die Schätzung eines Transfers einen geeigneten Routing-Anbieter und den passenden Abhol- oder Zielort.
Bezeichnen die Koordinaten ein Terminal, ein Gate oder einen Abholpunkt?
Diese Felder beschreiben den Standort des Flughafens. Behandeln Sie sie nicht als Koordinaten von Terminal, Gate, Start- und Landebahn oder Passagier-Abholpunkt. Verwenden Sie genauere Standortdaten, wenn Ihr Produkt Wegbeschreibungen im Flughafen oder Treffpunkte für Transfers braucht.
Wie beschränke ich meine Karte auf Flughäfen mit kommerziellem Flugbetrieb?
Setzen Sie major_only=1. Standardmäßig werden nur aktive Datensätze geliefert; mit show_disabled=1 erhalten Sie bei Bedarf auch inaktive oder deaktivierte. Die vollständige Antwort enthält major_airport, sub_type und active, damit Ihre Anwendung Datensätze vor der Anzeige unterscheiden kann.
Was tue ich, wenn eine Koordinate fehlt oder ungültig ist?
Prüfen Sie beide Felder, bevor Sie eine Markierung anlegen. Verwerfen Sie fehlende, leere oder nicht numerische Werte und prüfen Sie, ob der Breitengrad zwischen -90 und 90 und der Längengrad zwischen -180 und 180 liegt. Machen Sie aus einem leeren Feld keine Null; Null selbst kann eine gültige Koordinate sein. Halten Sie nicht aufgelöste Datensätze zur Prüfung bereit, statt sie an einem geschätzten Ort zu platzieren.
Kann ich ein Verzeichnis der Flughafenkoordinaten in meiner eigenen Datenbank führen?
Ja, mit einer passenden GEO-Essentials-Lizenz. Verwenden Sie dump=1 und wählen Sie mit response_type JSON, XML oder CSV. Behalten Sie airhex_id und updated aus der vollständigen Antwort und aktualisieren Sie Ihre lokalen Datensätze regelmäßig, damit Änderungen bei Code, Name und Koordinaten für denselben Flughafen übernommen werden.