เรียกข้อมูลการตรวจหา

GET https://contrails.googleapis.com/v2/detections: รับการตรวจจับคอนเทรล ในรูปแบบ GeoJSON LineString

หากสำเร็จ การตอบกลับจะเป็น FeatureCollection ในรูปแบบ GeoJSON โปรดทราบว่าอาจมีการส่งคืน FeatureCollection ที่ว่างเปล่าหากช่วงเวลาอยู่นอกขอบเขต (เช่น การค้นหาร่องรอยที่ตรวจพบในอนาคต) นอกจากนี้ การตรวจจับอาจไม่สอดคล้องกันเนื่องจากโมเดลการตรวจจับได้รับการอัปเดตและมีการทดแทนข้อมูลย้อนหลัง

พารามิเตอร์การค้นหา

พารามิเตอร์
start_time	string ต้องระบุ เวลาเริ่มต้นของคำขอ รูปแบบ: สตริงวันที่และเวลา ISO 8601 ตัวอย่าง: 2026-01-20T21:00:00Z
end_time	string ต้องระบุ เวลาสิ้นสุดของคำขอ (รวมเวลาสิ้นสุด) โปรดทราบว่า end_time ต้องไม่เกิน start_time มากกว่า 24 ชั่วโมง รูปแบบ: สตริงวันที่และเวลา ISO 8601 ตัวอย่าง: 2026-01-20T22:00:00Z
satellite_origins[]	string ไม่บังคับ ค่าที่ใช้ได้คือ GOES-EAST-FULL-DISK, HIMAWARI-FULL-DISK และ MTG-000-FULL-DISK ซึ่งแสดงถึงดาวเทียม GOES_EAST, Himawari และ MTG ตามลำดับ หากระบุไว้ ปลายทางนี้จะแสดงเฉพาะคอนเทรลที่ตรวจพบจากดาวเทียมที่ระบุภายใน satellite_origins เท่านั้น หากไม่ได้ระบุ ระบบจะแสดงคอนเทรลที่ตรวจพบจากผู้ให้บริการข้อมูลดาวเทียมที่เกี่ยวข้องทั้งหมด รูปแบบ: อาร์เรย์สตริง ตัวอย่าง: ["GOES-EAST-FULL-DISK", "HIMAWARI-FULL-DISK"]

ตัวอย่าง

• วิธีดึงข้อมูลการตรวจจับคอนเทรลทั้งหมดสำหรับช่วงเวลาที่เฉพาะเจาะจง

  response = requests.get(
    url="https://contrails.googleapis.com/v2/detections",
    params={"start_time": "2026-01-27T12:00:00Z",
            "end_time": "2026-01-27T12:10:00Z"},
    headers={"x-goog-api-key": API_KEY},
  )
  

• หากต้องการดึงข้อมูลการตรวจจับคอนเทรล ณ จุดเวลาที่เฉพาะเจาะจง โดยจำกัดเฉพาะการตรวจจับของ Himawari ให้ทำดังนี้

  response = requests.get(
    url="https://contrails.googleapis.com/v2/detections",
    params={"start_time": "2026-01-27T12:00:00Z",
            "end_time": "2026-01-27T12:10:00Z",
            "satellite_origins": ["HIMAWARI-FULL-DISK"]}
    headers={"x-goog-api-key": API_KEY},
  )
  

  หรือใน CURL

  curl "https://contrails.sandbox.googleapis.com/v2/detections?\
  key=API_KEY&\
  start_time=2026-01-27T12:00:00Z&\
  end_time=2026-01-27T12:10:00Z&\
  satellite_origins=HIMAWARI-FULL-DISK"
  

การตอบกลับที่สำเร็จซึ่งมีคอนเทรลที่ตรวจพบจะมีลักษณะดังนี้

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            90.06765747070312,
            44.201324462890625
          ],
          [
            90.99974060058594,
            43.65225601196289
          ]
        ]
      },
      "properties": {
        "time": "2026-03-10T00:00:00+00:00",
        "satellite_origin": "HIMAWARI-FULL-DISK"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            105.36386108398438,
            -1.7198446989059448
          ],
          [
            105.7318115234375,
            -2.5787696838378906
          ]
        ]
      },
      "properties": {
        "time": "2026-03-10T00:00:00+00:00",
        "satellite_origin": "HIMAWARI-FULL-DISK"
      }
    }
  ]
}