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 coordonnées pour votre carte d'aéroports
Exportez en CSV les aéroports actifs avec vols commerciaux. Conservez latitude, longitude, codes et noms pour créer des repères de carte à partir d'un répertoire local. Utilisez major_only=0 si votre produit a aussi besoin d'autres types de lieux.
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-coordinates.csv
Trouver les coordonnées des aéroports d'une ville
Avec city_code=LON, vous obtenez les aéroports de Londres. Lisez latitude et longitude dans chaque enregistrement pour afficher l'emplacement de chaque aéroport, plutôt que de placer tous les aéroports au centre de la 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'
Obtenir les coordonnées avec un code OACI
Utilisez icao lorsque votre source de données identifie les aéroports par des codes à quatre lettres. EGLL mène au même enregistrement de Heathrow 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'
Questions fréquentes
Sous quel format les coordonnées sont-elles renvoyées ?
latitude et longitude sont des champs distincts, avec des valeurs en degrés décimaux. Dans l'exemple JSON, ce sont des chaînes numériques. Convertissez-les en nombres si votre bibliothèque cartographique attend des valeurs numériques, et conservez les signes négatifs et la précision décimale disponible.
Quelle coordonnée passer en premier à ma bibliothèque cartographique ?
Vérifiez l'ordre attendu par la bibliothèque. Certaines interfaces attendent d'abord la latitude, puis la longitude ; d'autres l'inverse. L'API renvoie des champs nommés : vous pouvez donc affecter explicitement chaque valeur plutôt que de dépendre de l'ordre d'un tableau.
Cet endpoint trouve-t-il l'aéroport le plus proche ?
Non. Il interroge les aéroports par les identifiants documentés, par le nom ou par des filtres de localisation, ou exporte le répertoire. Pour trouver des aéroports proches, stockez les coordonnées et effectuez une recherche de distance ou spatiale dans votre application. Cet endpoint n'a ni paramètre de rayon ni paramètre d'aéroport le plus proche.
Puis-je estimer avec les coordonnées le temps de trajet jusqu'à un hôtel ?
Les coordonnées peuvent servir de données d'entrée pour votre service de cartes ou d'itinéraires. Une distance à vol d'oiseau n'est ni une distance routière ni un temps de trajet. Pour estimer un transfert, utilisez un fournisseur d'itinéraires adapté et le point de prise en charge ou de destination correspondant.
Les coordonnées indiquent-elles un terminal, une porte d'embarquement ou un point de prise en charge ?
Ces champs décrivent l'emplacement de l'aéroport. Ne les traitez pas comme des coordonnées du terminal, de la porte d'embarquement, de la piste ni du point de prise en charge des passagers. Utilisez des données de localisation plus précises si votre produit a besoin de guidage dans l'aéroport ou de points de rendez-vous pour les transferts.
Comment limiter ma carte aux aéroports avec vols commerciaux ?
Définissez major_only=1. Par défaut, seuls les enregistrements actifs sont renvoyés ; avec show_disabled=1, vous obtenez aussi, si nécessaire, les enregistrements inactifs ou désactivés. La réponse complète inclut major_airport, sub_type et active pour que votre application puisse distinguer les enregistrements avant de les afficher.
Que faire si une coordonnée est absente ou invalide ?
Vérifiez les deux champs avant de créer un repère. Écartez les valeurs absentes, vides ou non numériques et vérifiez que la latitude est comprise entre -90 et 90 et la longitude entre -180 et 180. Ne transformez pas un champ vide en zéro ; zéro peut lui-même être une coordonnée valide. Conservez pour examen les enregistrements non résolus plutôt que de les placer à un emplacement estimé.
Puis-je tenir un répertoire de coordonnées d'aéroports dans ma propre base de données ?
Oui, avec une licence adaptée de GEO Essentials. Utilisez dump=1 et choisissez JSON, XML ou CSV avec response_type. Conservez airhex_id et updated de la réponse complète et mettez régulièrement à jour vos enregistrements locaux pour détecter les changements de code, de nom et de coordonnées d'un même aéroport.