Aiuta i viaggiatori a riconoscere l’aeroporto giusto e a capire dove inizia e dove finisce il loro viaggio. Consulta codici aeroportuali, nomi, posizioni e fusi orari, oppure scarica l’elenco per i tuoi strumenti di ricerca e prenotazione.
Invia iata=LHR per ottenere l’aeroporto di Londra Heathrow e i suoi dati di riferimento. Sostituisci YOUR_API_KEY con la tua chiave API.
Questo endpoint consente di ottenere i dati geografici di un aeroporto specifico o di estrarre l’intero database degli aeroporti, con risposte disponibili in formato JSON, XML o CSV.
EndpointGET https://content.airhex.com/api/v3.7.10/airports/
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'iata=LHR'[
{
"airhex_id": "53779",
"updated": "2025-09-03 13:16:53",
"iata": "LHR",
"icao": "EGLL",
"name": "London Heathrow Airport",
"city_code": "LON",
"country_code": "GB",
"timezone": "Europe\/London",
"utc": "1",
"latitude": "51.469603",
"longitude": "-0.453566",
"active": "1",
"avg_weekly_flights": "1587",
"major_airport": 1,
"address": "Longford TW6, UK",
"phone_local": "0844 335 1801",
"phone_intl": "+44 844 335 1801",
"website": "https:\/\/www.heathrow.com",
"sub_type": null
}
]Risposta JSON completa. Scorri all’interno del riquadro per vedere tutti i campi. Più sotto trovi esempi estesi in JSON e XML.
Indica almeno uno tra iata, icao, city_code, country_code, name o dump=1. Con dump=1 gli altri parametri di ricerca vengono ignorati; i filtri di copertura restano comunque attivi.
| Parametro | Obbligatorio | Valore | Tipo | Predefinito | Descrizione |
|---|---|---|---|---|---|
| apikey | Sì | Qualsiasi | String | Nessuno | La tua chiave API. Richiedi una chiave API di prova gratuita. |
| iata | Condizionale | AAA-ZZZ | String | Nessuno | Codice IATA dell’aeroporto a tre lettere |
| icao | Condizionale | AAAA-ZZZZ | String | Nessuno | Codice ICAO dell’aeroporto a quattro lettere |
| city_code | Condizionale | AAA-ZZZ | String | Nessuno | Codice IATA di città a tre lettere |
| country_code | Condizionale | AA-ZZ | String | Nessuno | Codice paese ISO 3166-1 alfa-2 a due lettere |
| name | Condizionale | Qualsiasi | String | Nessuno | Nome dell’aeroporto o parte del nome per la corrispondenza parziale |
| dump | Condizionale | 0 o 1 | Integer | 0 | Imposta 1 per esportare l’intero database (ignora gli altri parametri condizionali indicati sopra) |
| show_disabled | No | 0 o 1 | Integer | 0 | Imposta 1 per includere nella risposta anche gli aeroporti inattivi o disattivati. Per impostazione predefinita vengono restituiti solo gli aeroporti attivi. |
| response_type | No | JSON, XML o CSV | String | JSON | Formato della risposta: JSON, XML o CSV (con CSV parte il download di un file) |
| major_only | No | 0 o 1 | Integer | 0 | Imposta 1 per includere solo gli aeroporti con voli commerciali (esclude basi per idrovolanti, eliporti, basi militari ecc.) |
Ottieni identità degli aeroporti, dati di posizione, stato operativo e dati di contatto. I campi con link rimandano a guide mirate con esempi e consigli di integrazione.
| Campo | Esempio | Descrizione |
|---|---|---|
| airhex_id | 53779 | Identificatore univoco e permanente del record |
| updated | 2025-09-03 13:16:53 | Data e ora dell’ultimo aggiornamento del record |
| iata | LHR | Codice IATA dell’aeroporto a tre lettere |
| icao | EGLL | Codice ICAO dell’aeroporto a quattro lettere |
| name | London Heathrow Airport | Nome dell’aeroporto |
| city_code | LON | Codice IATA di città a tre lettere della località dell’aeroporto |
| country_code | GB | Codice paese ISO 3166-1 alfa-2 della località dell’aeroporto |
| timezone | Europe/London | Identificatore del fuso orario dell’aeroporto |
| utc | 1 | Scostamento orario dell’aeroporto rispetto a UTC |
| latitude | 51.469603 | Latitudine geografica dell’aeroporto |
| longitude | -0.453566 | Longitudine geografica dell’aeroporto |
| major_airport | 1 |
Indica se l’aeroporto ha voli commerciali di linea: 1 – aeroporto con voli di linea 0 – aeroporto senza voli di linea o altri tipi di località (stazioni ferroviarie e degli autobus, eliporti ecc.) |
| sub_type | Sottotipo di struttura (se non è un aeroporto), ad esempio Rail, Bus/Limo, Ferry/Port o Border/Customs | |
| active | 1 | Stato operativo: 1 attivo; 0 inattivo |
| avg_weekly_flights | 1587 | Numero medio settimanale di voli di linea |
| address | Longford TW6, UK | Indirizzo fisico dell’aeroporto |
| phone_local | 0844 335 1801 | Numero di telefono locale dell’aeroporto |
| phone_intl | +44 844 335 1801 | Numero di telefono internazionale dell’aeroporto, con prefisso del paese |
| website | https://www.heathrow.com | URL del sito web ufficiale dell’aeroporto |
Gli esempi mostrano il record completo dell’aeroporto di Londra Heathrow in JSON e XML. Scegli il formato di output con response_type.
[
{
"airhex_id": "53779",
"updated": "2025-09-03 13:16:53",
"iata": "LHR",
"icao": "EGLL",
"name": "London Heathrow Airport",
"city_code": "LON",
"country_code": "GB",
"timezone": "Europe\/London",
"utc": "1",
"latitude": "51.469603",
"longitude": "-0.453566",
"active": "1",
"avg_weekly_flights": "1587",
"major_airport": 1,
"address": "Longford TW6, UK",
"phone_local": "0844 335 1801",
"phone_intl": "+44 844 335 1801",
"website": "https:\/\/www.heathrow.com",
"sub_type": null
}
]<?xml version="1.0" encoding="UTF-8"?>
<airports>
<airport>
<airhex_id>53779</airhex_id>
<updated>2025-09-03 13:16:53</updated>
<iata>LHR</iata>
<icao>EGLL</icao>
<name>London Heathrow Airport</name>
<city_code>LON</city_code>
<country_code>GB</country_code>
<timezone>Europe/London</timezone>
<utc>1</utc>
<latitude>51.469603</latitude>
<longitude>-0.453566</longitude>
<active>1</active>
<avg_weekly_flights>1587</avg_weekly_flights>
<major_airport>1</major_airport>
<address>Longford TW6, UK</address>
<phone_local>0844 335 1801</phone_local>
<phone_intl>+44 844 335 1801</phone_intl>
<website>https://www.heathrow.com</website>
<sub_type></sub_type>
</airport>
</airports>
Esporta gli aeroporti attivi con voli commerciali per il tuo indice di ricerca locale. Conserva airhex_id e updated quando importi i record.
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.csvUsa il codice città per ottenere gli aeroporti associati, mantenendo codice e nome di ciascun aeroporto per proporli come scelte distinte.
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'Collega un identificativo aeronautico allo stesso record aeroportuale usato dai tuoi strumenti di prenotazione.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'icao=EGLL'Aiuta i viaggiatori a distinguere gli aeroporti grazie a nomi, codici, città e paesi.
Trasforma i codici aeroportuali del tuo fornitore in località di partenza e di arrivo chiare nei risultati, nelle conferme e negli itinerari.
Usa le coordinate per le mappe degli aeroporti e gli identificatori dei fusi orari per mostrare l’ora locale.
Sì. Scarica l’elenco degli aeroporti e crea un indice di ricerca locale a partire da nomi degli aeroporti, codici IATA e ICAO, associazioni con le città e paesi. La tua applicazione gestisce la corrispondenza e l’ordine dei suggerimenti. L’endpoint fornisce dati di riferimento e ricerche per nome, non un’interfaccia di autocompletamento già pronta.
Airhex raccoglie e verifica dati geografici da più fonti e li controlla ogni giorno. Aggiorna periodicamente il tuo elenco locale e conserva airhex_id e updated, così le modifiche possono essere applicate agli stessi record degli aeroporti.
Usa iata per un aeroporto specifico, come LHR, e city_code per gli aeroporti associati a una città, come LON. Una città può avere più aeroporti. Verifica quale tipo di località fornisce il tuo fornitore di prenotazioni.
Per impostazione predefinita vengono restituiti solo i record attivi, senza limitare i risultati agli aeroporti con voli commerciali. Usa major_only=1 per applicare questa restrizione e show_disabled=1 per includere i record inattivi o disattivati. Controlla active, major_airport e sub_type prima di proporre i record in un selettore di prenotazione.
Sì, con una licenza GEO Essentials adeguata. Esporta con dump=1 in JSON, XML o CSV. Conserva airhex_id e updated e aggiorna periodicamente il tuo elenco locale.
Usa timezone insieme al timestamp effettivo del viaggio e a una libreria che tenga conto delle date. Il campo utc è uno scostamento memorizzato nel record: non descrive le regole dell’ora legale valide per ogni data.
Le coordinate descrivono la posizione dell’aeroporto. Non usarle come coordinate di terminal, gate o punto di ritiro. Per le indicazioni sui trasferimenti a terra usa dati di posizione e di percorso più precisi.
No. Fornisce dati di riferimento sugli aeroporti. Per orari, disponibilità, tariffe e stato dei voli in tempo reale rivolgiti al tuo fornitore di voli.
Per i dettagli di implementazione consulta le guide all’API fuso orario degli aeroporti e all’API coordinate degli aeroporti.
Porta nel tuo processo di prenotazione scelte di aeroporto chiare, dati di posizione e ora locale, mentre Airhex mantiene i dati di riferimento degli aeroporti.