Hier erfahren Sie, was Sie mit der Contrails API entwickeln können und wie sich die Endpunkte verhalten.
Übersicht
Die Contrails API kombiniert groß angelegte Wetterdaten, Flugdaten und Satellitenbilder mit einem hochmodernen Computer Vision-Modell, um KI-basierte Vorhersagen zu Kondensstreifen zu erstellen. Diese Vorhersagen geben Aufschluss über Zonen, in denen mit Kondensstreifen zu rechnen ist, und über die potenziellen Auswirkungen von Kondensstreifen in den nächsten 48 Stunden.
Wenn diese Vorhersagen in die Workflows für die Flugplanung integriert werden, können Piloten diese Regionen umfliegen und so die Bildung von erwärmenden Kondensstreifen verhindern.
Um diese Informationen darüber zu erhalten, wo sich Kondensstreifen bilden und wie stark sie die Erderwärmung beeinflussen, bietet die Contrails API Vorhersagen als Raster und Regionen.
Prognosen
Die Contrails API bietet Vorhersagen als:
Grids:Hochwertige 4D-Daten, die Werte für den Index für die Erwärmung durch Kondensstreifen auf Achsen für Breitengrad, Längengrad, Höhe und Zeit im NetCDF-Format darstellen. Diese Raster stellen die gesamte Erde als Viertelgrad-Raster dar, in dem die Breiten- und Längengradschritte 0,25 Grad betragen. Jedes Raster wird für eine volle Stunde (UTC) prognostiziert.
Die Werte für den Index für die Erwärmung durch Kondensstreifen reichen von 0 (keine signifikante Erwärmung) bis 4 (starke Erwärmung).
Grids werden für die programmatische Flugplanung empfohlen, insbesondere für die Umleitung von Flügen.
Regionen:Vereinfachte, polygonisierte Version der Vorhersage, die Regionen zur Vermeidung von Kondensstreifen im GeoJSON-Multipolygon-Format darstellt.
Regionen zur Vermeidung von Kondensstreifen werden mit denselben Schweregraden bewertet, wobei jedoch 0 ausgelassen wird und die Skala erst bei 1 (geringe Auswirkungen) beginnt.
Regionen werden für menschliche Flugplaner empfohlen, die Richtlinien basierend auf Schweregraden festlegen und Flüge manuell umleiten können, in der Regel durch vertikale Abweichungen (d.h. durch Anpassen der Flughöhen).
Authentifizierung
Um die Contrails API zu verwenden, benötigen Sie einen API-Schlüssel und müssen die Contrails API aktivieren.
Eine Anleitung finden Sie im Leitfaden zum Einrichten der Umgebung.
Fehler
Bei der Verwendung der Contrails API können die folgenden Fehler auftreten:
| Code | Ursache | Fehlerbehandlung |
|---|---|---|
| 400 (ungültige Anfragen) | Anfrage mit falschen Daten | Nicht automatisch wiederholen. Dieser Fehler wird durch Probleme im Code verursacht. Prüfen Sie, ob Sie das richtige Parameterformat verwenden. |
| 404 | Vorhersagezeitraum anfordern, der noch nicht berechnet wurde | Wiederholen Sie den Vorgang mit einer Strategie für exponentiellen Backoff. |
| 429 | Zu viele Anfragen (siehe Nutzungslimits) | Wiederholen Sie den Vorgang mit exponentiellem Backoff. |
| 5XX | Serverfehler | Wiederholen Sie den Vorgang mit exponentiellem Backoff. |
Versionsverwaltung
Bei der Veröffentlichung von Hauptversionen, z. B. bei der Einführung von v2, kann es zu Verhaltensweisen kommen, die mit früheren Versionen inkompatibel sind. In diesem Fall sind möglicherweise Codeänderungen erforderlich.
Regelmäßige Updates zwischen Hauptversionsreleases sind abwärtskompatibel.
Wichtige Updates finden Sie in den Versionshinweisen zur Contrails API.
Nächste Schritte
- Richten Sie Ihre Umgebung ein, um die Contrails API zu verwenden.
- In der Contrails API-Referenzdokumentation finden Sie detaillierte Informationen zu den verfügbaren Contrails API-Methoden.
- In der Übersicht über die Contrails API-Prognosen erfahren Sie, wie die Prognosen der Contrails API berechnet werden.