Mengambil masker deteksi

GET https://contrails.googleapis.com/v2/detections/masks: Mendapatkan masker deteksi jejak kondensasi dalam format NetCDF4.

Jika berhasil, responsnya akan berupa NetCDF masker deteksi jejak kondensasi. Secara opsional, offset waktu pemindaian juga dapat disertakan dalam respons.

Catatan: Masker deteksi MTG masih dalam versi beta dan dapat berubah sewaktu-waktu.

Parameter kueri

Parameter
start_time	string Wajib. Waktu mulai permintaan. Format: String datetime ISO 8601 Contoh: 2026-01-20T21:00:00Z
end_time	string Wajib. Waktu berakhir permintaan (inklusif). Perhatikan bahwa end_time tidak boleh melebihi start_time lebih dari 1 jam. Format: String datetime ISO 8601 Contoh: 2026-01-20T22:00:00Z
satellite_origin	string Wajib. Nilai yang valid adalah GOES-WEST-FULL-DISK, GOES-EAST-FULL-DISK, HIMAWARI-FULL-DISK, dan MTG-000-FULL-DISK, yang masing-masing mewakili satelit GOES_WEST, GOES_EAST, Himawari, dan MTG. Format: string Contoh: "GOES-EAST-FULL-DISK"
view	DetectionMaskView Opsional. Default-nya adalah DETECTION_MASK_VIEW_UNSPECIFIED. Jika DETECTION_MASK_VIEW_FULL, akan menyertakan offset satelit cakram penuh (dalam detik) dalam respons. Format: lihat dokumentasi Contoh: DETECTION_MASK_VIEW_BASIC

Contoh

• Untuk mengambil masker deteksi dari satelit untuk titik waktu tertentu dengan offset waktu pemindaian:

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

  atau di 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"
  

  Saat dimuat dengan xarray, permintaan ini akan menampilkan set data berikut:

  Dimensi: (time: 6, y: 5568, x: 5568)
  Koordinat
  Nama	Dimensi	Jenis Data	Nilai
  time	(time)	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
  Variabel data
  mask	(time, y, x)	float32	0.0 0.0 0.0 0.0 ... 0.0 ...
  scantime_offset	(time, y, x)	float64	nan nan nan nan ... 564. 568. ...
  projection	()	DataArray	+proj=geos +lon_0=0 +h=35786400 +x_0=0 +y_0=0 +a=6378137 +b=6356752.3 +units=m +no_defs

  Perhatikan bahwa projection diformat sebagai bentuk string dari objek pyproj.Proj.

  projection dapat digunakan untuk mengonversi antara koordinat x, y peta dan koordinat bujur, lintang.

DetectionMaskView

Menentukan tingkat detail yang akan ditampilkan untuk masker deteksi.

Enum
DETECTION_MASK_VIEW_UNSPECIFIED	Tampilan tidak ditentukan. Dalam praktiknya, ini diperlakukan sebagai BASIC.
DETECTION_MASK_VIEW_BASIC	Berisi nilai masker deteksi dan data proyeksi satelit.
DETECTION_MASK_VIEW_FULL	Berisi nilai masker deteksi, data proyeksi satelit, dan offset waktu pemindaian cakram penuh.