Airfield Directory

Fornece informações aeronáuticas de aeródromos para pilotos privados de aviação geral, como pistas, preços de combustível, taxas de pouso, clima, webcams e mais.

Documentação

FAQ do Airfield Directory

Links rápidos:

Geral

O que é o Airfield Directory?

O Airfield Directory é um banco de dados aberto, gratuito e não comercial para Relatórios de Pilotos (PIREPs) de aeródromos, taxas de pouso e preços de combustível, alimentado pela comunidade de aviação geral. Nosso objetivo é fornecer informações aeronáuticas gratuitas e conduzidas pela comunidade para pilotos em todo o mundo. Pense nele como uma Wikipédia para aeródromos de aviação geral. Todas as informações são fornecidas sem garantia e sem responsabilidade; não é adequado para planejamento de voo; os dados podem estar imprecisos ou desatualizados.

O Airfield Directory é gratuito para usar?

Sim. O Airfield Directory é completamente gratuito para usar e sempre permanecerá sem anúncios e sem rastreamento. Acreditamos que os dados aeronáuticos devem ser acessíveis a todos na comunidade de pilotos.

Usando o Airfield Directory

O que posso fazer no Airfield Directory?

Consulte nossa Página de Recursos.

Por que os marcadores no mapa têm cores diferentes?

  • Verde: Avaliação média de 4 a 5 estrelas
  • Amarelo: Avaliação média de 2,3 a 3,5 estrelas
  • Vermelho: Avaliação média <= 2 estrelas
  • Azul: Sem PIREPs e/ou apenas resumos gerados por IA

Por que alguns marcadores têm centro branco com contorno colorido?

Seguindo as convenções das cartas aeronáuticas ICAO, marcadores com preenchimento sólido representam aeródromos com pistas pavimentadas (asfalto, concreto), enquanto marcadores com preenchimento branco e contorno colorido representam aeródromos com pistas não pavimentadas (grama, cascalho, terra). A cor do contorno ainda indica a avaliação, assim como nos aeródromos pavimentados.

O que significam as bordas coloridas nos rótulos ICAO?

Quando os dados meteorológicos estão disponíveis, os rótulos dos códigos ICAO no mapa exibem uma borda esquerda colorida indicando a categoria de voo atual:

  • 🟢 Verde: VFR (Regras de Voo Visual)
  • 🔵 Azul: MVFR (VFR Marginal)
  • 🔴 Vermelho: IFR (Regras de Voo por Instrumentos)
  • 🟣 Roxo: LIFR (IFR Baixo)

Essas categorias padrão da aviação são derivadas de dados METAR em tempo real, refletindo teto e visibilidade no aeródromo.

Contribuindo com Conteúdo

Como posso contribuir com PIREPs?

Crie uma conta entrando com Apple, Google ou Amazon e, em seguida, visite a página de qualquer aeródromo para enviar seu relatório de piloto. Suas contribuições ajudam outros pilotos a tomar melhores decisões.

O que acontece com minhas contribuições?

Todos os PIREPs e comentários que você enviar estão:

  • Publicados publicamente sob a licença CC BY-SA 4.0, o que significa que, ao publicar, você concede a todos uma licença permanente e mundial sob CC BY-SA 4.0.
  • Disponíveis para outros usarem, compartilharem e adaptarem com atribuição adequada e compartilhamento sob a mesma licença.
  • Cobertos por uma licença irrevogável, portanto, mesmo se você excluir um PIREP posteriormente, as cópias existentes permanecem utilizáveis sob CC BY-SA 4.0.

Posso excluir ou modificar meus PIREPs?

Sim. Você pode excluir ou alterar seus PIREPs pela interface do site a qualquer momento. Observe que:

  • A licença CC BY-SA 4.0 é irrevogável.
  • Cópias já feitas por outras pessoas podem persistir.
  • A licença permanece válida para quaisquer cópias feitas antes da exclusão.

E o selo "Gerado por IA, pode conter erros"?

Para criar um conjunto inicial de relatórios, usamos IA em agosto de 2025 para gerar alguns PIREPs iniciais. Eles estão claramente marcados com um selo "Gerado por IA, pode conter erros". Incentivamos a comunidade a substituí-los ou complementá-los com relatórios reais de pilotos.

Quem é responsável pelos PIREPs e comentários?

O respectivo autor. Você é legalmente responsável pelo conteúdo que envia, incluindo PIREPs e comentários. Publique apenas informações lícitas e factuais e não inclua dados pessoais de terceiros. Fazemos moderação posterior e podemos remover conteúdo, mas não realizamos pré-moderação geral.

