Saiba o que você pode criar com a API Contrails e entenda o comportamento dos endpoints dela.
Visão geral
A API Contrails combina dados meteorológicos em grande escala, dados de voos e imagens de satélite com um modelo de visão computacional de última geração para produzir previsões de rastros de condensação com tecnologia de IA. Essas previsões indicam zonas com probabilidade de formação de rastros de condensação e o possível impacto deles nas próximas 48 horas.
A integração dessas previsões aos fluxos de trabalho de planejamento de voos pode ajudar os pilotos a evitar voar por essas regiões, impedindo a criação de rastros de condensação que causam aquecimento.
Para entender esses insights de onde os rastros de condensação vão se formar e o quanto eles vão aquecer, a API Contrails oferece previsões como grades e regiões.
Previsões
A API Contrails oferece previsões como:
Grades:dados 4D de alta fidelidade que representam valores de índice de forçante de rastros de condensação em eixos de latitude, longitude, altitude e tempo, no formato NetCDF. Essas grades representam o globo inteiro como uma grade de um quarto de grau, em que as etapas de latitude e longitude são de 0,25 grau. Cada grade é prevista para uma hora completa (UTC).
Os valores do índice de forçante de esteira de condensação variam de 0, representando um local sem aquecimento significativo, a 4, representando um local de aquecimento grave de esteira de condensação.
As grades são recomendadas para o planejamento de voos programático, principalmente para voos com redirecionamento.
Regiões:versão simplificada e poligonizada da previsão, representando regiões de prevenção de rastros de condensação no formato multipolígono GeoJSON.
As regiões de prevenção de rastros de condensação são classificadas com os mesmos níveis de gravidade, mas omitem o 0 e começam apenas no 1 (impacto leve).
As regiões são recomendadas para planejadores de voos humanos que podem estabelecer políticas com base em níveis de gravidade e redirecionar voos manualmente, geralmente por desvios verticais (ou seja, ajustando os níveis de voo).
Autenticação
Para usar a API Contrails, você precisa de uma chave de API e ativar a API Contrails.
Para mais detalhes, siga o guia de configuração do ambiente.
Erros
Ao usar a API Contrails, você pode encontrar os seguintes erros:
| Código | Causa | Tratamento de erros |
|---|---|---|
| 400 (solicitações inválidas) | Solicitação com dados incorretos | Não tente de novo automaticamente. Esse erro é causado por problemas no código. Verifique se você está usando o formato de parâmetro correto. |
| 404 | Solicitação de um período de previsão que ainda não foi calculado | Tente de novo com uma estratégia de espera exponencial. |
| 429 | Excesso de solicitações (consulte Limites de uso) | Tentar novamente com a espera exponencial. |
| 5XX | Erro de servidor | Tentar novamente com a espera exponencial. |
Controle de versões
As versões principais, como o lançamento da v2, podem introduzir um comportamento incompatível com as versões anteriores e exigir mudanças no código.
Espera-se que as atualizações regulares entre lançamentos de versões principais sejam compatíveis com versões anteriores.
Leia sobre as principais atualizações nas notas da versão da API Contrails.
A seguir
- Para começar a usar a API Contrails, configure seu ambiente.
- Leia a documentação de referência da API Contrails para orientações detalhadas sobre os métodos disponíveis da API Contrails.
- Leia a visão geral da previsão de contrails para entender como as previsões da API Contrails são calculadas.