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 le répertoire des codes OACI d'aéroports
Exportez en CSV le répertoire des aéroports actifs et constituez un index local avec les enregistrements dont le champ icao est renseigné. Conservez iata, s'il existe, pour rapprocher des données de réservation. Ajoutez major_only=1 si votre produit n'a besoin que des aéroports avec vols commerciaux.
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
Trouver le code OACI à partir d'un code IATA
Envoyez LHR dans iata et lisez icao dans la réponse. Votre application rapproche ainsi l'identifiant d'aéroport d'un fournisseur de réservations d'une source qui utilise des codes OACI, avec les deux codes du même enregistrement d'aéroport.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'iata=LHR'
Trouver le code OACI par nom d'aéroport
Cherchez avec name et examinez le champ icao renvoyé. Les noms partiels peuvent donner plusieurs résultats : comparez le nom de l'aéroport, le pays et d'autres identifiants avant de choisir un enregistrement.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'name=Heathrow'
Questions fréquentes
Quelle différence entre les codes OACI et IATA des aéroports ?
Les codes OACI des aéroports comptent quatre lettres, par exemple EGLL pour Londres Heathrow. Les codes IATA des aéroports comptent trois lettres, par exemple LHR. Utilisez icao ou iata selon le système de codes de votre source ; la réponse contient les deux champs lorsqu'ils existent.
Puis-je rapprocher des codes OACI d'aéroports de codes IATA ?
Oui. Interrogez l'aéroport avec icao et lisez le champ iata renvoyé. Dans l'autre sens, interrogez un code IATA avec iata et lisez icao. Avant de les rapprocher, vérifiez que le champ cible est renseigné ; tous les enregistrements n'ont pas les deux identifiants.
Puis-je utiliser un code de ville comme code OACI d'aéroport ?
Non. Un code de ville comme LON est un identifiant de destination à part. Utilisez city_code pour trouver les aéroports d'une ville, puis la valeur icao de chaque aéroport. Une ville peut être desservie par plusieurs aéroports.
Quels aéroports sont inclus par défaut ?
Par défaut, la requête renvoie les enregistrements actifs et ne limite pas les résultats aux aéroports avec vols commerciaux. Cette limitation s'obtient avec major_only=1. Le jeu de données élargi peut inclure d'autres types de lieux ; examinez icao avant d'inclure des enregistrements dans votre table de correspondance OACI et distinguez les installations avec major_airport et sub_type de la réponse complète.
Puis-je inclure les aéroports inactifs pour des enregistrements historiques ?
Définissez show_disabled=1 pour inclure les enregistrements inactifs ou désactivés et examinez active dans la réponse. Conservez ce statut lors de la résolution de données historiques pour qu'une ancienne référence à un aéroport ne soit pas proposée automatiquement comme destination de réservation active.
Puis-je stocker en local le répertoire des codes OACI d'aéroports ?
Oui, avec une licence adaptée de GEO Essentials. Exportez avec dump=1 en JSON, XML ou CSV et choisissez la couverture avec major_only et show_disabled. Indexez les valeurs de icao renseignées pour les recherches locales et conservez airhex_id comme identifiant permanent de l'enregistrement.
Comment tenir les rapprochements à jour et traiter les résultats absents ?
Conservez airhex_id et updated de la réponse complète et mettez régulièrement à jour votre répertoire local. Vérifiez que les champs de code sont renseignés avant de créer des rapprochements. Si un code de votre source ne peut pas être résolu, stockez la valeur d'origine pour examen plutôt que de deviner un résultat d'après le nom d'un aéroport semblable.
La recherche OACI renvoie-t-elle des données en temps réel sur l'aéroport ou les opérations aériennes ?
Non. Cet endpoint fournit des données de référence sur les aéroports pour identifier et rapprocher des lieux. Le statut actuel des vols, la disponibilité des pistes et les avis opérationnels viennent d'un fournisseur de données opérationnelles adapté. Le champ active décrit le statut opérationnel de l'enregistrement de l'aéroport, et non les opérations en cours.