Como posso denunciar conteúdo problemático?

Envie um e-mail para info@airfield.directory com o link do conteúdo, uma breve explicação e seus dados de contato. Revisaremos prontamente sob um processo de notificação e remoção.

Incorporando Dados do Airfield

Posso incorporar informações de aeródromos no meu site?

Sim! O Airfield Directory oferece widgets incorporáveis que exibem dados ao vivo de aeródromos, incluindo avaliações, clima, taxas de pouso e preços de combustível no seu site. Isso é ideal para operadores de aeroportos e aeródromos que desejam exibir suas avaliações, feedback da comunidade e informações operacionais diretamente em seu próprio site — sem necessidade de programação. Visite o Configurador de Widget de Incorporação para gerar um código de incorporação para qualquer aeródromo. O widget está disponível em layout vertical ou horizontal, com densidade compacta ou estendida, e suporta 6 idiomas.

API e Download em Massa de Dados S3

Existe uma API?

Sim. Você pode acessar dados de aeródromos em formato JSON adicionando .json a qualquer URL de aeródromo.

Exemplo: https://airfield.directory/airfield/EDAZ.json. Revise os termos de licenciamento na resposta JSON.

Se você precisar de um download em massa, exportações JSON completas de todos os PIREPs estão disponíveis no bucket S3 airfield-directory-pirep-export:

aws s3api list-objects-v2 --bucket airfield-directory-pirep-export --no-sign-request
curl -LO "https://airfield-directory-pirep-export.s3.amazonaws.com/airfield-directory-pireps-export-latest.json.gz"

# Filter out AI-generated PIREPs with jq:
gunzip -c airfield-directory-pireps-export-latest.json.gz | jq '.pireps
  | with_entries(
      .value |= (
        to_entries
        | map(select(.value.ai_generated != true))
        | from_entries
      )
    )
  | with_entries(select(.value != {}))'

# Count the current non-AI PIREPs:
gunzip -c airfield-directory-pireps-export-latest.json.gz | jq '
  .pireps
  | [ .[]
      | .[]
      | select(.ai_generated != true)
    ]
  | length'

# Extract PIREPs for a single airfield (for example EDAZ):
gunzip -c airfield-directory-pireps-export-latest.json.gz | jq '.pireps.EDAZ'

Quais dados estão incluídos na API JSON?

  • Informações de aeródromos da FAA (EUA), OpenAIP e OpenFlightMaps
  • Dados da Aerops, quando disponíveis, incluindo preços de combustível, taxas de pouso e taxas de estacionamento
  • PIREPs da comunidade
  • Informações de licença para cada seção de dados

Quais dados estão incluídos na exportação S3?

  • PIREPs da comunidade, incluindo informações de licença

Dados pessoais são expostos na API?

Não. Levamos a privacidade a sério:

  • Endereços de e-mail nunca são expostos.
  • Apenas hashes SHA256 e nomes de exibição são incluídos.
  • O uso do Gravatar também depende de hashes SHA256.

Pacotes de Conteúdo ForeFlight

Como importo PIREPs no ForeFlight?

Você pode importar nossos pacotes de conteúdo ForeFlight assim:

Publicamos duas variantes de pacote por localidade:

  • airfield-directory-pireps-foreflight-<locale>.zip para apenas PIREPs escritos por humanos
  • airfield-directory-pireps-foreflight-with-ai-<locale>.zip incluindo PIREPs de IA/raiz

Bot do Telegram

Existe um bot do Telegram?

Sim. @AirfieldDirectoryBot permite consultar dados de aeródromos de qualquer cliente Telegram e, uma vez que sua conta esteja vinculada, enviar PIREPs. Abra um chat e envie /help para ver o que está disponível. Como no site, o bot não é uma fonte oficial de planejamento de voo — verifique informações operacionais e meteorológicas com fontes oficiais antes do voo.

Como vinculo minha conta do Airfield Directory?

Entre no site, abra seu perfil (clique no seu avatar no canto superior direito) e use a seção Telegram para conectar sua conta. Sem vincular, você ainda pode executar comandos somente leitura como /info, /weather e /pireps, mas o bot não pode aceitar PIREPs de você — não haveria conta para atribuí-los.

Quais comandos o bot suporta?

  • /info ICAO — detalhes do aeródromo (localização, pistas, combustível, taxas)
  • /weather ICAO ou /wx ICAO — METAR / TAF quando disponíveis
  • /pireps ICAO — relatórios de pilotos recentes
  • /pirep ICAO — inicia o assistente de PIREP (conta vinculada necessária)
  • /settings language <code> — altera o idioma do bot (en, de, es, fr, it, nl; conta vinculada necessária)
  • /start logout — desvincula sua conta do bot
  • /help — mostra esta lista de comandos

