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 fusos horários dos aeroportos para os seus itinerários
Exporte os aeroportos ativos com voos comerciais em CSV e conserve timezone juntamente com airhex_id e os códigos dos aeroportos. A sua aplicação pode então determinar o fuso horário de cada troço do itinerário a partir de um diretório local.
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-timezones.csv
Obter um fuso horário através de um código ICAO
Utilize icao quando a sua fonte identificar os aeroportos com códigos de quatro letras. Este pedido faz corresponder EGLL ao mesmo registo e fuso horário 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'
Apresentar uma data e hora UTC fornecida na hora local do aeroporto
Depois de obter timezone, passe-o ao formatador de data e hora da sua aplicação com uma data e hora inequívoca do seu fornecedor de voos. Este exemplo em JavaScript usa Europe/London, tirado da resposta. A data e hora é ilustrativa; a API de aeroportos não fornece horários de voos.
const airportTimeZone = 'Europe/London';
const departureUtc = '2026-07-15T12:00:00Z';
const localDeparture = new Intl.DateTimeFormat('en-GB', {
timeZone: airportTimeZone,
dateStyle: 'medium',
timeStyle: 'short'
}).format(new Date(departureUtc));
// 15 Jul 2026, 13:00
Perguntas frequentes
Qual é a diferença entre timezone e utc?
timezone identifica um fuso com nome, como Europe/London. utc fornece um desvio no registo do aeroporto. Um desvio, por si só, não descreve as regras de hora de verão nem as alterações ao longo das datas. Utilize o fuso com nome e a data e hora reais da viagem ao converter horas.
Como devo tratar a hora de verão?
Utilize timezone com uma biblioteca que reconheça datas e se baseie nas regras de fuso horário atuais. A biblioteca determina o desvio para a data a converter. Não aplique o desvio UTC do exemplo a todos os voos e mantenha atualizados os dados de fusos horários da sua aplicação, pois as regras podem mudar.
A API converte as horas dos voos por mim?
Não. Devolve dados de referência de aeroportos, incluindo identificadores de fuso horário. A sua aplicação faz a conversão com as datas e horas fornecidas pelo seu fornecedor de voos. Este endpoint não tem parâmetros de data de viagem nem de conversão de horas.
E se o meu fornecedor já enviar as horas locais dos voos?
Confirme o formato de data e hora do fornecedor antes de converter. Não interprete uma hora local como UTC nem a converta duas vezes. Uma data e hora local sem desvio pode ser ambígua nas mudanças de hora de verão; utilize um desvio explícito ou uma data e hora UTC do fornecedor, quando disponível.
Como trato a partida e a chegada em fusos horários diferentes?
Resolva cada aeroporto em separado e formate cada data e hora com o timezone desse aeroporto. Inclua a data local quando a viagem passar a meia-noite. Calcule a duração da viagem a partir de datas e horas inequívocas, em vez de subtrair as horas locais apresentadas.
Posso assumir que todos os aeroportos de um país usam o mesmo fuso horário?
Não. Obtenha o fuso horário do registo do aeroporto em causa, em vez de o deduzir a partir do país. Se pesquisar por city_code ou country_code, leia timezone de cada aeroporto devolvido.
Posso guardar os fusos horários dos aeroportos na minha própria base de dados?
Sim, com uma licença GEO Essentials adequada. Exporte com dump=1 e escolha JSON, XML ou CSV com response_type. Conserve airhex_id e updated da resposta completa, atualize periodicamente as suas correspondências de aeroportos e mantenha as regras de fusos horários atualizadas no software que faz as conversões.
O que devo fazer se um fuso horário estiver em falta ou não for reconhecido?
Valide o timezone devolvido antes de o passar ao formatador. Conserve a data e hora e o desvio originais do fornecedor, quando existirem, e assinale as correspondências por resolver para revisão. Não substitua silenciosamente pelo fuso horário do dispositivo do utilizador nem por um desvio estimado para todo o país.