Machen Sie aus Destinationscodes Orte, die Reisende kennen. Rufen Sie Stadtnamen, Länder- und Bundesstaatsdetails, Koordinaten und Zeitzonen ab oder laden Sie das Verzeichnis herunter – für die Destinationssuche in Ihrem Reiseprodukt.
Senden Sie code=NYC, um New York City samt Referenzdaten abzurufen. Ersetzen Sie YOUR_API_KEY durch Ihren API-Schlüssel.
Rufen Sie geografische und demografische Details zu einzelnen Städten ab oder exportieren Sie die gesamte Städte-Datenbank als JSON, XML oder CSV.
EndpunktGET https://content.airhex.com/api/v3.7.10/cities/
curl --get 'https://content.airhex.com/api/v3.7.10/cities/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'code=NYC'[
{
"airhex_id": "5333",
"updated": "2025-10-23 05:47:19",
"code": "NYC",
"country_code": "US",
"name": "New York City",
"state_short": "NY",
"state_full": "New York",
"latitude": "40.7143528",
"longitude": "-74.0059731",
"city_photo": "https:\/\/content.airhex.com\/content\/city_photos\/5333.jpg",
"timezone": "America\/New_York",
"gmt": "-4",
"population": "8992908",
"popularity": "39128143"
}
]Vollständige JSON-Antwort. Scrollen Sie im Feld, um alle Felder zu sehen. Weiter unten finden Sie erweiterte JSON- und XML-Beispiele.
Geben Sie mindestens einen der Parameter code, country_code, name oder dump=1 an. Mit dump=1 werden die übrigen Abfrageparameter ignoriert.
| Parameter | Pflicht | Wert | Typ | Standard | Beschreibung |
|---|---|---|---|---|---|
| apikey | Ja | Beliebig | String | keiner | Ihr API-Schlüssel. Kostenlosen API-Testschlüssel anfordern. |
| code | Bedingt | AAA-ZZZ | String | keiner | Dreistelliger IATA-Stadtcode |
| country_code | Bedingt | AA-ZZ | String | keiner | Zweistelliger Ländercode nach ISO 3166-1 Alpha-2 |
| name | Bedingt | Beliebig | String | keiner | Stadtname oder Teilstring für die Suche |
| dump | Bedingt | 0 oder 1 | Integer | 0 | Auf 1 setzen, um die gesamte Datenbank zu exportieren (ignoriert die anderen bedingten Parameter oben) |
| response_type | Nein | JSON oder XML oder CSV | String | JSON | Antwortformat: JSON, XML oder CSV (CSV startet einen Dateidownload) |
Rufen Sie Kennungen, geografische Details, Destinationsbilder und demografische Felder zu Städten ab. Verlinkte Felder führen zu Anleitungen mit Beispielen und Hinweisen zur Integration.
| Feld | Beispiel | Beschreibung |
|---|---|---|
| airhex_id | 5333 | Eindeutige, dauerhafte Kennung des Datensatzes |
| updated | 2025-10-23 05:47:19 | Datum und Uhrzeit der letzten Aktualisierung des Datensatzes |
| code | NYC | Dreistelliger IATA-Code der Stadt |
| country_code | US | Ländercode nach ISO 3166-1 Alpha-2 |
| name | New York City | Name der Stadt |
| state_short | NY | Kürzel des Bundesstaats bzw. der Provinz (nur Städte in US, CA, AU) |
| state_full | New York | Vollständiger Name des Bundesstaats bzw. der Provinz (nur Städte in US, CA, AU) |
| latitude | 40.7143528 | Geografische Breite des Stadtzentrums |
| longitude | -74.0059731 | Geografische Länge des Stadtzentrums |
| city_photo | https://content.airhex.com/content/city_photos/5333.jpg | URL eines lizenzierten, kommerziell nutzbaren Stadtbilds |
| timezone | America/New_York | Zeitzonenkennung der Stadt |
| gmt | -4 | Zeitversatz der Stadt gegenüber GMT |
| population | 8992908 | Einwohnerzahl der Stadt |
| popularity | 39128143 | Relativer Beliebtheitsindex (ein höherer Wert bedeutet ein beliebteres Reiseziel) |
Die Beispiele zeigen den vollständigen Datensatz von New York City als JSON und XML. Das Ausgabeformat wählen Sie mit response_type.
[
{
"airhex_id": "5333",
"updated": "2025-10-23 05:47:19",
"code": "NYC",
"country_code": "US",
"name": "New York City",
"state_short": "NY",
"state_full": "New York",
"latitude": "40.7143528",
"longitude": "-74.0059731",
"city_photo": "https:\/\/content.airhex.com\/content\/city_photos\/5333.jpg",
"timezone": "America\/New_York",
"gmt": "-4",
"population": "8992908",
"popularity": "39128143"
}
]<?xml version="1.0" encoding="UTF-8"?>
<cities>
<city>
<airhex_id>5333</airhex_id>
<updated>2025-10-23 05:47:19</updated>
<code>NYC</code>
<country_code>US</country_code>
<name>New York City</name>
<state_short>NY</state_short>
<state_full>New York</state_full>
<latitude>40.7143528</latitude>
<longitude>-74.0059731</longitude>
<city_photo>https://content.airhex.com/content/city_photos/5333.jpg</city_photo>
<timezone>America/New_York</timezone>
<gmt>-4</gmt>
<population>8992908</population>
<popularity>39128143</popularity>
</city>
</cities>
Exportieren Sie den Städtedatensatz für eine lokale Zielauswahl. Behalten Sie airhex_id und updated zusammen mit Codes, Namen und Standortdetails bei.
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 cities.csvErstellen Sie mit einem zweistelligen Ländercode eine Städteliste für ein bestimmtes Land.
curl --get 'https://content.airhex.com/api/v3.7.10/cities/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'country_code=US'Eine Teilsuche im Namen kann mehrere Städte liefern. Vergleichen Sie Land und vorhandene Bundesstaatsdetails, 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'Sortieren Sie die Vorschläge Ihrer eigenen Destinationssuche mit Stadtnamen, Länderkontext und Beliebtheitswerten.
Illustrieren Sie Destinationskarten und Reiseführer mit den verfügbaren lizenzierten Stadtfotos.
Unterstützen Sie Suchen auf Stadtebene neben einzelnen Flughäfen, mit klarer Beschriftung jeder Option.
Ja. Verwenden Sie popularity als relatives Sortiersignal in Ihrer Anwendung; höhere Werte bedeuten ein beliebteres Reiseziel. Kombinieren Sie den Wert mit Ihrem eigenen Textabgleich und dem Standortkontext. Das Feld liefert keine personalisierten Empfehlungen und keinen vollständigen Algorithmus für Eingabevorschläge.
Das Feld city_photo liefert vorhandene, lizenzierte URLs von Destinationsbildern für die kommerzielle Nutzung im Rahmen Ihrer GEO-Essentials-Lizenz. Es gibt nicht für jede Stadt ein Bild: Prüfen Sie, ob eine URL vorhanden ist, und sehen Sie für Städte ohne Bild eine Ersatzgrafik vor. Nutzen Sie die Bilder im Rahmen der für Ihr Produkt vereinbarten Nutzungsrechte.
Airhex führt geografische Daten aus mehreren Quellen zusammen, gleicht sie ab und prüft sie täglich. Behalten Sie beim Import von Städtedatensätzen airhex_id und updated bei und aktualisieren Sie Ihr lokales Verzeichnis in regelmäßigen Abständen. Die tägliche Prüfung bedeutet nicht, dass sich jedes Feld jeder Stadt täglich ändert.
Ja, mit einer passenden GEO-Essentials-Lizenz. Exportieren Sie mit dump=1 und response_type als JSON, XML oder CSV. Behalten Sie airhex_id und updated bei und aktualisieren Sie Ihre lokalen Datensätze in regelmäßigen Abständen.
Nein. Rufen Sie die zugehörigen Flughafen-Datensätze über die Flughafen-API mit city_code ab. Klären Sie, wie Ihr Fluglieferant Suchen auf Stadtebene behandelt, bevor Sie die Option „Alle Flughäfen“ anbieten.
Die Namenssuche unterstützt Teilübereinstimmungen. Vergleichen Sie name, country_code und die vorhandenen Bundesstaatsfelder, statt automatisch den ersten Treffer zu wählen.
state_short und state_full gelten für Städte in den USA, in Kanada und in Australien. Rechnen Sie mit leeren Werten und nutzen Sie Stadtname und Land als grundlegenden Anzeigekontext.
Verwenden Sie code, etwa code=NYC. Die Städte-API nutzt iata nicht als Abfrageparameter.
Verwenden Sie timezone zusammen mit dem jeweiligen Zeitstempel und den aktuellen Zeitzonenregeln. Behandeln Sie den gmt-Offset nicht als festen Offset für jedes Datum.
Das Verzeichnis liefert Referenzdaten zu Destinationen. Es sagt nichts über Streckenabdeckung, Tarife oder Verfügbarkeit aus; diese beziehen Sie von Ihrem Buchungslieferanten.
Erstellen Sie klarere Zielvorschläge und anschaulichere Stadtansichten – mit Stadtcodes, Beliebtheitsdaten und verfügbaren lizenzierten Fotos.