Pobieranie masek wykrywania

GET https://contrails.googleapis.com/v2/detections/masks: Pobierz maski wykrywania śladów kondensacyjnych w formacie NetCDF4.

Jeśli operacja się uda, odpowiedź będzie zawierać plik NetCDF z maskami wykrywania smug kondensacyjnych.

Parametry zapytania

Parametry
start_time

string

Wymagane. Czas rozpoczęcia żądania.

Format: ciąg znaków daty i godziny w formacie ISO 8601

Przykład: 2026-01-20T21:00:00Z
end_time

string

Wymagane. Czas zakończenia żądania (włącznie z wartościami granicznymi). Pamiętaj, że end_time nie może przekraczać start_time o więcej niż godzinę.

Format: ciąg znaków daty i godziny w formacie ISO 8601

Przykład: 2026-01-20T22:00:00Z
satellite_origin

string

Opcjonalnie. Prawidłowe wartości to GOES-EAST-FULL-DISK, HIMAWARI-FULL-DISK i MTG-000-FULL-DISK, które oznaczają odpowiednio satelity GOES_EAST, Himawari i MTG.

Format: ciąg znaków

Przykład: "GOES-EAST-FULL-DISK"

Przykłady

  • Aby pobrać maski wykrywania z satelity dla określonego momentu:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/detections/masks",
  params={"start_time": "2026-04-10T00:00:00Z",
          "end_time": "2026-04-10T01:00:00Z",
          "satellite_origin": "MTG-000-FULL-DISK"},
  headers={"x-goog-api-key": API_KEY},
)

    lub w CURL:

    curl "https://contrails.sandbox.googleapis.com/v2/detections/masks?\
key=API_KEY&\
start_time=2026-04-10T00:00:00Z&\
end_time=2026-04-10T01:00:00Z&\
satellite_origin=MTG-000-FULL-DISK"

    Po wczytaniu za pomocą biblioteki xarray to żądanie zwraca ten zbiór danych:

    Wymiary: (time: 6, y: 5568, x: 5568)
    Współrzędne
    Nazwa Wymiary Typ danych Wartości
    czas (czas) datetime64[ns] 2026-04-10T00:00:07 ... 2026-04-10T00:50:07
    y (y) float32 5,569e+06 5,567e+06 ... -5,569e+06
    x (x) float32 -5,569e+06 -5,567e+06 ... 5,569e+06
    Zmienne danych
    maska (godzina, y, x) float32 0.0 0.0 0.0 0.0 ... 0.0 ...
    projekcja, () DataArray +proj=geos +lon_0=0 +h=35786400 +x_0=0 +y_0=0 +a=6378137 +b=6356752.3 +units=m +no_defs

    Pamiętaj, że projection jest sformatowany jako ciąg znaków obiektu pyproj.Proj.

    projection może służyć do konwertowania współrzędnych mapy x, y na współrzędne długości i szerokości geograficznej.