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 codes pour votre sélecteur d'aéroports
Exportez en CSV les aéroports actifs avec vols commerciaux et constituez votre index de recherche local avec les codes, les noms et les identifiants de localisation. Utilisez major_only=0 si votre produit a aussi besoin d'autres types de lieux. Vérifiez que iata est renseigné avant de créer une recherche fondée sur les codes.
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.csv
Trouver les codes d'aéroport d'une ville
Avec city_code=LON, vous obtenez les aéroports de Londres. Conservez le code IATA et le nom de chaque aéroport pour que les voyageurs distinguent les aéroports de départ et d'arrivée au sein d'une même ville.
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'
Trouver le code IATA par nom d'aéroport
Cherchez avec name et lisez iata dans les enregistrements renvoyés. Les noms partiels peuvent correspondre à plusieurs enregistrements : comparez les noms des aéroports et les champs de localisation avant de choisir un résultat.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'name=Heathrow'
Rapprocher un code OACI d'aéroport d'un code IATA
Envoyez le code OACI à quatre lettres dans icao et lisez le champ iata de la réponse pour relier les données aéronautiques aux identifiants d'aéroports de votre fournisseur de réservations.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'icao=EGLL'
Questions fréquentes
Quelle différence entre les codes IATA d'aéroport et les codes de ville ?
Un code d'aéroport identifie un aéroport précis, par exemple LHR pour Londres Heathrow. Un code de ville regroupe une destination, par exemple LON pour Londres. Utilisez iata pour interroger un aéroport et city_code pour trouver les aéroports d'une ville. Gardez les deux champs séparés lorsque vous traitez l'option de destination « tous les aéroports » d'un fournisseur.
Puis-je résoudre les codes de départ et d'arrivée de mon fournisseur de réservations ?
Oui, si les valeurs reçues sont des codes IATA d'aéroport. Interrogez chaque code avec iata pour obtenir le nom et la localisation de l'aéroport. Vérifiez si le champ de votre fournisseur désigne un aéroport ou une ville avant de choisir le paramètre de requête. Utilisez le code d'origine du fournisseur comme solution de repli si aucun résultat ne peut être résolu.
Chaque enregistrement renvoyé correspond-il à un aéroport avec vols commerciaux ?
Non. Le jeu de données élargi peut inclure d'autres types de lieux, comme des gares ferroviaires, des gares routières et des héliports. Définissez major_only=1 pour les aéroports avec vols commerciaux. La réponse complète inclut major_airport et sub_type pour que votre application puisse distinguer les enregistrements. Vérifiez que iata est renseigné avant de créer un rapprochement fondé sur les codes.
Les aéroports inactifs sont-ils inclus ?
Par défaut, seuls les enregistrements actifs sont renvoyés. Définissez show_disabled=1 si vous avez besoin d'enregistrements inactifs pour des itinéraires ou des rapports historiques, et examinez active avant de proposer un aéroport dans un sélecteur de réservation.
Puis-je télécharger et stocker un répertoire de codes d'aéroports ?
Oui, avec une licence adaptée de GEO Essentials. Utilisez dump=1 et choisissez JSON, XML ou CSV avec response_type. Définissez avec major_only et show_disabled la couverture dont votre produit a besoin. Avec un répertoire local, vous résolvez les codes et construisez la recherche d'aéroports sans interroger chaque aéroport séparément.
Dois-je utiliser le code IATA comme clé permanente de la base de données ?
Conservez airhex_id comme identifiant permanent de l'enregistrement et utilisez iata comme valeur de recherche. Lors de l'import, stockez updated de la réponse complète et planifiez des mises à jour régulières de votre répertoire local. Vous conservez ainsi aussi les enregistrements sans code IATA.
Puis-je interroger un aéroport par son code OACI ?
Oui. Envoyez un code OACI d'aéroport à quatre lettres, par exemple EGLL, dans icao et lisez iata dans la réponse. Les codes OACI d'aéroports ne doivent pas être confondus avec les codes OACI à trois lettres des compagnies de l'API compagnies aériennes.
L'API renvoie-t-elle des vols, des prix ou des départs en temps réel d'un aéroport ?
Non. Cet endpoint fournit des données de référence sur les aéroports. Les horaires, la disponibilité, les prix et les informations de vols en temps réel viennent de votre fournisseur de vols. Un enregistrement d'aéroport actif ou un indicateur de vols commerciaux ne signifie pas qu'une ligne donnée est réservable.