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 phản lực ở định dạng NetCDF4.

Nếu thành công, phản hồi sẽ là một NetCDF gồm các mặt nạ phát hiện vệt khói.

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

Không bắt buộc. Các giá trị hợp lệ là 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_EAST, Himawari và MTG.

Định dạng: chuỗi

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

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ể:

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

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

    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 (thời gian) 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
    đeo-khẩu-trang (time, y, x) float32 0.0 0.0 0.0 0.0 ... 0.0 ...
    phép chiếu () 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 dạng chuỗi của đối tượng pyproj.Proj.

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