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 un elenco dei codici aeroportuali ICAO
Esporta in CSV l’elenco degli aeroporti attivi e crea un indice locale dai record con il campo icao valorizzato. Mantieni iata, dove disponibile, per agevolare l’associazione con i dati di prenotazione. Aggiungi major_only=1 se il tuo prodotto ha bisogno solo degli aeroporti con voli commerciali.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'dump=1' \
--data-urlencode 'response_type=CSV' \
--output airports.csv
Trova un codice ICAO da un codice IATA
Passa LHR in iata e leggi icao dalla risposta. Così la tua applicazione può associare l’identificativo aeroportuale di un fornitore di prenotazioni a una fonte che usa codici ICAO, usando entrambi i codici dello stesso record aeroportuale.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'iata=LHR'
Trova un codice ICAO dal nome dell’aeroporto
Cerca con name e controlla il campo icao restituito. I nomi parziali possono restituire diverse corrispondenze, quindi confronta nome dell’aeroporto, paese e altri identificatori prima di selezionare un record.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'name=Heathrow'
Domande frequenti
Qual è la differenza tra codici aeroportuali ICAO e IATA?
Gli identificativi aeroportuali ICAO hanno quattro lettere, come EGLL per Londra Heathrow. I codici aeroportuali IATA hanno tre lettere, come LHR. Usa icao o iata in base al sistema di codici fornito dalla tua fonte; la risposta fornisce entrambi i campi, dove disponibili.
Posso associare i codici aeroportuali ICAO ai codici IATA?
Sì. Cerca l’aeroporto con icao e leggi il campo iata restituito. Puoi anche cercare un codice IATA con iata e leggere icao. Verifica che il campo di destinazione sia valorizzato prima di creare un’associazione; non dare per scontato che ogni record abbia entrambi gli identificativi.
Posso usare un codice città come codice aeroportuale ICAO?
No. Un codice città come LON è un identificativo di destinazione distinto. Usa city_code per trovare gli aeroporti associati a una città, poi usa il valore icao del record dell’aeroporto pertinente. Una città può essere servita da più aeroporti.
Quali aeroporti sono inclusi per impostazione predefinita?
La richiesta predefinita restituisce i record attivi e non limita i risultati agli aeroporti con voli commerciali. Imposta major_only=1 per questa restrizione. Il set di dati più ampio può includere altri tipi di località; verifica icao prima di aggiungere record a una ricerca ICAO e usa major_airport e sub_type della risposta completa per distinguere le strutture.
Posso includere gli aeroporti inattivi per i record storici?
Imposta show_disabled=1 per includere i record inattivi o disattivati e controlla active nella risposta. Mantieni disponibile questo stato quando risolvi dati storici, così un vecchio riferimento aeroportuale non viene proposto automaticamente come destinazione attiva di prenotazione.
Posso salvare in locale l’elenco degli aeroporti ICAO?
Sì, con una licenza GEO Essentials adeguata. Usa dump=1 per esportare in JSON, XML o CSV e scegli major_only e show_disabled in base alla copertura che ti serve. Indicizza i valori icao valorizzati per le ricerche locali, conservando airhex_id come identificatore permanente del record.
Come devo mantenere le associazioni e gestire le corrispondenze mancanti?
Conserva airhex_id e updated dalla risposta completa e aggiorna periodicamente il tuo elenco locale. Verifica che i campi dei codici siano valorizzati prima di creare le associazioni. Se una ricerca non riesce a risolvere un codice della fonte, conserva il valore originale per la revisione invece di indovinare una corrispondenza dal nome di un aeroporto simile.
Una ricerca ICAO fornisce dati operativi in tempo reale su aeroporti o voli?
No. Questo endpoint fornisce dati di riferimento sugli aeroporti per identificare e associare le località. Per lo stato dei voli in tempo reale, la disponibilità delle piste e gli avvisi operativi rivolgiti al fornitore di dati operativi appropriato. Il campo active descrive lo stato operativo del record dell’aeroporto, non le condizioni dei voli in corso.