Pobieranie regionów prognozy

GET https://contrails.googleapis.com/v2/regions: Pobierz regiony unikania śladów kondensacyjnych w formacie GeoJSON multipolygon.

Jeśli operacja się uda, odpowiedź będzie miała postać FeatureCollection w formacie GeoJSON.

Zwrócone regiony unikania śladów kondensacyjnych w formacie wielokąta są oceniane według poziomów ważności, od 1 do 4 dla każdego poziomu lotu. Im wyższa wartość, tym poważniejszy ślad kondensacyjny.

Parametry zapytania

Parametry
time

string

Wymagane. Czas przesłania żądania.

Format: ciąg daty i godziny w formacie ISO 8601 LUB liczba całkowita epoki systemu Unix

Przykład: 2026-01-20T21:00:00Z
flightLevel[]

integer

Opcjonalnie. Poziomy lotu do zwrócenia. Jeśli nie podasz poziomu lotu, zostaną uwzględnione wszystkie poziomy.

Format: poziomy lotu w hektostopach; [270, 280, 290, 300, 310, 320, 330, 340, 350, 360, 370, 380, 390, 400, 410, 420, 430, 440]

Przykład: [270, 280, 290, 300]
threshold

integer

Opcjonalnie. Minimalny próg poziomu ważności. Ustawienie tego pola powoduje zwracanie tylko regionów o stopniu nasilenia większym lub równym progowi.

Format: prawidłowe wartości to od 1 do 4 (włącznie).
aircraftClass

string

Opcjonalnie. Klasa samolotu. Obecnie obsługiwana jest tylko forma default.

Przykłady

  • Aby pobrać wszystkie regiony unikania śladów kondensacyjnych dla określonego momentu:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/regions",
  params={"time": 2026-01-27T12:00:00Z},
  headers={"x-goog-api-key": API_KEY},
)

    Odpowiedź GeoJSON zawiera listę wszystkich regionów, w których należy unikać śladów kondensacyjnych, w formacie wielokąta:

    geometria, flight_level próg czas forecast_reference_time aircraft_class
    0 MULTIPOLYGON Z (((166.25 81.12 8229.6, 168.37 ... 270 1 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 domyślna
    1 MULTIPOLYGON Z (((92.38 45.5 8229.6, 93 46.62 ... 270 2 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 domyślna
    2 MULTIPOLYGON Z (((83.38 65 8229.6, 84 66.12 82... 270 3 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 domyślna
    3 MULTIPOLYGON Z (((57.38 76 8229.6, 57.75 76.88... 270 4 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 domyślna
    4 MULTIPOLYGON Z (((162.38 79 8534.4, 162.75 79.... 280 1 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 domyślna

  • Aby pobrać regiony, w których należy unikać śladów kondensacyjnych, ograniczone do określonych poziomów lotu, z czasem podanym jako liczba całkowita epoki systemu Unix:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/regions",
  params={
    "time": 1768942800,
    "flightLevel": [300,310,320,330]
  },
  headers={"x-goog-api-key": API_KEY},
)

  • Aby pobrać regiony, w których należy unikać śladów kondensacyjnych, ograniczone do określonych poziomów lotu i o poziomie ważności równym lub wyższym niż 3:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/regions",
  params={
    "time": 2026-01-27T12:00:00Z,
    "flightLevel": [300,310,320,330],
    "threshold": 3
  },
  headers={"x-goog-api-key": API_KEY},
)