Dowiedz się, co możesz tworzyć za pomocą interfejsu Contrails API, i poznaj działanie jego punktów końcowych.
Przegląd
Contrails API łączy dane pogodowe na dużą skalę, dane o lotach i zdjęcia satelitarne z najnowocześniejszym modelem rozpoznawania obrazów, aby generować prognozy dotyczące śladów kondensacyjnych oparte na AI. Prognozy te wskazują strefy, w których prawdopodobnie powstaną smugi kondensacyjne, oraz potencjalny wpływ tych smug w ciągu najbliższych 48 godzin.
Zintegrowanie tych prognoz z procesami planowania lotów może pomóc pilotom unikać przelotów przez te regiony, co zapobiegnie powstawaniu smug kondensacyjnych, które przyczyniają się do ocieplenia.
Aby zrozumieć, gdzie powstaną smugi kondensacyjne i jak bardzo będą się przyczyniać do ocieplenia, interfejs Contrails API udostępnia prognozy w postaci siatek i regionów.
Prognozy
Interfejs Contrails API udostępnia prognozy w postaci:
Siatki: dane 4D o wysokiej wierności reprezentujące wartości indeksu wymuszania smug kondensacyjnych na osiach szerokości i długości geograficznej, wysokości i czasu w formacie NetCDF. Te siatki reprezentują cały glob w postaci siatki o rozdzielczości 0,25 stopnia, w której kroki szerokości i długości geograficznej wynoszą 0,25 stopnia. Prognoza dla każdej siatki jest tworzona na całą godzinę (UTC).
Wartości indeksu wymuszania smug kondensacyjnych wahają się od 0, co oznacza lokalizację bez znaczącego ocieplenia, do 4, co oznacza lokalizację z silnym ociepleniem spowodowanym przez smugi kondensacyjne.
Siatki są zalecane w przypadku zautomatyzowanego planowania lotów, zwłaszcza zmiany trasy.
Regiony: uproszczona, sprowadzona do wielokątów wersja prognozy, która przedstawia regiony, w których należy unikać tworzenia śladów kondensacyjnych, w formacie GeoJSON multipolygon.
Regiony, w których należy unikać śladów kondensacyjnych, są oceniane na tych samych poziomach ważności, ale pomijają wartość 0 i zaczynają się od 1 (niewielki wpływ).
Regiony są zalecane dla planistów lotów załogowych, którzy mogą ustalać zasady na podstawie poziomów ważności i ręcznie zmieniać trasy lotów, zwykle poprzez odchylenia pionowe (czyli dostosowywanie poziomów lotu).
Uwierzytelnianie
Aby korzystać z interfejsu Contrails API, musisz mieć klucz interfejsu API i włączyć interfejs Contrails API.
Szczegółowe informacje znajdziesz w przewodniku konfigurowania środowiska.
Błędy
Podczas korzystania z interfejsu Contrails API możesz napotkać te błędy:
| Kod | Przyczyna | Obsługa błędów |
|---|---|---|
| 400 (nieprawidłowe żądania) | Żądanie z nieprawidłowymi danymi | Nie próbuj ponownie automatycznie. Ten błąd jest spowodowany problemami w kodzie. Sprawdź, czy używasz prawidłowego formatu parametru. |
| 404 | Prośba o prognozę dla czasu, dla którego nie została jeszcze obliczona | Ponów próbę, stosując strategię wzrastającego czasu do ponowienia. |
| 429 | Zbyt wiele żądań (patrz Limity wykorzystania) | Ponów próbę ze wzrastającym czasem do ponowienia. |
| 5XX | Błąd serwera | Ponów próbę ze wzrastającym czasem do ponowienia. |
Obsługa wersji
Wydania głównych wersji, np. wprowadzenie v2, mogą wprowadzać zachowania niezgodne z poprzednimi wersjami i wymagać zmian w kodzie.
Regularne aktualizacje między wydaniami głównych wersji powinny być wstecznie zgodne.
Najważniejsze aktualizacje znajdziesz w informacjach o wersji interfejsu Contrails API.
Co dalej?
- Aby zacząć korzystać z interfejsu Contrails API, skonfiguruj środowisko.
- Szczegółowe wskazówki dotyczące dostępnych metod interfejsu Contrails API znajdziesz w dokumentacji referencyjnej interfejsu Contrails API.
- Przeczytaj przegląd prognozowania śladów kondensacyjnych, aby dowiedzieć się, jak są obliczane prognozy interfejsu Contrails API.