Trasforma i codici città in destinazioni che i viaggiatori riconoscono. Associa i codici IATA di città a tre lettere a nomi di città, paesi e dati sullo stato disponibili, oppure scarica l’elenco per alimentare la ricerca delle destinazioni nel tuo prodotto di viaggio.
Passa NYC nel parametro code dell’API città per recuperare New York City. Sostituisci YOUR_API_KEY con la tua chiave API.
curl --get 'https://content.airhex.com/api/v3.7.10/cities/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'code=NYC'[
{
"airhex_id": "5333",
"code": "NYC",
"country_code": "US",
"name": "New York City",
"state_short": "NY",
"state_full": "New York",
...
}
]Risposta abbreviata. I puntini di sospensione (…) rappresentano altri campi della città omessi qui e non fanno parte della risposta JSON effettiva.
Vedi il riferimento completo: API città →Cerca un codice città, trova destinazioni per nome o paese oppure esporta l’elenco delle città.
| Parametro | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|
apikey |
Sì | Nessuno | La tua chiave API. Richiedi una chiave API di prova gratuita. |
code |
Condizionale | Nessuno | Codice IATA di città a tre lettere, ad esempio NYC. |
country_code |
Condizionale | Nessuno | Codice paese ISO a due lettere, ad esempio US, per recuperare le città di un paese. |
name |
Condizionale | Nessuno | Nome della città, anche parziale, per la corrispondenza nella ricerca. |
dump |
Condizionale | 0 | Imposta 1 per esportare l’intero database. Ha la precedenza sugli altri parametri di ricerca. |
response_type |
No | JSON | Formato della risposta: JSON, XML o CSV. Con CSV parte il download di un file. |
Indica almeno uno tra code, country_code, name o dump=1. L’API città usa code, non iata, per cercare un codice città.
Vedi tutti i parametri della richiesta →Usa il codice città per risolvere una destinazione e i campi di nome e posizione correlati per mostrarla in modo chiaro. Quando mantieni i tuoi record locali, conserva airhex_id.
| Campo | Tipo | Esempio | Descrizione |
|---|---|---|---|
airhex_id |
Identificatore | 5333 | Identificatore permanente del record Airhex per mantenere il tuo elenco locale delle destinazioni. |
code |
String | NYC | Codice IATA di città a tre lettere per associare i record delle destinazioni. |
country_code |
String | US | Codice paese ISO a due lettere per le etichette dei paesi e il raggruppamento delle destinazioni. |
name |
String | New York City | Nome della città per ricerca delle destinazioni, schermate di prenotazione e itinerari. |
state_short |
String | NY | Abbreviazione dello stato o della provincia, disponibile per le città degli Stati Uniti, del Canada e dell’Australia. |
state_full |
String | New York | Nome completo dello stato o della provincia, disponibile per le città degli Stati Uniti, del Canada e dell’Australia. |
Esporta l’elenco delle città in CSV e crea un indice di ricerca locale da codici, nomi, paesi e dati sullo stato disponibili. Mostra un contesto di posizione sufficiente a far distinguere ai viaggiatori le città con nomi simili.
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.csvCerca con name e leggi code dai record restituiti. La corrispondenza parziale può produrre più risultati, quindi confronta paese e dati sullo stato prima di scegliere una destinazione.
curl --get 'https://content.airhex.com/api/v3.7.10/cities/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'name=New York'Passa country_code=US per recuperare i record delle città degli Stati Uniti. Usa codici e nomi per un elenco di destinazioni specifico per paese; la disponibilità dei voli deve provenire dal tuo fornitore di prenotazioni.
curl --get 'https://content.airhex.com/api/v3.7.10/cities/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'country_code=US'Dopo aver risolto una città, passa il suo codice come city_code all’API aeroporti. Questo esempio richiede gli aeroporti con voli commerciali associati a NYC. Quando mostri le scelte di aeroporto, conserva il codice e il nome di ciascun aeroporto; la risposta dell’API città non contiene un elenco di aeroporti.
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'Mostra i nomi delle città con il contesto di paese e stato, invece di chiedere ai viaggiatori di interpretare i codici delle destinazioni.
Supporta le scelte di destinazione a livello di città insieme ai singoli aeroporti, usando le API città e aeroporti per etichettare chiaramente ogni opzione.
Associa le destinazioni codificate agli stessi record di città in strumenti di prenotazione, assistenza clienti e report.
Un codice città identifica una destinazione a livello di città, mentre un codice aeroportuale identifica un singolo aeroporto. Una città può essere associata a più aeroporti. Conserva il tipo di località del fornitore insieme al suo codice, così la tua applicazione sa se cercare una città o un aeroporto.
Usa code nell’API città, ad esempio code=NYC. L’API aeroporti usa iata per cercare un singolo aeroporto e city_code per trovare gli aeroporti associati a una città. Questi nomi di parametro sono specifici dei rispettivi endpoint.
Usa il record della città per etichettare la destinazione e l’API aeroporti per recuperare gli aeroporti associati. Verifica come il tuo fornitore di voli accetta le ricerche a livello di città e quali aeroporti include. I soli dati di riferimento delle città non definiscono la copertura di ricerca di un fornitore né garantiscono una rotta prenotabile.
Sì. Il parametro name supporta la corrispondenza parziale. Confronta name, country_code e i campi dello stato disponibili invece di selezionare automaticamente il primo risultato. Una volta che l’utente sceglie una destinazione, conserva il codice città selezionato e la sua identità.
Non considerare questo elenco come la lista completa dei comuni. Crea la tua ricerca per codice dai record delle città restituiti e verifica che code sia valorizzato prima di creare un’associazione basata sul codice. Gestisci le destinazioni che la tua applicazione non riesce a risolvere senza indovinare un codice dal nome.
I campi documentati state_short e state_full valgono per le città degli Stati Uniti, del Canada e dell’Australia. Gestisci i valori vuoti per le altre destinazioni e usa il nome della città e il codice paese come contesto di visualizzazione di base.
Sì, con una licenza GEO Essentials adeguata. Usa dump=1 e scegli JSON, XML o CSV con response_type. Conserva airhex_id come identificatore permanente del record e updated dalla risposta completa, e aggiorna periodicamente il tuo elenco locale.
No. L’API città fornisce dati di riferimento sulle destinazioni. Per copertura delle rotte, orari, tariffe e disponibilità rivolgiti al tuo fornitore di voli: la presenza di una città nell’elenco non dimostra che un determinato viaggio sia prenotabile.
Crea una ricerca di città e scelte di destinazione più chiare in tutto il tuo prodotto di viaggio, senza dover mantenere un tuo elenco dei codici IATA delle città.
Scopri l’intero set di dati delle città: codici IATA di città, nomi, paesi, dati sullo stato, coordinate, fusi orari e immagini delle destinazioni. Consulta tutti i parametri della richiesta e i campi della risposta, con ricerche singole, ricerche per paese ed esportazioni complete in JSON, XML e CSV.