检索预测区域

GET https://contrails.googleapis.com/v2/regions：以 GeoJSON 多边形格式获取避开凝结尾迹的区域。

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

以多边形格式返回的避开凝结尾迹区域按严重程度级别进行评级，每个飞行高度的级别范围为 1 到 4。值越高，凝结尾越严重。

查询参数

参数
time

string

必需。请求时间。

格式：ISO 8601 日期时间字符串或 Unix 时间戳整数

示例：2026-01-20T21:00:00Z
flightLevel[]

integer

可选。要返回的飞行高度。如果未指定任何实验组，则包含所有实验组。

格式：以百英尺为单位的飞行高度；[270, 280, 290, 300, 310, 320, 330, 340, 350, 360, 370, 380, 390, 400, 410, 420, 430, 440]

示例：[270, 280, 290, 300]
threshold

integer

可选。最低严重程度阈值。设置此字段后，系统只会返回严重程度大于或等于阈值的区域。

格式：有效值介于 1 到 4 之间（含两端值）。
aircraftClass

string

可选。飞行器类别。目前只支持 default。

示例

  • 如需检索特定时间点的所有航迹避让区域，请执行以下操作：

    response = requests.get(
  url="https://contrails.googleapis.com/v2/regions",
  params={"time": 2026-01-27T12:00:00Z},
  headers={"x-goog-api-key": API_KEY},
)

    GeoJSON 响应以多边形格式列出了所有避开凝结尾迹的区域：

    几何图形 flight_level 阈值 时间 forecast_reference_time aircraft_class
    0 MULTIPOLYGON Z (((166.25 81.12 8229.6, 168.37 ... 270 1 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 默认
    1 MULTIPOLYGON Z (((92.38 45.5 8229.6, 93 46.62 ... 270 2 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 默认
    2 MULTIPOLYGON Z (((83.38 65 8229.6, 84 66.12 82... 270 3 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 默认
    3 MULTIPOLYGON Z (((57.38 76 8229.6, 57.75 76.88... 270 4 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 默认
    4 MULTIPOLYGON Z (((162.38 79 8534.4, 162.75 79.... 280 1 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 默认

  • 如需检索仅限于特定飞行高度的避开凝结尾迹区域，并将时间指定为 Unix 纪元整数，请执行以下操作：

    response = requests.get(
  url="https://contrails.googleapis.com/v2/regions",
  params={
    "time": 1768942800,
    "flightLevel": [300,310,320,330]
  },
  headers={"x-goog-api-key": API_KEY},
)

  • 如需检索仅限于特定飞行高度且严重程度阈值等于或高于 3 的凝结尾迹规避区域，请执行以下操作：

    response = requests.get(
  url="https://contrails.googleapis.com/v2/regions",
  params={
    "time": 2026-01-27T12:00:00Z,
    "flightLevel": [300,310,320,330],
    "threshold": 3
  },
  headers={"x-goog-api-key": API_KEY},
)