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 las zonas horarias de los aeropuertos para sus itinerarios
Exporte como CSV los aeropuertos activos con vuelos comerciales y conserve timezone junto con airhex_id y los códigos de aeropuerto. Su aplicación podrá resolver entonces la zona horaria de cada tramo del viaje a partir de un directorio local.
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-timezones.csv
Obtener la zona horaria con un código ICAO
Use icao cuando su fuente identifique los aeropuertos con códigos de cuatro letras. Esta solicitud lleva EGLL al mismo registro de Heathrow y a la misma zona horaria que la consulta IATA con LHR.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'icao=EGLL'
Mostrar una marca de tiempo UTC recibida en la hora local del aeropuerto
Tras la consulta, pase timezone junto con una marca de tiempo inequívoca de su proveedor de vuelos a la función de formato de fecha y hora de su aplicación. El ejemplo de JavaScript usa Europe/London de la respuesta. La marca de tiempo es solo ilustrativa; la API de aeropuertos no devuelve horarios de vuelos.
const airportTimeZone = 'Europe/London';
const departureUtc = '2026-07-15T12:00:00Z';
const localDeparture = new Intl.DateTimeFormat('en-GB', {
timeZone: airportTimeZone,
dateStyle: 'medium',
timeStyle: 'short'
}).format(new Date(departureUtc));
// 15 Jul 2026, 13:00
Preguntas frecuentes
¿En qué se diferencian timezone y utc?
timezone indica una zona con nombre, como Europe/London. utc devuelve un desfase del registro del aeropuerto. Un desfase por sí solo no dice nada sobre las reglas del horario de verano ni sobre los cambios a lo largo del año. Para la conversión, use la zona con nombre junto con la marca de tiempo real del viaje.
¿Cómo trato el horario de verano?
Use timezone con una biblioteca que tenga en cuenta las fechas y aplique las reglas de zona horaria vigentes. La biblioteca determina el desfase de la fecha que se va a convertir. No aplique el desfase UTC del ejemplo a todos los vuelos y mantenga actualizados los datos de zonas horarias de su aplicación, porque las reglas pueden cambiar.
¿La API convierte por mí los horarios de los vuelos?
No. Ofrece datos de referencia de aeropuertos, entre ellos los identificadores de zona horaria. La conversión la hace su aplicación con las marcas de tiempo de su proveedor de vuelos. Este endpoint no tiene un parámetro de fecha de viaje ni de conversión horaria.
¿Qué ocurre si mi proveedor ya envía horas locales?
Aclare el formato de marca de tiempo del proveedor antes de convertir. No interprete una hora local como UTC ni convierta dos veces. La fecha y la hora local sin desfase pueden ser ambiguas en torno a los cambios de horario de verano; si es posible, use una marca de tiempo del proveedor con desfase explícito o en UTC.
¿Cómo trato la salida y la llegada en zonas horarias distintas?
Resuelva cada aeropuerto por separado y dé formato a cada marca de tiempo con el valor de timezone de ese aeropuerto. Muestre la fecha local si el viaje cruza la medianoche. Calcule la duración del viaje con marcas de tiempo inequívocas y no restando las horas locales mostradas.
¿Puedo suponer que todos los aeropuertos de un país tienen la misma zona horaria?
No. Obtenga la zona horaria de cada registro de aeropuerto en lugar de deducirla del país. Si busca con city_code o country_code, lea timezone de cada aeropuerto devuelto.
¿Puedo guardar las zonas horarias de los aeropuertos en mi propia base de datos?
Sí, con una licencia adecuada de GEO Essentials. Exporte con dump=1 y elija JSON, XML o CSV con response_type. Conserve airhex_id y updated de la respuesta completa, actualice con regularidad sus asociaciones de aeropuertos y mantenga actualizadas las reglas de zona horaria en el software que hace las conversiones.
¿Qué hago si una zona horaria falta o no es compatible?
Compruebe el valor de timezone devuelto antes de pasarlo a su función de formato. Conserve la marca de tiempo original y, si existe, el desfase del proveedor, y marque las asociaciones sin resolver para su revisión. No use en su lugar, sin avisar, la zona horaria del dispositivo del usuario ni un desfase estimado para todo el país.