Como funciona o assistente de PIREP?

Após enviar /pirep KMZZ, o bot conduz você por uma conversa curta:

  1. Escolha uma avaliação tocando em um dos botões de 1 a 5.
  2. Responda com o texto do seu relatório — 2 a 3 frases geralmente são suficientes.
  3. Revise o rascunho que o bot mostra e escolha Salvar, Editar avaliação, Editar texto ou Cancelar.

Uma vez salvo, o PIREP aparece imediatamente na página do aeródromo no site, atribuído ao seu perfil do Airfield Directory sob CC BY-SA 4.0 como qualquer outro PIREP.

Servidor MCP

Existe um servidor MCP?

Sim. O Airfield Directory expõe um endpoint MCP remoto somente leitura em https://airfield.directory/mcp.

Como uso com o claude.ai da Anthropic?

O Claude na web suporta servidores MCP remotos via Connectors (beta). Vá para Configurações > Connectors, clique em Adicionar conector personalizado, insira um nome (por exemplo, "Airfield Directory") e a URL https://airfield.directory/mcp, depois clique em Adicionar. Nenhuma autenticação é necessária. Após adicionar, clique em Configurar ao lado do conector e defina todas as ferramentas como Sempre permitir para que o Claude possa usá-las sem solicitar a cada vez.

Como uso com o Claude Desktop?

Uma configuração claude_desktop_config.json que sabemos funcionar usa o wrapper mcp-remote para conectar o Claude Desktop ao servidor MCP HTTP remoto:

{
  "mcpServers": {
    "airfield-directory": {
      "command": "npx",
      "args": ["mcp-remote", "https://airfield.directory/mcp"]
    }
  }
}

Se você editar o arquivo JSON diretamente, reinicie o Claude Desktop depois.

Como uso com o Claude Code?

A configuração do Claude Code com escopo de projeto pode ficar em .mcp.json:

{
  "mcpServers": {
    "airfield-directory": {
      "type": "http",
      "url": "https://airfield.directory/mcp"
    }
  }
}

Se preferir escopo de usuário, use a mesma entrada em ~/.claude.json.

Como uso com o ChatGPT?

O ChatGPT suporta servidores MCP remotos via modo desenvolvedor (beta). Isso está disponível para contas Pro, Plus, Business, Enterprise e Education na web.

  1. Vá para Configurações > Apps > Configurações avançadas e ative o Modo desenvolvedor.
  2. Clique em Criar app e insira a URL do servidor MCP: https://airfield.directory/mcp.
  3. Defina a autenticação como Nenhuma (o Airfield Directory é um servidor público somente leitura).
  4. Em um novo chat, clique em + no compositor, selecione Mais, depois escolha Modo desenvolvedor e ative o app Airfield Directory.

Alternativamente, você pode usar o Airfield Directory GPT. Esperamos melhores resultados ao usar MCP, mas este GPT também tem conexões diretas com a API do Airfield Directory para consultar dados diretamente.

Como uso com o OpenAI Codex?

A opção mais simples é:

codex mcp add airfield-directory --url https://airfield.directory/mcp

Você também pode configurá-lo manualmente em ~/.codex/config.toml ou .codex/config.toml:

[mcp_servers.airfield-directory]
url = "https://airfield.directory/mcp"

Como uso com o Google Gemini?

O aplicativo web do Gemini ainda não suporta servidores MCP personalizados. Você pode conectar via Gemini CLI adicionando isto a ~/.gemini/settings.json (escopo de usuário) ou .gemini/settings.json (escopo de projeto):

{
  "mcpServers": {
    "airfield-directory": {
      "httpUrl": "https://airfield.directory/mcp"
    }
  }
}

Dados, Licenciamento e Atribuição

De onde vêm os dados?

Nossos dados vêm de cinco fontes principais:

  1. Dados de aeródromos dos EUA da FAA, um trabalho do Governo dos EUA e em Domínio Público dos EUA (nenhuma atribuição necessária)
  2. Dados internacionais de aeródromos da OpenAIP, licenciados sob CC BY-NC 4.0
  3. Dados complementares de aeródromos do OpenFlightMaps, licenciados sob a Licença Geral de Usuários OFMA
  4. Dados de preços da Aerops, que são proprietários e não podem ser redistribuídos
  5. PIREPs da nossa comunidade de pilotos, licenciados sob CC BY-SA 4.0

