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 mây do máy bay tạo ra ở định dạng GeoJSON LineString.

Nếu thành công, phản hồi sẽ là một FeatureCollection ở định dạng GeoJSON.

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

Việc truy vấn thông tin phát hiện với một khoảng 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ờ 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-WEST-FULL-DISK, 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 mây do máy bay tạo ra được phát hiện từ các vệ tinh được chỉ định trong satellite_origins.

Khi không có mặt, trả về các vệt mây do máy bay tạo ra đượ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 "vĩ độ,kinh độ", 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 giới hạn 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ề các vệt mây do máy bay tạo ra được phát hiện giao với bất kỳ phần nào của đa giác bao quanh.

Khi không có mặt, trả về các vệt mây do máy bay tạo ra đượ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ả thông tin phát hiện vệt mây do máy bay tạo ra 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},
)

  • Cách truy xuất tất cả thông tin phát hiện vệt mây do máy bay tạo ra cho một khoảng thời gian cụ thể, bị giới hạn bởi đa giác bao quanh:

    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 mây do máy bay tạo ra cho một khoảng thời gian cụ thể, chỉ giới hạn ở thông tin phát hiện 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 mây do máy bay tạo ra từ các vệ tinh Himawari cho khoảng 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"
      }
    }
  ]
}