检索检测结果

GET https://contrails.googleapis.com/v2/detections：以 GeoJSON LineString 格式获取飞机凝结尾迹检测结果。

如果成功，响应将为 GeoJSON 格式的 FeatureCollection。

返回的坐标是线性化检测端点的经度和纬度，从卫星的角度投影到地球表面。对于 GOES 检测，返回的坐标还可以选择性地包含推测的海拔值。

如果查询检测的时间范围超出范围（例如指定的时间是未来时间），则会返回空的 FeatureCollection。

注意： MTG 检测功能正处于 Beta 版阶段，随时可能会变更。

查询参数

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

  或在 C网址 中：

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