Posso usar os dados para meus próprios projetos?

Depende de quais dados você deseja usar:

Dados de Aeródromos da FAA (Domínio Público dos EUA)

Dados de Aeródromos da OpenAIP (CC BY-NC 4.0)

  • Gratuito para uso não comercial
  • Não permitido para uso comercial
  • Atribuição obrigatória: "Os dados utilizados provêm do OpenAIP e estão licenciados sob a Licença Internacional Creative Commons Atribuição-NãoComercial 4.0. Visite https://www.openaip.net e contribua para melhores dados aeronáuticos, gratuitos para todos usarem e compartilharem." Verifique o site deles antes de reutilizar os dados.

Dados de Aeródromos do OpenFlightMaps (Licença Geral de Usuários OFMA)

  • Gratuito para uso comercial e não comercial com atribuição
  • Obrigatório: Atribuir o OpenFlightMaps como fonte e reportar erros de dados encontrados de volta à OFMA
  • Mais informações em https://openflightmaps.org/about/

Dados de Preços da Aerops

  • Não permitido para redistribuição (comercial ou não comercial)
  • Estes dados são protegidos por direitos autorais © Aerops e exibidos aqui com permissão
  • Sempre entre em contato diretamente com o FBO para obter preços atualizados

PIREPs da Comunidade (CC BY-SA 4.0)

  • Gratuito para qualquer uso, incluindo uso comercial
  • Pode ser modificado e redistribuído
  • Atribuição obrigatória: "Contribuições da comunidade do Airfield Directory (https://airfield.directory), licenciadas sob CC BY-SA 4.0. Você deve dar o devido crédito ao Autor e ao Airfield Directory, fornecer um link para a licença e indicar se foram feitas alterações."
  • Importante: Se você modificar ou criar obras derivadas dos PIREPs, deve distribuir seu trabalho sob a mesma licença CC BY-SA 4.0

Como devo atribuir os dados do Airfield Directory?

Se você usar dados da nossa API JSON, bucket S3 ou site, use uma das seguintes formas:

Atribuição completa (recomendada)

Dados do Airfield Directory (https://airfield.directory) e colaboradores da comunidade. Inclui: dados da FAA (Domínio Público dos EUA, https://adds-faa.opendata.arcgis.com/search?collection=dataset&tags=Airports), dados do OpenAIP (CC BY-NC 4.0, https://www.openaip.net), dados do OpenFlightMaps (Licença Geral de Usuários OFMA) e PIREPs da comunidade (CC BY-SA 4.0).

Atribuição curta (se o espaço for limitado)

Dados: Airfield Directory, FAA (Domínio Público dos EUA), OpenAIP (CC BY-NC 4.0), OpenFlightMaps (OFMA), Aerops, Comunidade (CC BY-SA 4.0)

Relatando Dados Incorretos

  • Para erros em dados de aeródromos dos EUA, reporte-os à FAA através do portal de dados abertos ADDS. Assim que o conjunto de dados upstream for corrigido, as atualizações fluem para o Airfield Directory na próxima importação noturna.
  • Para erros em dados aeronáuticos de aeródromos fora dos EUA, pesquise o aeródromo em https://www.openaip.net — ou clique no link "Fonte: OpenAIP" em qualquer página de aeródromo — e use o botão "Solicitar Alteração" para enviar uma correção diretamente. Você precisará de uma conta gratuita no OpenAIP para solicitar alterações. Assim que o OpenAIP aprovar a correção, ela será refletida automaticamente no Airfield Directory. Para aeródromos com fonte no OpenFlightMaps, reporte erros via https://openflightmaps.org.
  • Para erros de preços da Aerops, entre em contato diretamente com o Aeroporto/FBO. A propósito, os preços exibidos são armazenados em cache diariamente e podem estar desatualizados.
  • Para problemas com PIREPs, basta enviar um novo PIREP você mesmo com as informações corretas.
  • Para qualquer outra coisa (ex.: informações de contato), envie-nos um e-mail para info@airfield.directory.

Suporte, Jurídico e Privacidade

Como posso relatar problemas ou sugerir recursos?

Use o rastreador de problemas do GitHub para relatar problemas ou sugerir recursos. Agradecemos o feedback da comunidade.

Como meus dados pessoais são tratados?

Consulte nossa Política de Privacidade para obter informações detalhadas sobre o tratamento de dados.

Quais são os Termos de Serviço?

Você pode encontrar nossos Termos de Serviço completos na página Termos de Serviço.