API de aeropuertos: base de datos de aeropuertos y códigos
Ayude a los viajeros a identificar el aeropuerto correcto y a entender dónde empieza y dónde termina su viaje. Consulte códigos de aeropuertos, nombres, ubicaciones y zonas horarias, o descargue el directorio para sus propias herramientas de búsqueda y reserva.
Envíe iata=LHR para obtener el aeropuerto de Londres Heathrow y sus datos de referencia. Sustituya YOUR_API_KEY por su clave de API.
Descripción del endpoint
Este endpoint devuelve datos geográficos de un aeropuerto concreto o exporta toda la base de datos de aeropuertos. La respuesta llega en JSON, XML o CSV.
Endpoint GET https://content.airhex.com/api/v3.7.10/airports/
Respuesta JSON completa. Desplácese dentro del recuadro para ver todos los campos. Más abajo encontrará ejemplos ampliados en JSON y XML.
Parámetros de la solicitud
Indique al menos uno de los parámetros iata, icao, city_code, country_code, name o dump=1. Con dump=1 se ignoran los demás parámetros de consulta; los filtros de alcance siguen aplicándose.
Código de país de dos letras según ISO 3166-1 alfa-2
name
Condicional
Cualquiera
String
ninguno
Nombre del aeropuerto o parte del nombre para una coincidencia parcial
dump
Condicional
0 o 1
Integer
0
Indique 1 para exportar toda la base de datos (ignora los demás parámetros condicionales de arriba)
show_disabled
No
0 o 1
Integer
0
Indique 1 para incluir también los aeropuertos inactivos o desactivados. De forma predeterminada solo se devuelven los aeropuertos activos.
response_type
No
JSON, XML o CSV
String
JSON
Formato de respuesta: JSON, XML o CSV (CSV inicia la descarga de un archivo)
major_only
No
0 o 1
Integer
0
Indique 1 para incluir solo aeropuertos con vuelos comerciales (excluye bases de hidroaviones, helipuertos, bases militares, etc.)
Campos de la respuesta
Obtenga identificadores, datos de ubicación, estado operativo y datos de contacto de aeropuertos. Los campos con enlace llevan a guías con ejemplos y consejos de integración.
Campo
Ejemplo
Descripción
airhex_id
53779
Identificador único y permanente del registro
updated
2025-09-03 13:16:53
Fecha y hora de la última actualización del registro
Indica si el aeropuerto tiene vuelos comerciales regulares: 1 – aeropuerto con vuelos regulares 0 – aeropuerto sin vuelos regulares u otros tipos de ubicación (estaciones de tren, estaciones de autobús, helipuertos, etc.)
sub_type
Subtipo de instalación (si no es un aeropuerto), p. ej., Rail, Bus/Limo, Ferry/Port o Border/Customs
active
1
Estado operativo: 1 activo; 0 inactivo
avg_weekly_flights
1587
Promedio semanal de vuelos regulares
address
Longford TW6, UK
Dirección física del aeropuerto
phone_local
0844 335 1801
Teléfono local del aeropuerto
phone_intl
+44 844 335 1801
Teléfono internacional del aeropuerto, con prefijo de país
website
https://www.heathrow.com
URL del sitio web oficial del aeropuerto
Ejemplos de respuesta completos
Los ejemplos muestran el registro completo del aeropuerto de Londres Heathrow en JSON y XML. Elija el formato de salida con response_type.
Ayude a los viajeros a distinguir aeropuertos por nombre, código, ciudad y país.
Hacer comprensibles los datos de vuelo
Convierta los códigos de aeropuerto de su proveedor en lugares de salida y llegada claros en resultados, confirmaciones e itinerarios.
Añadir ubicación y hora local
Use las coordenadas para mapas de aeropuertos y los identificadores de zona horaria para mostrar la hora local.
Preguntas frecuentes
¿Puedo usar estos datos para el autocompletado de aeropuertos?
Sí. Descargue el directorio de aeropuertos y cree con él un índice de búsqueda local con nombres de aeropuertos, códigos IATA e ICAO, asociaciones con ciudades y países. Su aplicación controla la coincidencia y el orden de las sugerencias. El endpoint ofrece datos de referencia y consultas por nombre, no una interfaz de sugerencias ya hecha.
¿Cómo se mantienen actualizados los datos de aeropuertos?
Airhex combina datos geográficos de varias fuentes, los verifica y los revisa a diario. Actualice su directorio local de forma periódica y conserve airhex_id y updated para que los cambios se asocien a los mismos registros de aeropuertos.
¿En qué se diferencian los códigos de ciudad de los códigos de aeropuerto?
Use iata para un aeropuerto concreto, como LHR, y city_code para los aeropuertos de una ciudad, como LON. Una ciudad puede tener varios aeropuertos. Compruebe qué tipo de ubicación entrega su proveedor de reservas.
¿Qué aeropuertos se incluyen y puedo obtener registros inactivos?
De forma predeterminada solo se devuelven registros activos, sin limitarse a aeropuertos con vuelos comerciales. Para aplicar esa limitación use major_only=1, y con show_disabled=1 obtendrá también los registros inactivos o desactivados. Revise active, major_airport y sub_type antes de ofrecer registros en un selector de reservas.
¿Puedo guardar el directorio de aeropuertos en local?
Sí, con una licencia adecuada de GEO Essentials. Exporte con dump=1 en JSON, XML o CSV. Conserve airhex_id y updated y actualice su directorio local de forma periódica.
¿Puedo usar el desfase UTC para cualquier fecha de viaje?
Use timezone junto con la marca de tiempo real del viaje y una biblioteca que tenga en cuenta las fechas. El campo utc es un desfase guardado en el registro; no refleja las reglas del horario de verano de cada fecha.
¿Las coordenadas son la posición de la terminal o del punto de recogida?
Las coordenadas describen la ubicación del aeropuerto. No las use como coordenadas de la terminal, la puerta de embarque o el punto de recogida. Para indicaciones de traslados terrestres, use datos de ubicación y de rutas más precisos.
¿Este endpoint devuelve vuelos en tiempo real o tarifas?
No. Ofrece datos de referencia de aeropuertos. Los horarios, la disponibilidad, las tarifas y el estado actual de los vuelos los obtiene de su proveedor de vuelos.
Ayude a los viajeros a encontrar y reconocer el aeropuerto correcto
Lleve opciones de aeropuerto claras, datos de ubicación y la hora local a su proceso de reserva, mientras Airhex mantiene los datos de referencia de aeropuertos.
Consulte la latitud y la longitud de un aeropuerto por código IATA o ICAO, o exporte coordenadas para mapas y búsquedas por ubicación en su producto de viajes.
Consulte códigos IATA de aeropuertos, asocie códigos con nombres de aeropuertos, ciudades e identificadores ICAO o exporte un directorio de códigos de aeropuertos con Airhex.
Consulte los códigos ICAO de aeropuertos, asócielos con nombres de aeropuertos y códigos IATA o exporte un directorio para conectar datos de aviación y de viajes con Airhex.
Consulte la zona horaria de un aeropuerto por código IATA o ICAO y obtenga su identificador y su desfase UTC para mostrar la hora local en su producto.