Parámetros de la solicitud
Use estos parámetros de consulta para buscar un aeropuerto concreto, encontrar aeropuertos por ubicación o exportar el directorio.
| Parámetro | Obligatorio | Predeterminado | Descripción |
|---|
apikey |
Sí | Ninguno | Su clave de API asignada. Solicitar una clave de prueba de API gratuita. |
|---|
iata |
Condicional | Ninguno | Código IATA de aeropuerto de tres letras, por ejemplo LHR. |
|---|
icao |
Condicional | Ninguno | Código ICAO de aeropuerto de cuatro letras, por ejemplo EGLL. |
|---|
city_code |
Condicional | Ninguno | Código IATA de ciudad de tres letras, por ejemplo LON, para encontrar los aeropuertos de una ciudad. |
|---|
country_code |
Condicional | Ninguno | Código de país ISO de dos letras, por ejemplo GB, para encontrar los aeropuertos de un país. |
|---|
name |
Condicional | Ninguno | Nombre del aeropuerto o parte del nombre, por ejemplo Heathrow. |
|---|
dump |
Condicional | 0 | Con 1 exporta la base de datos. Prevalece sobre los demás parámetros de consulta; los filtros de cobertura siguen aplicándose. |
|---|
show_disabled |
No | 0 | Con 1 se devuelven también los registros inactivos o desactivados. De forma predeterminada solo se devuelven los registros activos. |
|---|
response_type |
No | JSON | Formato de respuesta: JSON, XML o CSV. CSV inicia la descarga de un archivo. |
|---|
major_only |
No | 0 | Con 1 devuelve solo aeropuertos con vuelos comerciales. |
|---|
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.
Ver todos los parámetros de la solicitud →
Tareas habituales de implementación
Descargar los códigos para su selector de aeropuertos
Exporte como CSV los aeropuertos activos con vuelos comerciales y cree su índice de búsqueda local con códigos, nombres e identificadores de ubicación. Use major_only=0 si su producto necesita también otros tipos de ubicación. Compruebe que iata tenga valor antes de crear una consulta basada en códigos.
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
Encontrar los códigos de aeropuerto de una ciudad
Con city_code=LON obtiene los aeropuertos de Londres. Conserve el código IATA y el nombre de cada aeropuerto para que los viajeros distingan los aeropuertos de salida y de llegada dentro de la misma ciudad.
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'
Encontrar el código IATA por el nombre del aeropuerto
Busque con name y lea iata de los registros devueltos. Los nombres parciales pueden coincidir con varios registros, así que compare los nombres de los aeropuertos y los campos de ubicación antes de elegir un resultado.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'name=Heathrow'
Asociar un código ICAO de aeropuerto con un código IATA
Envíe el código ICAO de cuatro letras en icao y lea el campo iata de la respuesta para conectar los datos de aviación con los identificadores de aeropuertos de su proveedor de reservas.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'icao=EGLL'
Preguntas frecuentes
¿En qué se diferencian los códigos IATA de aeropuerto de los códigos de ciudad?
Un código de aeropuerto identifica un aeropuerto concreto, por ejemplo LHR para Londres Heathrow. Un código de ciudad agrupa un destino, por ejemplo LON para Londres. Use iata para consultar un aeropuerto y city_code para encontrar los aeropuertos de una ciudad. Mantenga ambos campos por separado al procesar la opción de destino “todos los aeropuertos” de un proveedor.
¿Puedo resolver los códigos de salida y de llegada de mi proveedor de reservas?
Sí, si los valores recibidos son códigos IATA de aeropuerto. Consulte cada código con iata para obtener el nombre y la ubicación del aeropuerto. Aclare si el campo de su proveedor se refiere a un aeropuerto o a una ciudad antes de elegir el parámetro de consulta. Use el código original del proveedor como alternativa si no se puede resolver ningún resultado.
¿Cada registro devuelto corresponde a un aeropuerto con vuelos comerciales?
No. El conjunto de datos más amplio puede incluir otros tipos de ubicación, como estaciones de tren, estaciones de autobús y helipuertos. Establezca major_only=1 para aeropuertos con vuelos comerciales. La respuesta completa incluye major_airport y sub_type para que su aplicación pueda distinguir los registros. Compruebe que iata tenga valor antes de crear una asociación basada en códigos.
¿Se incluyen los aeropuertos inactivos?
De forma predeterminada solo se devuelven registros activos. Establezca show_disabled=1 si necesita registros inactivos para itinerarios o informes históricos y revise active antes de ofrecer un aeropuerto en un selector de reservas.
¿Puedo descargar y guardar un directorio de códigos de aeropuertos?
Sí, con una licencia adecuada de GEO Essentials. Use dump=1 y elija JSON, XML o CSV con response_type. Defina con major_only y show_disabled la cobertura que necesita su producto. Con un directorio local resuelve códigos y crea la búsqueda de aeropuertos sin consultar cada aeropuerto por separado.
¿Debo usar el código IATA como clave permanente de la base de datos?
Conserve airhex_id como identificador permanente del registro y use iata como valor de consulta. Al importar, guarde updated de la respuesta completa y programe actualizaciones periódicas de su directorio local. Así también conserva los registros sin código IATA.
¿Puedo consultar un aeropuerto por su código ICAO?
Sí. Envíe un código ICAO de aeropuerto de cuatro letras, por ejemplo EGLL, en icao y lea iata de la respuesta. Los códigos ICAO de aeropuertos no deben confundirse con los códigos ICAO de tres letras de las aerolíneas de la API de aerolíneas.
¿La API devuelve vuelos, tarifas o salidas en tiempo real de un aeropuerto?
No. Este endpoint ofrece datos de referencia de aeropuertos. Los horarios, la disponibilidad, las tarifas y la información de vuelos en tiempo real los obtiene de su proveedor de vuelos. Un registro de aeropuerto activo o un indicador de vuelos comerciales no demuestra que una ruta concreta se pueda reservar.