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 el directorio de códigos ICAO de aeropuertos
Exporte como CSV el directorio de aeropuertos activos y cree un índice local con los registros que tengan el campo icao relleno. Conserve iata, si existe, para conciliar con datos de reservas. Añada major_only=1 si su producto solo necesita aeropuertos con vuelos comerciales.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'dump=1' \
--data-urlencode 'response_type=CSV' \
--output airports.csv
Encontrar el código ICAO a partir de un código IATA
Envíe LHR en iata y lea icao de la respuesta. Así su aplicación asocia el identificador de aeropuerto de un proveedor de reservas con una fuente que usa códigos ICAO, con ambos códigos del mismo registro de aeropuerto.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'iata=LHR'
Encontrar el código ICAO por el nombre del aeropuerto
Busque con name y revise el campo icao devuelto. Los nombres parciales pueden devolver varios resultados, así que compare el nombre del aeropuerto, el país y otros identificadores antes de elegir un registro.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'name=Heathrow'
Preguntas frecuentes
¿En qué se diferencian los códigos ICAO y IATA de los aeropuertos?
Los códigos ICAO de aeropuertos tienen cuatro letras, por ejemplo EGLL para Londres Heathrow. Los códigos IATA de aeropuertos tienen tres letras, por ejemplo LHR. Use icao o iata según el sistema de códigos de su fuente; la respuesta contiene ambos campos cuando existen.
¿Puedo asociar códigos ICAO de aeropuertos con códigos IATA?
Sí. Consulte el aeropuerto con icao y lea el campo iata devuelto. A la inversa, consulte un código IATA con iata y lea icao. Antes de asociarlos, compruebe que el campo de destino tenga valor; no todos los registros tienen ambos identificadores.
¿Puedo usar un código de ciudad como código ICAO de aeropuerto?
No. Un código de ciudad como LON es un identificador de destino independiente. Use city_code para encontrar los aeropuertos de una ciudad y utilice después el valor icao de cada aeropuerto. Una ciudad puede estar servida por varios aeropuertos.
¿Qué aeropuertos se incluyen por defecto?
La solicitud predeterminada devuelve registros activos y no limita los resultados a aeropuertos con vuelos comerciales. Esa limitación se consigue con major_only=1. El conjunto de datos más amplio puede incluir otros tipos de ubicación; revise icao antes de incluir registros en su tabla de consulta ICAO y distinga las instalaciones con major_airport y sub_type de la respuesta completa.
¿Puedo incluir aeropuertos inactivos para registros históricos?
Establezca show_disabled=1 para incluir registros inactivos o desactivados y revise active en la respuesta. Conserve ese estado al resolver datos históricos para que una referencia antigua a un aeropuerto no se ofrezca automáticamente como destino de reserva activo.
¿Puedo guardar en local el directorio de códigos ICAO de aeropuertos?
Sí, con una licencia adecuada de GEO Essentials. Exporte con dump=1 en JSON, XML o CSV y elija la cobertura con major_only y show_disabled. Indexe los valores de icao que tengan contenido para las consultas locales y conserve airhex_id como identificador permanente del registro.
¿Cómo mantengo las asociaciones y trato los resultados ausentes?
Conserve airhex_id y updated de la respuesta completa y actualice su directorio local con regularidad. Compruebe que los campos de código tengan valor antes de crear asociaciones. Si un código de su fuente no se puede resolver, guarde el valor original para su revisión en lugar de adivinar un resultado por el nombre de un aeropuerto parecido.
¿La consulta ICAO devuelve datos en tiempo real del aeropuerto o de las operaciones?
No. Este endpoint ofrece datos de referencia de aeropuertos para identificar y asociar ubicaciones. El estado actual de los vuelos, la disponibilidad de pistas y los avisos operativos los obtiene de un proveedor de datos operativos adecuado. El campo active describe el estado operativo del registro del aeropuerto, no las operaciones en curso.