API aéroports : base de données des aéroports et codes

Aidez les voyageurs à identifier le bon aéroport et à comprendre où leur voyage commence et où il se termine. Consultez les codes, noms, emplacements et fuseaux horaires des aéroports, ou téléchargez le répertoire pour vos propres outils de recherche et de réservation.

Clé d'API de testVoir l'exemple
  • Recherche par code IATA et OACI
  • Coordonnées et fuseaux horaires
  • JSON, XML et CSV

Rechercher un aéroport par son code

Envoyez iata=LHR pour obtenir l'aéroport de Londres Heathrow et ses données de référence. Remplacez YOUR_API_KEY par votre clé d'API.

Description de l'endpoint

Cet endpoint renvoie les données géographiques d'un aéroport donné ou exporte toute la base de données des aéroports. La réponse est fournie en JSON, XML ou CSV.

Endpoint
GET https://content.airhex.com/api/v3.7.10/airports/

Requête · cURL

curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'iata=LHR'

Réponse · JSON

[
    {
        "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
    }
]

Réponse JSON complète. Faites défiler le cadre pour voir tous les champs. Des exemples détaillés en JSON et en XML figurent plus bas.

Paramètres de la requête

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 ; les filtres de périmètre continuent de s'appliquer.

Paramètre Obligatoire Valeur Type Par défaut Description
apikey Oui Tous String aucun Votre clé d'API. Obtenir une clé d'API de test gratuite.
iata Conditionnel AAA-ZZZ String aucun Code IATA à trois lettres de l'aéroport
icao Conditionnel AAAA-ZZZZ String aucun Code OACI à quatre lettres de l'aéroport
city_code Conditionnel AAA-ZZZ String aucun Code IATA à trois lettres de la ville
country_code Conditionnel AA-ZZ String aucun Code pays à deux lettres selon ISO 3166-1 alpha-2
name Conditionnel Tous String aucun Nom de l'aéroport ou partie du nom pour une correspondance partielle
dump Conditionnel 0 ou 1 Integer 0 Indiquez 1 pour exporter toute la base de données (ignore les autres paramètres conditionnels ci-dessus)
show_disabled Non 0 ou 1 Integer 0 Indiquez 1 pour inclure aussi les aéroports inactifs ou désactivés. Par défaut, seuls les aéroports actifs sont renvoyés.
response_type Non JSON, XML ou CSV String JSON Format de la réponse : JSON, XML ou CSV (CSV lance le téléchargement d'un fichier)
major_only Non 0 ou 1 Integer 0 Indiquez 1 pour ne retenir que les aéroports avec vols commerciaux (exclut les bases d'hydravions, héliports, bases militaires, etc.)

Champs de la réponse

Obtenez les identifiants, les données de localisation, le statut opérationnel et les coordonnées de contact des aéroports. Les champs avec lien mènent à des guides avec des exemples et des conseils d'intégration.

Champ Exemple Description
airhex_id 53779 Identifiant unique et permanent de l'enregistrement
updated 2025-09-03 13:16:53 Date et heure de la dernière mise à jour de l'enregistrement
iata LHR Code IATA à trois lettres de l'aéroport
icao EGLL Code OACI à quatre lettres de l'aéroport
name London Heathrow Airport Nom de l'aéroport
city_code LON Code IATA à trois lettres de la ville de l'aéroport
country_code GB Code pays ISO 3166-1 alpha-2 de l'aéroport
timezone Europe/London Identifiant de fuseau horaire de l'aéroport
utc 1 Décalage horaire de l'aéroport par rapport à UTC
latitude 51.469603 Latitude géographique de l'aéroport
longitude -0.453566 Longitude géographique de l'aéroport
major_airport 1 Indique si l'aéroport a des vols commerciaux réguliers :
1 – aéroport avec vols réguliers
0 – aéroport sans vols réguliers ou autres types de lieux (gares ferroviaires, gares routières, héliports, etc.)
sub_type Sous-type d'installation (s'il ne s'agit pas d'un aéroport), par ex. Rail, Bus/Limo, Ferry/Port ou Border/Customs
active 1 Statut opérationnel : 1 = actif ; 0 = inactif
avg_weekly_flights 1587 Moyenne hebdomadaire de vols réguliers
address Longford TW6, UK Adresse de l'aéroport
phone_local 0844 335 1801 Téléphone local de l'aéroport
phone_intl +44 844 335 1801 Téléphone international de l'aéroport, avec indicatif du pays
website https://www.heathrow.com URL du site web officiel de l'aéroport

Exemples de réponse complets

Ces exemples montrent l'enregistrement complet de l'aéroport de Londres Heathrow en JSON et en XML. Choisissez le format de sortie avec response_type.

Réponse · JSON

[
    {
        "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
    }
]

Réponse · XML

<?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>

Tâches d'intégration courantes

Télécharger le répertoire des aéroports

Exportez les aéroports actifs avec vols commerciaux pour votre index de recherche local. Conservez airhex_id et updated lors de l'import des enregistrements.

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 aéroports d'une ville

Utilisez le code de ville pour obtenir les aéroports associés et conservez le code et le nom de chaque aéroport pour les sélections individuelles.

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'

Rechercher un aéroport par son code OACI

Rattachez un identifiant aéronautique au même enregistrement d'aéroport que celui de vos outils de réservation.

curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
  --data-urlencode 'apikey=YOUR_API_KEY' \
  --data-urlencode 'icao=EGLL'

Ce que vous pouvez créer

Créer une recherche d'aéroports plus claire

Aidez les voyageurs à distinguer les aéroports par nom, code, ville et pays.

Rendre les données de vol compréhensibles

Transformez les codes d'aéroport de votre fournisseur en lieux de départ et d'arrivée clairs dans les résultats, les confirmations et les itinéraires.

Ajouter la localisation et l'heure locale

Utilisez les coordonnées pour les cartes d'aéroports et les identifiants de fuseau horaire pour afficher l'heure locale.

Questions fréquentes

Puis-je utiliser ces données pour la saisie semi-automatique des aéroports ?

Oui. Téléchargez le répertoire des aéroports et constituez-en un index de recherche local avec les noms d'aéroports, les codes IATA et OACI, et les rattachements aux villes et aux pays. Votre application gère la correspondance et l'ordre des suggestions. L'endpoint fournit des données de référence et des recherches par nom, pas une interface de suggestions prête à l'emploi.

Comment les données des aéroports sont-elles tenues à jour ?

Airhex regroupe des données géographiques issues de plusieurs sources, les vérifie et les contrôle chaque jour. Mettez régulièrement à jour votre répertoire local et conservez airhex_id et updated afin que les changements soient rattachés aux mêmes enregistrements d'aéroports.

Quelle est la différence entre codes de ville et codes d'aéroport ?

Utilisez iata pour un aéroport précis, comme LHR, et city_code pour les aéroports d'une ville, comme LON. Une ville peut compter plusieurs aéroports. Vérifiez quel type de lieu votre fournisseur de réservations transmet.

Quels aéroports sont inclus, et puis-je obtenir les enregistrements inactifs ?

Par défaut, seuls les enregistrements actifs sont renvoyés, sans se limiter aux aéroports avec vols commerciaux. Utilisez major_only=1 pour appliquer cette restriction, et show_disabled=1 pour obtenir aussi les enregistrements inactifs ou désactivés. Examinez active, major_airport et sub_type avant de proposer des enregistrements dans un sélecteur de réservation.

Puis-je stocker le répertoire des aéroports en local ?

Oui, avec une licence adaptée de GEO Essentials. Exportez avec dump=1 en JSON, XML ou CSV. Conservez airhex_id et updated, et mettez régulièrement à jour votre répertoire local.

Puis-je utiliser le décalage UTC pour n'importe quelle date de voyage ?

Utilisez timezone avec l'horodatage réel du voyage et une bibliothèque qui tient compte des dates. Le champ utc est un décalage figurant dans l'enregistrement ; il ne reflète pas les règles d'heure d'été propres à chaque date.

Les coordonnées correspondent-elles à la position du terminal ou du point de prise en charge ?

Les coordonnées décrivent l'emplacement de l'aéroport. Ne les utilisez pas comme coordonnées du terminal, de la porte d'embarquement ou du point de prise en charge. Pour les transferts terrestres, utilisez des données de localisation et d'itinéraire plus précises.

Cet endpoint renvoie-t-il des vols en temps réel ou des prix ?

Non. Il fournit des données de référence sur les aéroports. Les horaires, la disponibilité, les prix et le statut actuel des vols viennent de votre fournisseur de vols.

Pour les détails d'intégration, consultez les guides de l'API fuseaux horaires des aéroports et de l'API coordonnées des aéroports.

Aidez les voyageurs à trouver et à reconnaître le bon aéroport

Intégrez à votre parcours de réservation des choix d'aéroports clairs, des données de localisation et l'heure locale, pendant qu'Airhex tient à jour les données de référence des aéroports.

Clé d'API de testDemander un devis →