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

GET https://contrails.googleapis.com/v2/detections: รับการตรวจจับไอพ่นในรูปแบบ GeoJSON LineString

หากสำเร็จ การตอบกลับจะเป็น FeatureCollection ในรูปแบบ GeoJSON

พิกัดที่แสดงคือลองจิจูดและละติจูดของจุดสิ้นสุดของการตรวจจับแบบเส้นตรง ซึ่งฉายลงบนพื้นผิวโลกจากมุมมองของดาวเทียม สำหรับการตรวจจับ GOES พิกัดที่แสดงอาจรวมถึงค่าความสูงที่คาดการณ์ไว้ด้วย (ไม่บังคับ)

การค้นหาการตรวจจับที่มีช่วงเวลาที่อยู่นอกขอบเขต เช่น เวลาที่ระบุซึ่งอยู่ในอนาคต จะแสดง 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"]
bounds[]

string

ไม่บังคับ รายการคู่สตริง ซึ่งแต่ละคู่ต้องอยู่ในรูปแบบ "ละติจูด,ลองจิจูด" โดยระบุจุดยอดของรูปหลายเหลี่ยมขอบเขต

หากระบุไว้ ต้องระบุ bounds อย่างน้อย 3 รายการ ขอบเขตต้องสร้างรูปหลายเหลี่ยมที่ถูกต้อง (เช่น ไม่มีจุดยอดที่ซ้ำกัน ไม่มีส่วนที่ตัดกันเอง)

เมื่อระบุไว้ ปลายทางนี้จะแสดงไอพ่นที่ตรวจพบซึ่งตัดกับส่วนใดส่วนหนึ่งของรูปหลายเหลี่ยมขอบเขต เท่านั้น

หากไม่ได้ระบุไว้ ระบบจะแสดงไอพ่นที่ตรวจพบโดยไม่คำนึงถึงตำแหน่ง

รูปแบบ: อาร์เรย์สตริง

ตัวอย่าง: ["37.7,-122.41", "37.78,-122.42", "37.79, -122.43"]

ตัวอย่าง

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

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

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

    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",
          "bounds": ["37.7,-122.41", "37.78,-122.42", "37.79, -122.43"]},
  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.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"

    การตอบกลับ GeoJSON สำหรับคำขอนี้จะแสดงข้อมูลการตรวจจับไอพ่นจากดาวเทียม Himawari สำหรับช่วงเวลาที่ขอ

    {
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            90.06765747070312,
            44.201324462890625
          ],
          [
            90.99974060058594,
            43.65225601196289
          ]
        ]
      },
      "properties": {
        "time": "2026-01-27T12: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-01-27T12:10:00+00:00",
        "satellite_origin": "HIMAWARI-FULL-DISK"
      }
    }
  ]
}