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 fusi orari degli aeroporti per i tuoi itinerari
Esporta in CSV gli aeroporti attivi con voli commerciali e conserva timezone insieme ad airhex_id e ai codici aeroportuali. La tua applicazione potrà così risolvere il fuso orario di ogni tratta dell’itinerario da un elenco locale.
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-timezones.csv
Recupera un fuso orario con un codice ICAO
Usa icao quando la tua fonte identifica gli aeroporti con codici a quattro lettere. Questa richiesta risolve EGLL nello stesso record di Heathrow e nello stesso fuso orario 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'
Mostra un timestamp UTC ricevuto nell’ora locale dell’aeroporto
Dopo aver recuperato timezone, passalo al formattatore di data e ora della tua applicazione insieme a un timestamp non ambiguo del tuo fornitore di voli. Questo esempio JavaScript usa Europe/London dalla risposta. Il timestamp è solo illustrativo: l’API aeroporti non fornisce gli orari dei voli.
const airportTimeZone = 'Europe/London';
const departureUtc = '2026-07-15T12:00:00Z';
const localDeparture = new Intl.DateTimeFormat('en-GB', {
timeZone: airportTimeZone,
dateStyle: 'medium',
timeStyle: 'short'
}).format(new Date(departureUtc));
// 15 Jul 2026, 13:00
Domande frequenti
Qual è la differenza tra timezone e utc?
timezone identifica un fuso con nome, come Europe/London. utc fornisce uno scostamento nel record dell’aeroporto. Uno scostamento da solo non descrive le regole dell’ora legale né le variazioni tra le date. Nella conversione degli orari usa il fuso con nome insieme al timestamp effettivo del viaggio.
Come devo gestire l’ora legale?
Usa timezone con una libreria che tenga conto delle date, basata sulle regole dei fusi orari aggiornate. La libreria determina lo scostamento per la data da convertire. Non applicare lo scostamento UTC di esempio a ogni volo e mantieni aggiornati i dati sui fusi orari della tua applicazione, perché le regole possono cambiare.
L’API converte gli orari dei voli al posto mio?
No. Restituisce dati di riferimento sugli aeroporti, tra cui gli identificatori dei fusi orari. La tua applicazione esegue la conversione usando i timestamp forniti dal tuo fornitore di voli. Questo endpoint non ha parametri per la data di viaggio o la conversione degli orari.
E se il mio fornitore invia già gli orari locali dei voli?
Conferma il formato del timestamp del fornitore prima di convertire. Non interpretare un’ora locale come UTC e non convertirla due volte. Una data e un’ora locali senza scostamento possono essere ambigue in prossimità dei passaggi all’ora legale: quando disponibile, usa uno scostamento esplicito o un timestamp UTC del fornitore.
Come gestisco partenza e arrivo in fusi orari diversi?
Risolvi ogni aeroporto separatamente e formatta ogni timestamp con il timezone di quell’aeroporto. Includi la data locale quando un viaggio supera la mezzanotte. Calcola la durata effettiva del viaggio da timestamp non ambigui, invece di sottrarre gli orari locali visualizzati.
Posso presumere che tutti gli aeroporti di un paese usino lo stesso fuso orario?
No. Recupera il fuso orario del singolo record aeroportuale invece di dedurlo dal paese. Se cerchi per city_code o country_code, leggi timezone da ogni aeroporto restituito.
Posso salvare i fusi orari degli aeroporti nel mio database?
Sì, con una licenza GEO Essentials adeguata. Esporta con dump=1 e scegli JSON, XML o CSV con response_type. Conserva airhex_id e updated dalla risposta completa, aggiorna periodicamente le associazioni degli aeroporti e mantieni aggiornate le regole dei fusi orari nel software che esegue le conversioni.
Che cosa devo fare se un fuso orario manca o non è supportato?
Convalida il timezone restituito prima di passarlo al formattatore. Conserva il timestamp e lo scostamento originali del fornitore, se disponibili, e segnala per la revisione le associazioni non risolte. Non sostituirlo automaticamente con il fuso orario del dispositivo dell’utente né con uno scostamento ipotizzato per tutto il paese.