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 um diretório de códigos ICAO de aeroportos
Exporte o diretório de aeroportos ativos em CSV e crie um índice local com os registos que têm o campo icao preenchido. Conserve iata, quando existir, para apoiar a correspondência com os dados de reserva. Acrescente major_only=1 se o seu produto precisar apenas de aeroportos com voos comerciais.
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 um código ICAO a partir de um código IATA
Envie LHR em iata e leia icao na resposta. Assim, a sua aplicação pode fazer corresponder o identificador de aeroporto de um fornecedor de reservas a uma fonte que usa códigos ICAO, usando ambos os códigos do mesmo registo de aeroporto.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'iata=LHR'
Encontrar um código ICAO a partir do nome de um aeroporto
Pesquise com name e verifique o campo icao devolvido. Nomes parciais podem devolver várias correspondências; compare o nome do aeroporto, o país e outros identificadores antes de selecionar um registo.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'name=Heathrow'
Perguntas frequentes
Qual é a diferença entre códigos ICAO e IATA de aeroportos?
Os identificadores ICAO de aeroportos têm quatro letras, como EGLL para Londres Heathrow. Os códigos IATA de aeroportos têm três letras, como LHR. Utilize icao ou iata consoante o sistema de códigos da sua fonte; a resposta fornece ambos os campos, quando disponíveis.
Posso fazer corresponder códigos ICAO de aeroportos a códigos IATA?
Sim. Consulte o aeroporto com icao e leia o campo iata devolvido. Também pode consultar um código IATA com iata e ler icao. Verifique se o campo de destino está preenchido antes de criar uma correspondência; não parta do princípio de que todos os registos têm ambos os identificadores.
Posso usar um código de cidade como código ICAO de aeroporto?
Não. Um código de cidade, como LON, é um identificador de destino distinto. Utilize city_code para encontrar os aeroportos associados a uma cidade e use depois o valor icao do registo do aeroporto em causa. Uma cidade pode ser servida por vários aeroportos.
Que aeroportos estão incluídos por predefinição?
O pedido predefinido devolve registos ativos e não limita os resultados a aeroportos com voos comerciais. Defina major_only=1 para essa restrição. O conjunto de dados mais amplo pode incluir outros tipos de localização; verifique icao antes de acrescentar registos a uma consulta ICAO e utilize major_airport e sub_type da resposta completa para distinguir as instalações.
Posso incluir aeroportos inativos para registos históricos?
Defina show_disabled=1 para incluir registos inativos ou desativados e verifique active na resposta. Conserve esse estado ao resolver dados históricos, para que uma referência antiga a um aeroporto não seja oferecida automaticamente como destino de reserva ativo.
Posso guardar localmente o diretório ICAO de aeroportos?
Sim, com uma licença GEO Essentials adequada. Utilize dump=1 para exportar em JSON, XML ou CSV e escolha major_only e show_disabled para a cobertura de que precisa. Indexe os valores icao preenchidos para consultas locais e conserve airhex_id como identificador permanente do registo.
Como devo manter as correspondências e tratar as que faltam?
Conserve airhex_id e updated da resposta completa e atualize periodicamente o seu diretório local. Verifique se os campos de código estão preenchidos antes de criar correspondências. Se uma consulta não conseguir resolver um código de origem, conserve o valor original para revisão, em vez de estimar uma correspondência a partir de um nome de aeroporto semelhante.
Uma consulta ICAO fornece dados operacionais de aeroportos ou de voos em tempo real?
Não. Este endpoint fornece dados de referência de aeroportos para identificar e fazer corresponder localizações. Obtenha o estado dos voos em tempo real, a disponibilidade de pistas e os avisos operacionais junto do fornecedor de dados operacionais adequado. O campo active descreve o estado operacional do registo do aeroporto, não as condições atuais dos voos.