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.

Toạ độ được trả về là kinh độ và vĩ độ của các điểm cuối của quá trình phát hiện tuyến tính, được chiếu lên bề mặt Trái Đất theo góc nhìn của vệ tinh. Đối với các lần phát hiện GOES, các toạ độ được trả về cũng có thể bao gồm các giá trị độ cao dự đoán (không bắt buộc).

Việc truy vấn các lượt phát hiện trong một phạm vi thời gian nằm ngoài phạm vi, chẳng hạn như một thời gian cụ thể trong tương lai, sẽ trả về một FeatureCollection trống.

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ờ 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.

Khi có mặt, điểm cuối này 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.

Khi không có, 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 áp dụng.

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

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

string

Không bắt buộc. Một danh sách các cặp chuỗi, mỗi cặp phải ở định dạng "latitude,longitude", chỉ định các đỉnh cho một đa giác bao quanh.

Nếu có, bạn phải chỉ định ít nhất 3 bounds. Các ranh giới phải tạo thành một đa giác hợp lệ (ví dụ: không có đỉnh trùng lặp, không tự giao nhau)

Khi có mặt, điểm cuối này chỉ trả về những vệt khói ngưng tụ được phát hiện và giao với bất kỳ phần nào của đa giác bao quanh.

Khi không có, hệ thống sẽ trả về các vệt khói ngưng tụ được phát hiện bất kể vị trí.

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

Ví dụ: ["37.7,-122.41", "37.78,-122.42", "37.79, -122.43"]

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 khoảng thời gian 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},
)

  • Để truy xuất tất cả các lần phát hiện vệt khói trong một khoảng thời gian cụ thể, bị giới hạn bởi đa giác ranh giới:

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

  • Cách truy xuất thông tin phát hiện vệt khói cho một khoảng thời gian 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.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 GeoJSON cho yêu cầu này liệt kê dữ liệu phát hiện vết phản lực từ các vệ tinh Himawari trong phạm vi thời gian được yêu cầu:

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