擷取偵測結果

GET https://contrails.googleapis.com/v2/detections：以 GeoJSON LineString 格式取得凝結尾跡偵測結果。

如果成功，回應會是 GeoJSON 格式的 FeatureCollection。

傳回的座標是線性偵測的端點經緯度，從衛星角度投影到地球表面。如果是 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。邊界必須形成有效多邊形 (例如沒有重複的頂點，也沒有自相交)

如果提供這個端點，系統只會傳回與任何部分的邊界多邊形相交的凝結尾跡。

如果沒有，則無論位置為何，都會傳回偵測到的凝結尾。

格式：字串陣列

範例：["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 回應會列出所要求時間範圍內，來自向日葵衛星的凝結尾偵測資料：

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