Извлечь маски обнаружения

GET https://contrails.googleapis.com/v2/detections/masks : Получить маски обнаружения инверсионных следов в формате NetCDF4.

В случае успеха ответом будет файл NetCDF с масками обнаружения инверсионных следов. При желании в ответ можно также включить смещения времени сканирования.

Параметры запроса

Параметры
start_time

string

Обязательно. Время начала обработки запроса.

Формат: строка даты и времени ISO 8601

Пример: 2026-01-20T21:00:00Z

end_time

string

Обязательно. Время окончания запроса (включительно). Обратите внимание, что end_time не может превышать start_time более чем на 1 час.

Формат: строка даты и времени ISO 8601

Пример: 2026-01-20T22:00:00Z

satellite_origin

string

Обязательно. Допустимые значения: GOES-WEST-FULL-DISK , GOES-EAST-FULL-DISK , HIMAWARI-FULL-DISK и MTG-000-FULL-DISK , обозначающие спутники GOES_WEST, GOES_EAST, Himawari и MTG соответственно.

Формат: строка

Пример: "GOES-EAST-FULL-DISK"

view

DetectionMaskView

Необязательный параметр. По умолчанию используется значение DETECTION_MASK_VIEW_UNSPECIFIED . Если DETECTION_MASK_VIEW_FULL , в ответ будут включены полные смещения спутников на диске (в секундах).

Формат: см. документацию

Пример: DETECTION_MASK_VIEW_BASIC

Примеры

  • Для получения масок обнаружения со спутника за определенный момент времени с учетом смещения времени сканирования:

    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},
)

    или в 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"

    При загрузке с помощью xarray этот запрос возвращает следующий набор данных:

    Размеры: (время: 6, y: 5568, x: 5568)
    Координаты
    Имя Размеры Тип данных Ценности
    время (время) дата время64[нс] 2026-04-10T00:00:07 ... 2026-04-10T00:50:07
    й (y) float32 5.569e+06 5.567e+06 ... -5.569e+06
    х (x) float32 -5.569e+06 -5.567e+06 ... 5.569e+06
    Переменные данных
    маска (время, y, x) float32 0.0 0.0 0.0 0.0 ... 0.0 ...
    scantime_offset (время, y, x) float64 нан нан нан нан... 564. 568. ...
    проекция () DataArray +proj=geos +lon_0=0 +h=35786400 +x_0=0 +y_0=0 +a=6378137 +b=6356752.3 +units=m +no_defs

    Обратите внимание, что projection отображается в виде строки объекта pyproj.Proj .

    projection может использоваться для преобразования между координатами x и y карты и координатами долготы и широты.

DetectionMaskView

Определяет уровень детализации, возвращаемый для масок обнаружения.

Перечисления
DETECTION_MASK_VIEW_UNSPECIFIED Неуказанное представление. На практике это рассматривается как BASIC.
DETECTION_MASK_VIEW_BASIC Содержит значения маски обнаружения и данные спутниковой проекции.
DETECTION_MASK_VIEW_FULL Содержит значения маски обнаружения, данные спутниковой проекции и смещения времени сканирования всего диска.