Truy xuất mặt nạ phát hiện

GET https://contrails.googleapis.com/v2/detections/masks: Nhận mặt nạ phát hiện vệt mây do máy bay tạo ra ở định dạng NetCDF4.

Nếu thành công, phản hồi sẽ là một NetCDF của mặt nạ phát hiện vệt mây do máy bay tạo ra. Bạn cũng có thể đưa các độ lệch thời gian quét vào phản hồi (không bắt buộc).

Tham số truy vấn

Tham số
start_time

string

Bắt buộc. Thời gian bắt đầu của yêu cầu.

Định dạng: Chuỗi ngày giờ ISO 8601

Ví dụ: 2026-01-20T21:00:00Z
end_time

string

Bắt buộc. Thời gian kết thúc của yêu cầu (bao gồm cả thời gian này). Xin lưu ý rằng end_time không được vượt quá start_time quá 1 giờ.

Định dạng: Chuỗi ngày giờ ISO 8601

Ví dụ: 2026-01-20T22:00:00Z
satellite_origin

string

Bắt buộc. Các giá trị hợp lệ là GOES-WEST-FULL-DISK, GOES-EAST-FULL-DISK, HIMAWARI-FULL-DISK và MTG-000-FULL-DISK, lần lượt đại diện cho các vệ tinh GOES_WEST, GOES_EAST, Himawari và MTG.

Định dạng: chuỗi

Ví dụ: "GOES-EAST-FULL-DISK"
view

DetectionMaskView

Không bắt buộc. Giá trị mặc định là DETECTION_MASK_VIEW_UNSPECIFIED. Nếu DETECTION_MASK_VIEW_FULL, sẽ bao gồm các độ lệch vệ tinh toàn đĩa (tính bằng giây) trong phản hồi.

Định dạng: xem tài liệu

Ví dụ: DETECTION_MASK_VIEW_BASIC

Ví dụ

  • Cách truy xuất mặt nạ phát hiện từ một vệ tinh cho một thời điểm cụ thể có độ lệch thời gian quét:

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

    hoặc trong 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"

    Khi được tải bằng xarray, yêu cầu này sẽ trả về tập dữ liệu sau:

    Kích thước: (time: 6, y: 5568, x: 5568)
    Tọa độ
    Tên Kích thước Loại dữ liệu Giá trị
    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
    Biến dữ liệu
    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

    Xin lưu ý rằng projection được định dạng dưới dạng chuỗi của đối tượng pyproj.Proj.

    Bạn có thể sử dụng projection để chuyển đổi giữa toạ độ x, y trên bản đồ và toạ độ kinh độ, vĩ độ.

DetectionMaskView

Xác định mức độ chi tiết cần trả về cho mặt nạ phát hiện.

Enum
DETECTION_MASK_VIEW_UNSPECIFIED Chế độ xem không xác định. Trên thực tế, chế độ này được coi là BASIC.
DETECTION_MASK_VIEW_BASIC Chứa các giá trị mặt nạ phát hiện và dữ liệu phép chiếu vệ tinh.
DETECTION_MASK_VIEW_FULL Chứa các giá trị mặt nạ phát hiện, dữ liệu phép chiếu vệ tinh và độ lệch thời gian quét toàn đĩa.