擷取偵測遮罩

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)
    座標
    名稱 尺寸 資料類型 值
    時間 (時間) 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
    資料變數
    掩蓋 (時間、y、x) float32 0.0 0.0 0.0 0.0 ... 0.0 ...
    scantime_offset (時間、y、x) float64 nan nan nan nan ... 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 包含偵測遮罩值、衛星投影資料和完整磁碟掃描時間偏移。