Paramètres de la requête
Utilisez ces paramètres de requête pour rechercher un aéroport précis, trouver des aéroports par localisation ou exporter le répertoire.
| Paramètre | Obligatoire | Par défaut | Description |
|---|
apikey |
Oui | Aucun | Votre clé d'API. Obtenir une clé d'API de test gratuite. |
|---|
iata |
Conditionnel | Aucun | Code IATA d'aéroport à trois lettres, par exemple LHR. |
|---|
icao |
Conditionnel | Aucun | Code OACI d'aéroport à quatre lettres, par exemple EGLL. |
|---|
city_code |
Conditionnel | Aucun | Code IATA à trois lettres de la ville, par exemple LON, pour trouver les aéroports d'une ville. |
|---|
country_code |
Conditionnel | Aucun | Code pays ISO à deux lettres, par exemple GB, pour trouver les aéroports d'un pays. |
|---|
name |
Conditionnel | Aucun | Nom de l'aéroport ou partie du nom, par exemple Heathrow. |
|---|
dump |
Conditionnel | 0 | Avec 1, exporte la base de données. Prévaut sur les autres paramètres de recherche ; les filtres de périmètre continuent de s'appliquer. |
|---|
show_disabled |
Non | 0 | Avec 1, les enregistrements inactifs ou désactivés sont aussi renvoyés. Par défaut, seuls les enregistrements actifs sont renvoyés. |
|---|
response_type |
Non | JSON | Format de la réponse : JSON, XML ou CSV. CSV lance le téléchargement d'un fichier. |
|---|
major_only |
Non | 0 | Avec 1, seuls les aéroports avec vols commerciaux sont renvoyés. |
|---|
Indiquez au moins l'un des paramètres iata, icao, city_code, country_code, name ou dump=1. Avec dump=1, les autres paramètres de recherche sont ignorés.
Voir tous les paramètres de la requête →
Tâches d'intégration courantes
Télécharger les fuseaux horaires des aéroports pour vos itinéraires
Exportez en CSV les aéroports actifs avec vols commerciaux et conservez timezone avec airhex_id et les codes d'aéroports. Votre application pourra alors résoudre le fuseau horaire de chaque tronçon du voyage à partir d'un répertoire local.
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
Obtenir le fuseau horaire avec un code OACI
Utilisez icao lorsque votre source identifie les aéroports par des codes à quatre lettres. Avec cette requête, EGLL renvoie le même enregistrement de Heathrow et le même fuseau horaire que la recherche IATA avec LHR.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'icao=EGLL'
Afficher un horodatage UTC reçu à l'heure locale de l'aéroport
Après la requête, passez timezone avec un horodatage non ambigu de votre fournisseur de vols à la fonction de mise en forme de date et d'heure de votre application. L'exemple JavaScript utilise Europe/London tiré de la réponse. L'horodatage est donné à titre d'illustration ; l'API aéroports ne renvoie pas d'horaires de vols.
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
Questions fréquentes
Quelle différence entre timezone et utc ?
timezone indique un fuseau nommé, comme Europe/London. utc renvoie un décalage de l'enregistrement de l'aéroport. Un décalage seul ne dit rien des règles de l'heure d'été ni des changements au cours de l'année. Pour la conversion, utilisez le fuseau nommé avec l'horodatage réel du voyage.
Comment traiter l'heure d'été ?
Utilisez timezone avec une bibliothèque qui tient compte des dates et applique les règles de fuseau horaire en vigueur. La bibliothèque détermine le décalage de la date à convertir. N'appliquez pas le décalage UTC de l'exemple à tous les vols et tenez à jour les données de fuseaux horaires de votre application, car les règles peuvent changer.
L'API convertit-elle pour moi les horaires des vols ?
Non. Elle fournit des données de référence sur les aéroports, dont les identifiants de fuseau horaire. La conversion est faite par votre application à partir des horodatages de votre fournisseur de vols. Cet endpoint n'a ni paramètre de date de voyage ni paramètre de conversion horaire.
Et si mon fournisseur envoie déjà des heures locales ?
Vérifiez le format d'horodatage du fournisseur avant de convertir. N'interprétez pas une heure locale comme de l'UTC et ne convertissez pas deux fois. La date et l'heure locales sans décalage peuvent être ambiguës autour des changements d'heure d'été ; si possible, utilisez un horodatage du fournisseur avec décalage explicite ou en UTC.
Comment traiter un départ et une arrivée dans des fuseaux horaires différents ?
Résolvez chaque aéroport séparément et mettez en forme chaque horodatage avec la valeur de timezone de cet aéroport. Affichez la date locale si le voyage passe minuit. Calculez la durée du voyage avec des horodatages non ambigus, et non en soustrayant les heures locales affichées.
Puis-je supposer que tous les aéroports d'un pays ont le même fuseau horaire ?
Non. Récupérez le fuseau horaire de chaque enregistrement d'aéroport plutôt que de le déduire du pays. Si vous cherchez avec city_code ou country_code, lisez timezone dans chaque aéroport renvoyé.
Puis-je stocker les fuseaux horaires des aéroports dans ma propre base de données ?
Oui, avec une licence adaptée de GEO Essentials. Exportez avec dump=1 et choisissez JSON, XML ou CSV avec response_type. Conservez airhex_id et updated de la réponse complète, mettez régulièrement à jour vos rapprochements d'aéroports et tenez à jour les règles de fuseau horaire dans le logiciel qui effectue les conversions.
Que faire si un fuseau horaire est absent ou non pris en charge ?
Vérifiez la valeur de timezone renvoyée avant de la passer à votre fonction de mise en forme. Conservez l'horodatage d'origine et, s'il existe, le décalage du fournisseur, et signalez les rapprochements non résolus pour examen. N'utilisez pas à la place, sans le signaler, le fuseau horaire de l'appareil de l'utilisateur ni un décalage estimé pour tout le pays.