Truy xuất thông tin phát hiện

GET https://contrails.googleapis.com/v2/detections: Nhận thông tin phát hiện vệt khói ở định dạng GeoJSON LineString.

Nếu thành công, phản hồi sẽ là FeatureCollection ở định dạng GeoJSON. Xin lưu ý rằng bạn có thể trả về một FeatureCollection trống nếu phạm vi thời gian nằm ngoài phạm vi (ví dụ: tìm kiếm các vệt khói được phát hiện trong tương lai). Ngoài ra, không có gì đảm bảo rằng các lượt phát hiện sẽ nhất quán khi các mô hình phát hiện cập nhật và dữ liệu được bổ sung dữ liệu 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ờ theo tiêu chuẩn 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á 24 giờ.

Định dạng: Chuỗi ngày giờ theo tiêu chuẩn ISO 8601

Ví dụ: 2026-01-20T22:00:00Z
satellite_origins[]

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.

Nếu được cung cấp, điểm cuối này sẽ chỉ trả về các vệt khói ngưng tụ được phát hiện từ các vệ tinh được chỉ định trong satellite_origins.

Nếu không được cung cấp, hàm này sẽ trả về các vệt khói ngưng tụ được phát hiện từ tất cả nhà cung cấp dữ liệu vệ tinh hiện hành.

Định dạng: mảng chuỗi

Ví dụ: ["GOES-EAST-FULL-DISK", "HIMAWARI-FULL-DISK"]

Ví dụ

  • Cách truy xuất tất cả các lần phát hiện vệt khói cho một thời điểm cụ thể:

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

  • Cách truy xuất thông tin phát hiện vệt khói cho một thời điểm cụ thể, chỉ giới hạn ở thông tin phát hiện của 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},
)

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

Phản hồi thành công có các vệt khói được phát hiện sẽ có dạng như sau:

{
  "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"
      }
    }
  ]
}