Parametri della richiesta
Usa questi parametri di query per cercare un aeroporto specifico, trovare aeroporti per posizione o esportare l’elenco.
| Parametro | Obbligatorio | Predefinito | Descrizione |
|---|
apikey |
Sì | Nessuno | La tua chiave API. Richiedi una chiave API di prova gratuita. |
|---|
iata |
Condizionale | Nessuno | Codice IATA dell’aeroporto a tre lettere, ad esempio LHR. |
|---|
icao |
Condizionale | Nessuno | Codice ICAO dell’aeroporto a quattro lettere, ad esempio EGLL. |
|---|
city_code |
Condizionale | Nessuno | Codice IATA di città a tre lettere, ad esempio LON, per trovare gli aeroporti associati a una città. |
|---|
country_code |
Condizionale | Nessuno | Codice paese ISO a due lettere, ad esempio GB, per trovare gli aeroporti di un paese. |
|---|
name |
Condizionale | Nessuno | Nome dell’aeroporto, anche parziale, ad esempio Heathrow. |
|---|
dump |
Condizionale | 0 | Imposta 1 per esportare il database. Ha la precedenza sugli altri parametri di ricerca; i filtri di copertura restano attivi. |
|---|
show_disabled |
No | 0 | Imposta 1 per includere i record inattivi o disattivati. Per impostazione predefinita vengono restituiti solo i record attivi. |
|---|
response_type |
No | JSON | Formato della risposta: JSON, XML o CSV. Con CSV parte il download di un file. |
|---|
major_only |
No | 0 | Imposta 1 per includere solo gli aeroporti con voli commerciali. |
|---|
Indica almeno uno tra iata, icao, city_code, country_code, name o dump=1. Con dump=1 gli altri parametri di ricerca vengono ignorati.
Vedi tutti i parametri della richiesta →
Attività comuni di implementazione
Scarica i codici per il tuo selettore di aeroporti
Esporta in CSV gli aeroporti attivi con voli commerciali, poi crea il tuo indice di ricerca locale da codici, nomi e identificatori di posizione. Usa major_only=0 se il tuo prodotto ha bisogno anche di altri tipi di località. Verifica che iata sia valorizzato prima di aggiungere una ricerca basata sul codice.
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 airports.csv
Trova i codici degli aeroporti di una città
Usa city_code=LON per recuperare gli aeroporti associati a Londra. Conserva il codice IATA e il nome di ciascun aeroporto, così i viaggiatori possono distinguere gli aeroporti di partenza e di arrivo all’interno della stessa città.
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'
Trova un codice IATA dal nome dell’aeroporto
Cerca con name e leggi iata dai record restituiti. I nomi parziali possono corrispondere a più record, quindi confronta nomi degli aeroporti e campi di posizione prima di scegliere una corrispondenza.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'name=Heathrow'
Associa un codice aeroportuale ICAO a un codice IATA
Passa il codice ICAO a quattro lettere in icao e leggi il campo iata restituito per collegare i record aeronautici agli identificativi aeroportuali usati dal tuo fornitore di prenotazioni.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'icao=EGLL'
Domande frequenti
In che cosa i codici IATA degli aeroporti differiscono dai codici città?
Un codice aeroportuale identifica un aeroporto specifico, come LHR per Londra Heathrow. Un codice città raggruppa una destinazione, come LON per Londra. Usa iata per cercare un aeroporto e city_code per trovare gli aeroporti associati a una città. Tieni separati i due campi quando gestisci l’opzione di destinazione “tutti gli aeroporti” di un fornitore.
Posso risolvere i codici di partenza e di arrivo del mio fornitore di prenotazioni?
Sì, quando i valori forniti sono codici aeroportuali IATA. Cerca ogni codice con iata per recuperare il nome e la posizione dell’aeroporto. Prima di scegliere il parametro di ricerca, verifica se il campo del tuo fornitore rappresenta un aeroporto o una città. Se non riesci a risolvere una corrispondenza, usa il codice originale del fornitore come riserva.
Ogni record restituito rappresenta un aeroporto con voli commerciali?
No. Il set di dati più ampio può includere altri tipi di località, come stazioni ferroviarie o degli autobus ed eliporti. Imposta major_only=1 per gli aeroporti con voli commerciali. La risposta completa include major_airport e sub_type per aiutare la tua applicazione a distinguere i record. Verifica che iata sia valorizzato prima di creare un’associazione basata sul codice.
Sono inclusi gli aeroporti inattivi?
Per impostazione predefinita vengono restituiti solo i record attivi. Imposta show_disabled=1 se ti servono i record inattivi per itinerari storici o report e controlla active prima di proporre un aeroporto in un selettore di prenotazione.
Posso scaricare e salvare un elenco dei codici aeroportuali?
Sì, con una licenza GEO Essentials adeguata. Usa dump=1 e seleziona JSON, XML o CSV con response_type. Scegli major_only e show_disabled in base alla copertura che serve al tuo prodotto. Un elenco locale permette di risolvere i codici e creare la ricerca degli aeroporti senza richiedere ogni aeroporto separatamente.
Devo usare il codice IATA come chiave permanente nel mio database?
Conserva airhex_id come identificatore permanente del record e usa iata come valore di ricerca. Salva updated dalla risposta completa quando importi i record e pianifica aggiornamenti periodici del tuo elenco locale. Così puoi anche tenere i record che non hanno un codice IATA valorizzato.
Posso cercare un aeroporto usando invece il suo codice ICAO?
Sì. Passa in icao un codice ICAO aeroportuale a quattro lettere, ad esempio EGLL, e leggi iata dalla risposta. I codici ICAO degli aeroporti sono distinti dai codici ICAO delle compagnie aeree a tre lettere usati dall’API compagnie aeree.
Questa API fornisce voli, tariffe o partenze aeroportuali in tempo reale?
No. Questo endpoint fornisce dati di riferimento sugli aeroporti. Per orari, disponibilità, tariffe e informazioni sui voli in tempo reale rivolgiti al tuo fornitore di voli. Un record aeroportuale attivo o un flag di voli commerciali non dimostra che una determinata rotta sia prenotabile.