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. Opcjonalnie w odpowiedzi można też uwzględnić przesunięcia czasu skanowania.

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

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

Format: ciąg znaków

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

DetectionMaskView

Opcjonalnie. Domyślna wartość to DETECTION_MASK_VIEW_UNSPECIFIED. Jeśli DETECTION_MASK_VIEW_FULL, w odpowiedzi zostaną uwzględnione pełne przesunięcia satelitarne dysku (w sekundach).

Format: patrz dokumentacja

Przykład: DETECTION_MASK_VIEW_BASIC

Przykłady

  • Aby pobrać maski wykrywania z satelity dla określonego momentu z przesunięciami czasu skanowania:

    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"
          "view": "DETECTION_MASK_VIEW_FULL"},
  headers={"x-goog-api-key": API_KEY},
)

    lub w CURL:

    curl "https://contrails.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&\
view=DETECTION_MASK_VIEW_FULL"

    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 ...
    scantime_offset (godzina, y, x) float64 nan nan nan nan ... 564. 568. …
    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 sformatowane 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.

DetectionMaskView

Określa poziom szczegółowości masek wykrywania, które mają być zwracane.

Wartości w polu enum
DETECTION_MASK_VIEW_UNSPECIFIED Nieokreślony widok. W praktyce jest to traktowane jako BASIC.
DETECTION_MASK_VIEW_BASIC Zawiera wartości maski wykrywania i dane projekcji satelitarnej.
DETECTION_MASK_VIEW_FULL Zawiera wartości maski wykrywania, dane projekcji satelitarnej i przesunięcia czasu skanowania całej tarczy.