Typische Aufgaben bei der Umsetzung
Stadtcodes für Ihre Zielauswahl herunterladen
Exportieren Sie das Städteverzeichnis als CSV und bauen Sie aus Codes, Namen, Ländern und verfügbaren Angaben zu Bundesstaaten einen lokalen Suchindex. Zeigen Sie genug Standortkontext an, damit Reisende Städte mit ähnlichen Namen unterscheiden können.
curl --get 'https://content.airhex.com/api/v3.7.10/cities/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'dump=1' \
--data-urlencode 'response_type=CSV' \
--output city-codes.csv
Stadtcode über den Namen des Reiseziels finden
Suchen Sie mit name und lesen Sie code aus den gelieferten Datensätzen. Teilübereinstimmungen können mehrere Ergebnisse liefern. Vergleichen Sie daher Land und Bundesstaat, bevor Sie ein Reiseziel auswählen.
curl --get 'https://content.airhex.com/api/v3.7.10/cities/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'name=New York'
Zielliste für ein Land aufbauen
Mit country_code=US rufen Sie die Städtedatensätze der Vereinigten Staaten ab. Nutzen Sie deren Codes und Namen für eine länderspezifische Zielliste; die Flugverfügbarkeit muss von Ihrem Buchungslieferanten kommen.
curl --get 'https://content.airhex.com/api/v3.7.10/cities/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'country_code=US'
Zu einer Stadt gehörende Flughäfen finden
Übergeben Sie nach dem Auflösen einer Stadt deren Code als city_code an die Flughafen-API. Das Beispiel fragt Flughäfen mit kommerziellem Flugbetrieb ab, die zu NYC gehören. Behalten Sie Code und Namen jedes Flughafens, wenn Sie Flughafenoptionen anzeigen; die Antwort der Städte-API enthält keine Flughafenliste.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'city_code=NYC' \
--data-urlencode 'major_only=1'
Häufig gestellte Fragen
Worin unterscheidet sich ein IATA-Stadtcode von einem Flughafencode?
Ein Stadtcode bezeichnet ein Ziel auf Stadtebene, ein Flughafencode einen einzelnen Flughafen. Eine Stadt kann mehreren Flughäfen zugeordnet sein. Halten Sie den Ortstyp Ihres Lieferanten zusammen mit dem Code fest, damit Ihre Anwendung weiß, ob sie eine Stadt oder einen Flughafen abfragen soll.
Welchen Parameter nutze ich, um einen Stadtcode abzufragen?
Verwenden Sie in der Städte-API code, z. B. code=NYC. Die Flughafen-API nutzt iata für die Abfrage eines einzelnen Flughafens und city_code, um die zu einer Stadt gehörenden Flughäfen zu finden. Diese Parameternamen gelten jeweils nur für ihren Endpunkt.
Kann ich das für eine Zieloption „alle Flughäfen“ verwenden?
Beschriften Sie das Ziel mit dem Städtedatensatz und rufen Sie die zugehörigen Flughäfen über die Flughafen-API ab. Klären Sie, wie Ihr Fluglieferant Suchen auf Stadtebene akzeptiert und welche Flughäfen er einschließt. Städte-Referenzdaten allein legen die Suchabdeckung eines Lieferanten nicht fest und garantieren keine buchbare Strecke.
Kann ich einen Stadtcode über den Namen der Stadt finden?
Ja. Der Parameter name unterstützt Teilübereinstimmungen. Vergleichen Sie name, country_code und die verfügbaren Felder zum Bundesstaat in der Antwort, statt automatisch das erste Ergebnis zu nehmen. Behalten Sie Stadtcode und Datensatz, sobald der Nutzer ein Ziel gewählt hat.
Hat jede Stadt einen IATA-Code?
Betrachten Sie dieses Verzeichnis nicht als Liste aller Gemeinden. Bauen Sie Ihre Code-Abfrage aus den gelieferten Städtedatensätzen auf und prüfen Sie, ob code gefüllt ist, bevor Sie eine codebasierte Zuordnung anlegen. Raten Sie bei Zielen, die Ihre Anwendung nicht auflösen kann, keinen Code aus dem Namen.
Gibt es Namen von Bundesstaaten und Provinzen für jedes Land?
Die dokumentierten Felder state_short und state_full gelten für Städte in den Vereinigten Staaten, Kanada und Australien. Rechnen Sie bei anderen Zielen mit leeren Werten und verwenden Sie Städtename und Ländercode als grundlegenden Anzeigekontext.
Kann ich das Verzeichnis der Stadtcodes 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. Behalten Sie airhex_id als dauerhafte Datensatzkennung und updated aus der vollständigen Antwort und aktualisieren Sie Ihr lokales Verzeichnis regelmäßig.
Enthält die API Flugstrecken, Preise oder Verfügbarkeit?
Nein. Die Städte-API liefert Referenzdaten zu Reisezielen. Streckenabdeckung, Flugpläne, Preise und Verfügbarkeit beziehen Sie von Ihrem Fluglieferanten; dass eine Stadt im Verzeichnis steht, belegt nicht, dass eine bestimmte Reise buchbar ist.