Parâmetros do pedido
Consulte um aeroporto específico, encontre aeroportos por localização ou exporte o diretório com estes parâmetros de consulta.
| Parâmetro | Obrigatório | Predefinição | Descrição |
|---|
apikey |
Sim | Nenhum | A sua chave de API atribuída. Obter chave de API de teste gratuita. |
|---|
iata |
Condicional | Nenhum | Código IATA de aeroporto com três letras, por exemplo LHR. |
|---|
icao |
Condicional | Nenhum | Código ICAO de aeroporto com quatro letras, por exemplo EGLL. |
|---|
city_code |
Condicional | Nenhum | Código IATA de cidade com três letras, por exemplo LON, para encontrar os aeroportos associados a uma cidade. |
|---|
country_code |
Condicional | Nenhum | Código de país ISO de duas letras, por exemplo GB, para encontrar os aeroportos de um país. |
|---|
name |
Condicional | Nenhum | Nome do aeroporto ou parte do nome, por exemplo Heathrow. |
|---|
dump |
Condicional | 0 | Defina 1 para exportar a base de dados. Substitui os outros parâmetros de consulta; os filtros de cobertura continuam a aplicar-se. |
|---|
show_disabled |
Não | 0 | Defina 1 para incluir registos inativos ou desativados. Por predefinição, só são devolvidos registos ativos. |
|---|
response_type |
Não | JSON | Formato da resposta: JSON, XML ou CSV. CSV inicia a descarga de um ficheiro. |
|---|
major_only |
Não | 0 | Defina 1 para incluir apenas aeroportos com voos comerciais. |
|---|
Indique pelo menos um dos parâmetros iata, icao, city_code, country_code, name ou dump=1. Com dump=1, os restantes parâmetros de consulta são ignorados.
Ver todos os parâmetros do pedido →
Tarefas de implementação mais comuns
Descarregar as coordenadas para o seu mapa de aeroportos
Exporte os aeroportos ativos com voos comerciais em CSV. Conserve a latitude, a longitude, os códigos e os nomes para criar marcadores de mapa a partir de um diretório local. Utilize major_only=0 se o seu produto precisar também de outros tipos de localização.
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 as coordenadas dos aeroportos de uma cidade
Utilize city_code=LON para obter os aeroportos associados a Londres. Leia a latitude e a longitude de cada registo para mostrar a localização individual de cada aeroporto, em vez de colocar todos os aeroportos no centro da cidade.
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'
Obter coordenadas através de um código ICAO
Utilize icao quando a sua fonte de dados identificar os aeroportos com códigos de quatro letras. EGLL corresponde ao mesmo registo de Heathrow que uma consulta IATA por LHR.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'icao=EGLL'
Perguntas frequentes
Em que formato são devolvidas as coordenadas?
latitude e longitude são campos separados com valores em graus decimais. No exemplo JSON, são strings numéricas. Converta-as em números quando a sua biblioteca de mapas exigir valores numéricos e preserve os sinais negativos e a precisão decimal disponível.
Que coordenada devo passar primeiro à minha biblioteca de mapas?
Verifique a ordem esperada pela biblioteca. Algumas interfaces recebem a latitude seguida da longitude, enquanto outras esperam a longitude seguida da latitude. A API devolve campos com nome, para que possa mapear cada valor explicitamente em vez de depender da ordem de um array.
Este endpoint encontra o aeroporto mais próximo?
Não. Consulta aeroportos pelos identificadores, pelo nome ou pelos filtros de localização documentados, ou exporta o diretório. Para encontrar aeroportos próximos, guarde as coordenadas e execute uma consulta de distância ou espacial na sua aplicação. Este endpoint não tem parâmetros de raio nem de aeroporto mais próximo.
Posso usar as coordenadas para estimar o tempo de viagem até um hotel?
As coordenadas podem ser dados de entrada do seu serviço de mapas ou de cálculo de rotas. Uma distância em linha reta não é uma distância por estrada nem uma duração de viagem. Utilize um fornecedor de rotas adequado e o local de recolha ou de entrega relevante ao estimar uma transferência terrestre.
As coordenadas identificam um terminal, uma porta ou um ponto de recolha?
Estes campos descrevem a localização do aeroporto. Não os trate como coordenadas de terminal, porta, pista ou recolha de passageiros. Utilize dados de localização mais específicos quando o seu produto precisar de indicações dentro de um aeroporto ou de um ponto de encontro para transferências.
Como limito o meu mapa a aeroportos com voos comerciais?
Defina major_only=1. Por predefinição, só são devolvidos registos ativos; show_disabled=1 inclui registos inativos ou desativados, se precisar deles. A resposta completa inclui major_airport, sub_type e active para ajudar a sua aplicação a distinguir os registos antes de os apresentar.
O que devo fazer se uma coordenada estiver em falta ou for inválida?
Verifique ambos os campos antes de criar um marcador. Rejeite valores em falta, vazios ou não numéricos e valide a latitude entre -90 e 90 e a longitude entre -180 e 180. Não converta um campo vazio em zero; o zero pode ser, por si só, uma coordenada válida. Mantenha os registos por resolver disponíveis para revisão, em vez de os colocar num local estimado.
Posso manter um diretório de coordenadas de aeroportos na minha própria base de dados?
Sim, com uma licença GEO Essentials adequada. Utilize dump=1 e escolha JSON, XML ou CSV com response_type. Conserve airhex_id e updated da resposta completa e atualize periodicamente os seus registos locais, para que as alterações de código, nome e coordenadas possam ser aplicadas à mesma identidade de aeroporto.