擷取預測區域

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