Explora lo que puedes compilar con la API de Contrails y comprende cómo se comportan sus extremos.
Descripción general
La API de Contrails combina datos meteorológicos a gran escala, datos de vuelos e imágenes satelitales con un modelo de visión artificial de vanguardia para producir predicciones de estelas potenciadas por IA. Estas predicciones pronostican las zonas propensas a la formación de estelas y el posible impacto de las estelas durante las próximas 48 horas.
Integrar estas predicciones en los flujos de trabajo de planificación de vuelos puede ayudar a los pilotos a evitar volar por estas regiones, lo que impide la creación de estelas de condensación que calientan el planeta.
Para comprender estas estadísticas sobre dónde se formarán las estelas de condensación y cuánto calentamiento producirán, la API de Contrails ofrece previsiones como cuadrículas y regiones.
Previsiones
La API de Contrails ofrece previsiones de la siguiente manera:
Grillas: Datos en 4D de alta fidelidad que representan los valores del índice de forzamiento de estelas de condensación en los ejes de latitud, longitud, altitud y tiempo, en formato NetCDF. Estas cuadrículas representan todo el globo como una cuadrícula de un cuarto de grado, en la que los pasos de latitud y longitud son de 0.25 grados. Cada cuadrícula se prevé para una hora completa (UTC).
Los valores del índice de forzamiento de estelas de condensación varían de 0, que representa una ubicación sin calentamiento significativo, a 4, que representa una ubicación con calentamiento grave por estelas de condensación.
Se recomiendan las cuadrículas para la planificación de vuelos programática, en especial para los vuelos con cambio de ruta.
Regiones: Versión simplificada y poligonalizada del pronóstico, que representa las regiones de evitación de estelas de condensación en formato de multipolígonos GeoJSON.
Las regiones de evitación de estelas se califican con los mismos niveles de gravedad, pero omiten el 0 y solo comienzan en 1 (impacto leve).
Se recomiendan las regiones para los planificadores de vuelos humanos que pueden establecer políticas basadas en niveles de gravedad y desviar manualmente los vuelos, por lo general, a través de desviaciones verticales (es decir, ajustando los niveles de vuelo).
Autenticación
Para usar la API de Contrails, necesitas una clave de API y debes habilitar la API de Contrails.
Para obtener más información, sigue la guía de configuración de tu entorno.
Errores
Cuando uses la API de Contrails, es posible que te encuentres con los siguientes errores:
| Código | Causa | Manejo de errores |
|---|---|---|
| 400 (solicitudes no válidas) | Solicitud con datos incorrectos | No volver a intentar automáticamente. Este error se debe a problemas en el código. Verifica que estés usando el formato de parámetro correcto. |
| 404 | Solicitud de un período de previsión que aún no se calculó | Vuelve a intentarlo con una estrategia de retirada exponencial. |
| 429 | Demasiadas solicitudes (consulta Límites de uso) | Vuelve a intentarlo con una retirada exponencial. |
| 5XX | Error de servidor | Vuelve a intentarlo con una retirada exponencial. |
Control de versiones
Los lanzamientos de versiones principales, como el lanzamiento de v2, pueden introducir un comportamiento incompatible con los lanzamientos anteriores y pueden requerir cambios en el código.
Se espera que las actualizaciones periódicas entre las versiones principales sean retrocompatibles.
Puedes leer sobre las actualizaciones clave en las notas de la versión de la API de Contrails.
¿Qué sigue?
- Para comenzar a usar la API de Contrails, configura tu entorno.
- Lee la documentación de referencia de la API de Contrails para obtener orientación detallada sobre los métodos disponibles de la API de Contrails.
- Lee la descripción general de la previsión de estelas de condensación para comprender cómo se calculan las previsiones de la API de Contrails.