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 os códigos para o seu seletor de aeroportos
Exporte os aeroportos ativos com voos comerciais em CSV e crie depois o seu índice de pesquisa local a partir dos códigos, nomes e identificadores de localização. Utilize major_only=0 se o seu produto precisar também de outros tipos de localização. Verifique se existe um valor iata preenchido antes de acrescentar uma consulta por código.
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 airports.csv
Encontrar os códigos de aeroportos de uma cidade
Utilize city_code=LON para obter os aeroportos associados a Londres. Conserve o código IATA e o nome próprios de cada aeroporto, para que os viajantes possam distinguir os aeroportos de partida e de chegada dentro da mesma 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'
Encontrar um código IATA a partir do nome de um aeroporto
Pesquise com name e leia iata nos registos devolvidos. Nomes parciais podem corresponder a vários registos; compare os nomes dos aeroportos e os campos de localização antes de selecionar uma correspondência.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'name=Heathrow'
Fazer corresponder um código ICAO de aeroporto a um código IATA
Envie o código ICAO de quatro letras em icao e leia o campo iata devolvido para ligar registos de aviação aos identificadores de aeroportos usados pelo seu fornecedor de reservas.
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 diferem os códigos IATA de aeroportos dos códigos de cidade?
Um código de aeroporto identifica um aeroporto em particular, como LHR para Londres Heathrow. Um código de cidade agrupa um destino, como LON para Londres. Utilize iata para consultar um aeroporto e city_code para encontrar os aeroportos associados a uma cidade. Mantenha os dois campos separados ao tratar a opção de destino “todos os aeroportos” de um fornecedor.
Posso resolver os códigos de partida e de chegada do meu fornecedor de reservas?
Sim, quando os valores fornecidos são códigos IATA de aeroportos. Consulte cada código com iata para obter o nome e a localização do aeroporto. Confirme se o campo do seu fornecedor representa um aeroporto ou uma cidade antes de escolher o parâmetro de consulta. Utilize o código original do fornecedor como alternativa se não conseguir resolver uma correspondência.
Todos os registos devolvidos representam um aeroporto com voos comerciais?
Não. O conjunto de dados mais amplo pode incluir outros tipos de localização, como estações de comboio ou de autocarro e heliportos. Defina major_only=1 para aeroportos com voos comerciais. A resposta completa inclui major_airport e sub_type para ajudar a sua aplicação a distinguir os registos. Verifique se iata está preenchido antes de criar uma correspondência por código.
Os aeroportos inativos estão incluídos?
Por predefinição, só são devolvidos registos ativos. Defina show_disabled=1 se precisar de registos inativos para itinerários ou relatórios históricos e verifique active antes de oferecer um aeroporto num seletor de reservas.
Posso descarregar e guardar um diretório de códigos de aeroportos?
Sim, com uma licença GEO Essentials adequada. Utilize dump=1 e escolha JSON, XML ou CSV com response_type. Escolha major_only e show_disabled de acordo com a cobertura de que o seu produto precisa. Com um diretório local, pode resolver códigos e criar uma pesquisa de aeroportos sem pedir cada aeroporto em separado.
Devo usar o código IATA como chave permanente da minha base de dados?
Conserve airhex_id como identificador permanente do registo e utilize iata como valor de consulta. Guarde updated da resposta completa ao importar registos e planeie atualizações periódicas do seu diretório local. Isto permite também conservar registos que não têm código IATA preenchido.
Posso consultar um aeroporto pelo código ICAO?
Sim. Envie um código ICAO de aeroporto com quatro letras, como EGLL, em icao e leia iata na resposta. Os códigos ICAO de aeroportos são distintos dos códigos ICAO de companhias aéreas, com três letras, usados pela API de companhias aéreas.
Esta API fornece voos, tarifas ou partidas de aeroportos em tempo real?
Não. Este endpoint fornece dados de referência de aeroportos. Recorra ao seu fornecedor de voos para horários, disponibilidade, tarifas e informação de voos em tempo real. Um registo de aeroporto ativo ou um indicador de voos comerciais não determina que uma rota em particular esteja disponível para reserva.