Présentation de l'API Contrails

Découvrez ce que vous pouvez créer avec l'API Contrails et comprenez le comportement de ses points de terminaison.

Présentation

L'API Contrails combine des données météorologiques, des données de vol et des images satellite à grande échelle avec un modèle de vision par ordinateur de pointe pour générer des prédictions de traînées de condensation basées sur l'IA. Ces prévisions indiquent les zones où des traînées de condensation sont susceptibles de se former et leur impact potentiel pour les 48 heures à venir.

L'intégration de ces prévisions dans les workflows de planification des vols peut aider les pilotes à éviter de survoler ces régions, ce qui empêche la formation de traînées de condensation réchauffantes.

Pour comprendre où les traînées de condensation se formeront et leur impact sur le réchauffement, l'API Contrails propose des prévisions sous forme de grilles et de régions.

Prévisions

L'API Contrails propose des prévisions sous les formats suivants :

  • Grilles : données 4D haute fidélité représentant les valeurs de l'indice de forçage des traînées de condensation sur les axes de latitude, de longitude, d'altitude et de temps, au format NetCDF. Ces grilles représentent le globe entier sous la forme d'une grille d'un quart de degré, dans laquelle les pas de latitude et de longitude sont de 0,25 degré. Chaque grille est prévue pour une heure complète (UTC).

    Les valeurs de l'indice de forçage des traînées de condensation vont de 0 (zone sans réchauffement important) à 4 (zone de fort réchauffement dû aux traînées de condensation).

    Les grilles sont recommandées pour la planification programmatique des vols, en particulier pour les vols avec changement de route.

  • Régions : version simplifiée et polygonisée des prévisions, représentant les régions d'évitement des traînées de condensation au format multipolygone GeoJSON.

    Les régions d'évitement des traînées de condensation sont évaluées avec les mêmes niveaux de gravité, mais omettent le niveau 0 et ne commencent qu'au niveau 1 (impact léger).

    Les régions sont recommandées pour les planificateurs de vols humains qui peuvent établir des règles basées sur les niveaux de gravité et peuvent modifier manuellement l'itinéraire des vols, généralement par le biais de déviations verticales (c'est-à-dire en ajustant les niveaux de vol).

    Visualisation de l'explorateur de traînées de condensation des régions prévues au-dessus de certaines parties de l'Europe, avec la région de prévention des traînées de condensation sélectionnée (niveau de vol maximal de 340 et niveau de vol minimal de 310).

Authentification

Pour utiliser l'API Contrails, vous avez besoin d'une clé API et vous devez activer l'API Contrails.

Pour en savoir plus, suivez le guide de configuration de votre environnement.

Erreurs

Lorsque vous utilisez l'API Contrails, vous pouvez rencontrer les erreurs suivantes :

Code Cause Gestion des exceptions
400 (requêtes non valides) Demande avec des données incorrectes Ne pas réessayer automatiquement. Cette erreur est due à des problèmes dans le code. Vérifiez que vous utilisez le bon format de paramètre.
404 Demander une période de prévision qui n'a pas encore été calculée Réessayez avec une stratégie d'intervalle exponentiel entre les tentatives.
429 Trop de requêtes (consultez Limites d'utilisation) Réessayer avec un intervalle exponentiel entre les tentatives
5XX Erreur du serveur Réessayer avec un intervalle exponentiel entre les tentatives

Gestion des versions

Les versions majeures, comme le lancement de la v2, peuvent introduire un comportement incompatible avec les versions précédentes et nécessiter des modifications du code.

Les mises à jour régulières entre les versions majeures sont censées être rétrocompatibles.

Vous pouvez en savoir plus sur les principales mises à jour dans les notes de version de l'API Contrails.

Étape suivante