ดึงข้อมูลมาสก์การตรวจจับ

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 คำขอนี้จะแสดงชุดข้อมูลต่อไปนี้

    ขนาด: (time: 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

กำหนดระดับรายละเอียดที่จะแสดงสำหรับมาสก์การตรวจจับ

Enum
DETECTION_MASK_VIEW_UNSPECIFIED มุมมองที่ไม่ได้ระบุ ในทางปฏิบัติ ระบบจะถือว่าเป็นการตั้งค่าพื้นฐาน
DETECTION_MASK_VIEW_BASIC มีค่ามาสก์การตรวจจับและข้อมูลการฉายภาพดาวเทียม
DETECTION_MASK_VIEW_FULL ประกอบด้วยค่ามาสก์การตรวจจับ ข้อมูลการฉายภาพดาวเทียม และออฟเซ็ตเวลาสแกนดิสก์เต็ม