Ajude os viajantes a identificar o aeroporto certo e a perceber onde começa e onde termina a sua viagem. Obtenha códigos de aeroportos, nomes, localizações e fusos horários, ou descarregue o diretório para as suas próprias ferramentas de pesquisa e reserva.
Envie iata=LHR para obter o London Heathrow Airport e os respetivos dados de referência. Substitua YOUR_API_KEY pela chave atribuída.
Este endpoint permite obter os dados geográficos de um aeroporto específico ou extrair toda a base de dados de aeroportos, com respostas disponíveis em JSON, XML ou CSV.
EndpointGET https://content.airhex.com/api/v3.7.10/airports/
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'iata=LHR'[
{
"airhex_id": "53779",
"updated": "2025-09-03 13:16:53",
"iata": "LHR",
"icao": "EGLL",
"name": "London Heathrow Airport",
"city_code": "LON",
"country_code": "GB",
"timezone": "Europe\/London",
"utc": "1",
"latitude": "51.469603",
"longitude": "-0.453566",
"active": "1",
"avg_weekly_flights": "1587",
"major_airport": 1,
"address": "Longford TW6, UK",
"phone_local": "0844 335 1801",
"phone_intl": "+44 844 335 1801",
"website": "https:\/\/www.heathrow.com",
"sub_type": null
}
]Resposta JSON completa. Desloque-se dentro do painel para ver todos os campos. Mais abaixo encontra exemplos expandidos em JSON e XML.
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; os filtros de cobertura continuam a aplicar-se.
| Parâmetro | Obrigatório | Valor | Tipo | Predefinição | Descrição |
|---|---|---|---|---|---|
| apikey | Sim | Qualquer | String | Nenhum | A sua chave de API atribuída. Obter chave de API de teste gratuita. |
| iata | Condicional | AAA-ZZZ | String | Nenhum | Código IATA de três letras do aeroporto |
| icao | Condicional | AAAA-ZZZZ | String | Nenhum | Código ICAO de quatro letras do aeroporto |
| city_code | Condicional | AAA-ZZZ | String | Nenhum | Código IATA de cidade de três letras |
| country_code | Condicional | AA-ZZ | String | Nenhum | Código de país de duas letras ISO 3166-1 Alpha-2 |
| name | Condicional | Qualquer | String | Nenhum | Nome do aeroporto ou parte do nome para correspondência parcial |
| dump | Condicional | 0 ou 1 | Integer | 0 | Defina 1 para exportar toda a base de dados (ignora os outros parâmetros condicionais acima) |
| show_disabled | Não | 0 ou 1 | Integer | 0 | Defina 1 para incluir na resposta os aeroportos inativos ou desativados. Por predefinição, só são devolvidos os aeroportos ativos. |
| response_type | Não | JSON, XML ou CSV | String | JSON | Formato da resposta: JSON, XML ou CSV (CSV inicia a descarga de um ficheiro) |
| major_only | Não | 0 ou 1 | Integer | 0 | Defina 1 para incluir apenas aeroportos com voos comerciais (exclui bases de hidroaviões, heliportos, bases militares, etc.) |
Obtenha identidades de aeroportos, dados de localização, estado operacional e informações de contacto. Os campos com ligação abrem guias específicos com exemplos e conselhos de integração.
| Campo | Exemplo | Descrição |
|---|---|---|
| airhex_id | 53779 | Identificador único e permanente do registo |
| updated | 2025-09-03 13:16:53 | Data e hora da última atualização do registo |
| iata | LHR | Código IATA de três letras do aeroporto |
| icao | EGLL | Código ICAO de quatro letras do aeroporto |
| name | London Heathrow Airport | Nome do aeroporto |
| city_code | LON | Código IATA de cidade de três letras da localização do aeroporto |
| country_code | GB | Código de país ISO 3166-1 Alpha-2 da localização do aeroporto |
| timezone | Europe/London | Identificador de fuso horário do aeroporto |
| utc | 1 | Desvio horário do aeroporto em relação ao UTC |
| latitude | 51.469603 | Latitude geográfica do aeroporto |
| longitude | -0.453566 | Longitude geográfica do aeroporto |
| major_airport | 1 |
Indica se o aeroporto tem voos comerciais regulares: 1 – aeroporto com voos regulares 0 – aeroporto sem voos regulares ou outros tipos de localização (estações de comboio e de autocarro, heliportos, etc.) |
| sub_type | Subtipo da instalação (se não for um aeroporto), por exemplo Rail, Bus/Limo, Ferry/Port ou Border/Customs | |
| active | 1 | Estado operacional: 1 ativo; 0 inativo |
| avg_weekly_flights | 1587 | Média semanal de voos regulares |
| address | Longford TW6, UK | Morada do aeroporto |
| phone_local | 0844 335 1801 | Contacto telefónico local do aeroporto |
| phone_intl | +44 844 335 1801 | Contacto telefónico internacional do aeroporto, com indicativo do país |
| website | https://www.heathrow.com | URL do site oficial do aeroporto |
Estes exemplos mostram o registo completo do London Heathrow Airport em JSON e XML. Utilize response_type para escolher o formato de saída.
[
{
"airhex_id": "53779",
"updated": "2025-09-03 13:16:53",
"iata": "LHR",
"icao": "EGLL",
"name": "London Heathrow Airport",
"city_code": "LON",
"country_code": "GB",
"timezone": "Europe\/London",
"utc": "1",
"latitude": "51.469603",
"longitude": "-0.453566",
"active": "1",
"avg_weekly_flights": "1587",
"major_airport": 1,
"address": "Longford TW6, UK",
"phone_local": "0844 335 1801",
"phone_intl": "+44 844 335 1801",
"website": "https:\/\/www.heathrow.com",
"sub_type": null
}
]<?xml version="1.0" encoding="UTF-8"?>
<airports>
<airport>
<airhex_id>53779</airhex_id>
<updated>2025-09-03 13:16:53</updated>
<iata>LHR</iata>
<icao>EGLL</icao>
<name>London Heathrow Airport</name>
<city_code>LON</city_code>
<country_code>GB</country_code>
<timezone>Europe/London</timezone>
<utc>1</utc>
<latitude>51.469603</latitude>
<longitude>-0.453566</longitude>
<active>1</active>
<avg_weekly_flights>1587</avg_weekly_flights>
<major_airport>1</major_airport>
<address>Longford TW6, UK</address>
<phone_local>0844 335 1801</phone_local>
<phone_intl>+44 844 335 1801</phone_intl>
<website>https://www.heathrow.com</website>
<sub_type></sub_type>
</airport>
</airports>
Exporte os aeroportos ativos com voos comerciais para o seu índice de pesquisa local. Conserve airhex_id e updated ao importar os registos.
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.csvUtilize o código da cidade para obter os aeroportos associados, conservando o código e o nome próprios de cada aeroporto para as escolhas individuais.
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'Faça corresponder um identificador de aviação ao mesmo registo de aeroporto utilizado pelas suas ferramentas de reserva.
curl --get 'https://content.airhex.com/api/v3.7.10/airports/' \
--data-urlencode 'apikey=YOUR_API_KEY' \
--data-urlencode 'icao=EGLL'Ajude os viajantes a distinguir aeroportos por nome, código, cidade e país.
Transforme os códigos de aeroporto do fornecedor em locais de partida e de chegada claros nos resultados, nas confirmações e nos itinerários.
Utilize as coordenadas para mapas de aeroportos e os identificadores de fuso horário para apresentar a hora local.
Sim. Descarregue o diretório de aeroportos e crie um índice de pesquisa local com os nomes dos aeroportos, os códigos IATA e ICAO, as associações a cidades e os países. A sua aplicação controla a correspondência e a ordenação das sugestões. O endpoint fornece dados de referência e pesquisas por nome, não uma interface de preenchimento automático pronta a usar.
A Airhex agrega e verifica dados geográficos de várias fontes e revê-os diariamente. Atualize periodicamente o seu diretório local, conservando airhex_id e updated para que as alterações possam ser aplicadas aos mesmos registos de aeroportos.
Utilize iata para um aeroporto específico, como LHR, e city_code para os aeroportos associados a uma cidade, como LON. Uma cidade pode ter vários aeroportos. Confirme o tipo de localização fornecido pelo seu fornecedor de reservas.
Por predefinição, só são devolvidos registos ativos, sem limitar os resultados a aeroportos com voos comerciais. Utilize major_only=1 para essa restrição e show_disabled=1 para incluir registos inativos ou desativados. Verifique active, major_airport e sub_type antes de apresentar registos num seletor de reservas.
Sim, com uma licença GEO Essentials adequada. Exporte com dump=1 em JSON, XML ou CSV. Conserve airhex_id e updated e atualize periodicamente o seu diretório local.
Utilize timezone com a data e hora reais da viagem e uma biblioteca que reconheça datas. O campo utc é um desvio do registo; não descreve as regras de hora de verão de cada data.
As coordenadas descrevem a localização do aeroporto. Não as trate como coordenadas de terminal, porta ou ponto de recolha. Utilize dados de localização e de itinerário mais específicos para indicações de transferência terrestre.
Não. Fornece dados de referência de aeroportos. Recorra ao seu fornecedor de voos para horários, disponibilidade, tarifas e estado dos voos em tempo real.
Consulte o guia da API de fuso horário de aeroportos e o guia da API de coordenadas de aeroportos para obter detalhes de implementação.
Leve opções de aeroporto claras, dados de localização e hora local para o seu processo de reserva, enquanto a Airhex mantém os dados de referência de aeroportos.