Mengambil masker deteksi

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

Jika berhasil, responsnya akan berupa NetCDF masker deteksi contrail.

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

Opsional. Nilai yang valid adalah GOES-EAST-FULL-DISK, HIMAWARI-FULL-DISK, dan MTG-000-FULL-DISK, yang masing-masing mewakili satelit GOES_EAST, Himawari, dan MTG.

Format: string

Contoh: "GOES-EAST-FULL-DISK"

Contoh

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

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

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

    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 ...
    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.