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 le coordinate per la mappa dei tuoi aeroporti
Esporta in CSV gli aeroporti attivi con voli commerciali. Conserva latitude, longitude, codici e nomi per creare i marcatori della mappa da un elenco locale. Usa major_only=0 se il tuo prodotto ha bisogno anche di altri tipi di località.
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 airport-coordinates.csv
Trova le coordinate degli aeroporti di una città
Usa city_code=LON per recuperare gli aeroporti associati a Londra. Leggi latitude e longitude da ogni record per mostrare la posizione dei singoli aeroporti, invece di collocare ogni aeroporto nel centro della 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'
Recupera le coordinate con un codice ICAO
Usa icao quando la tua fonte dati identifica gli aeroporti con codici a quattro lettere. EGLL corrisponde allo stesso record di Heathrow di una ricerca IATA per LHR.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'icao=EGLL'
Domande frequenti
In quale formato vengono restituite le coordinate?
latitude e longitude sono campi separati che contengono valori in gradi decimali. Nell’esempio JSON sono stringhe numeriche. Interpretali come numeri quando la tua libreria di mappatura richiede input numerici e conserva i segni negativi e la precisione decimale disponibile.
Quale coordinata devo passare per prima alla mia libreria di mappe?
Controlla l’ordine atteso dalla libreria. Alcune interfacce richiedono prima la latitudine e poi la longitudine, altre il contrario. L’API restituisce campi con nome, così puoi associare ogni valore in modo esplicito invece di dipendere dall’ordine di un array.
Questo endpoint trova l’aeroporto più vicino?
No. Cerca gli aeroporti tramite gli identificatori documentati, il nome o i filtri di posizione, oppure esporta l’elenco. Per trovare gli aeroporti vicini, salva le coordinate ed esegui una query di distanza o spaziale nella tua applicazione. Questo endpoint non ha un parametro di richiesta per il raggio o per l’aeroporto più vicino.
Posso usare le coordinate per stimare il tempo di viaggio fino a un hotel?
Le coordinate possono essere input per il tuo servizio di mappe o di calcolo dei percorsi. Una distanza in linea retta non è una distanza su strada né un tempo di viaggio. Per stimare un trasferimento a terra usa un fornitore di percorsi adatto e il punto di ritiro o di arrivo pertinente.
Le coordinate identificano un terminal, un gate o un punto di ritiro?
Questi campi descrivono la posizione dell’aeroporto. Non trattarli come coordinate di terminal, gate, pista o punto di ritiro dei passeggeri. Usa dati di posizione più specifici quando il tuo prodotto ha bisogno di indicazioni all’interno di un aeroporto o di un punto d’incontro per il trasferimento.
Come limito la mia mappa agli aeroporti con voli commerciali?
Imposta major_only=1. Per impostazione predefinita vengono restituiti solo i record attivi; show_disabled=1 include i record inattivi o disattivati, se ti servono. La risposta completa include major_airport, sub_type e active per aiutare la tua applicazione a distinguere i record prima di mostrarli.
Che cosa devo fare se una coordinata manca o non è valida?
Controlla entrambi i campi prima di creare un marcatore. Scarta i valori mancanti, vuoti o non numerici e verifica che la latitudine sia compresa tra -90 e 90 e la longitudine tra -180 e 180. Non trasformare un campo vuoto in zero: anche zero può essere una coordinata valida. Tieni a disposizione per la revisione i record non risolti invece di collocarli in una posizione ipotizzata.
Posso tenere un elenco di coordinate degli aeroporti nel mio database?
Sì, con una licenza GEO Essentials adeguata. Usa dump=1 e scegli JSON, XML o CSV con response_type. Conserva airhex_id e updated dalla risposta completa e aggiorna periodicamente i tuoi record locali, così le modifiche a codici, nomi e coordinate possono essere applicate alla stessa identità dell’aeroporto.