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 coordenadas para su mapa de aeropuertos
Exporte como CSV los aeropuertos activos con vuelos comerciales. Conserve latitud, longitud, códigos y nombres para crear marcadores de mapa a partir de un directorio local. Use major_only=0 si su producto necesita también otros tipos de ubicación.
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-coordinates.csv
Encontrar las coordenadas de los aeropuertos de una ciudad
Con city_code=LON obtiene los aeropuertos de Londres. Lea latitude y longitude de cada registro para mostrar la ubicación de cada aeropuerto, en lugar de colocar todos los aeropuertos en el centro de la 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'
Obtener las coordenadas con un código ICAO
Use icao cuando su fuente de datos identifique los aeropuertos con códigos de cuatro letras. EGLL lleva al mismo registro de Heathrow 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'
Preguntas frecuentes
¿En qué formato se devuelven las coordenadas?
latitude y longitude son campos independientes con valores en grados decimales. En el ejemplo JSON son strings numéricos. Analícelos como números si su biblioteca de mapas necesita entradas numéricas, y conserve los signos negativos y la precisión decimal disponible.
¿Qué coordenada paso primero a mi biblioteca de mapas?
Compruebe el orden que espera la biblioteca. Algunas interfaces esperan primero la latitud y después la longitud; otras, al revés. La API devuelve campos con nombre, así que puede asignar cada valor de forma explícita en lugar de depender del orden de un array.
¿Este endpoint encuentra el aeropuerto más cercano?
No. Consulta aeropuertos por los identificadores documentados, por el nombre o por filtros de ubicación, o exporta el directorio. Para encontrar aeropuertos cercanos, guarde las coordenadas y haga en su aplicación una consulta de distancia o espacial. Este endpoint no tiene un parámetro de radio ni de aeropuerto más cercano.
¿Puedo estimar con las coordenadas el tiempo de trayecto a un hotel?
Las coordenadas pueden ser datos de entrada para su servicio de mapas o de rutas. Una distancia en línea recta no es una distancia por carretera ni un tiempo de viaje. Para estimar un traslado, use un proveedor de rutas adecuado y el punto de recogida o de destino correspondiente.
¿Las coordenadas indican una terminal, una puerta de embarque o un punto de recogida?
Estos campos describen la ubicación del aeropuerto. No los trate como coordenadas de la terminal, de la puerta de embarque, de la pista ni del punto de recogida de pasajeros. Use datos de ubicación más precisos si su producto necesita indicaciones dentro del aeropuerto o puntos de encuentro para traslados.
¿Cómo limito mi mapa a los aeropuertos con vuelos comerciales?
Establezca major_only=1. De forma predeterminada solo se devuelven registros activos; con show_disabled=1 obtiene también, si lo necesita, los inactivos o desactivados. La respuesta completa incluye major_airport, sub_type y active para que su aplicación pueda distinguir los registros antes de mostrarlos.
¿Qué hago si una coordenada falta o no es válida?
Compruebe ambos campos antes de crear un marcador. Descarte los valores ausentes, vacíos o no numéricos y verifique que la latitud esté entre -90 y 90 y la longitud entre -180 y 180. No convierta un campo vacío en cero; el cero en sí puede ser una coordenada válida. Guarde para su revisión los registros sin resolver, en lugar de colocarlos en una ubicación estimada.
¿Puedo mantener un directorio de coordenadas de aeropuertos en mi propia base de datos?
Sí, con una licencia adecuada de GEO Essentials. Use dump=1 y elija JSON, XML o CSV con response_type. Conserve airhex_id y updated de la respuesta completa y actualice sus registros locales con regularidad para recoger los cambios de código, nombre y coordenadas del mismo aeropuerto.