予測リージョンを取得する

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