予測グリッドを取得する

GET https://contrails.googleapis.com/v2/grids: 飛行機雲の予測のグリッドを取得します。

成功すると、レスポンスは飛行機雲の強制力の値の NetCDF になります。

クエリ パラメータ

パラメータ
time

string

必須。リクエストの時刻。

形式: ISO 8601 日時文字列または Unix エポック整数

例: 2026-01-20T21:00:00Z
bbox[]

number

省略可。返す領域の境界。

形式: [lng_min, lat_min, lng_max, lat_max]

例: [-40, 20, 20, 60]
aircraftType

string

省略可。航空機コード。

形式: 4 文字の ICAO 航空機タイプコード

例: A320
flightLevel[]

integer

省略可。返すフライトレベル。飛行レベルが指定されていない場合は、すべての飛行レベルが含まれます。

形式: 飛行高度（ヘクトフィート）。[270, 280, 290, 300, 310, 320, 330, 340, 350, 360, 370, 380, 390, 400, 410, 420, 430, 440]

例: [270, 280, 290, 300]
format

string

省略可。リクエストされたフォーマット。ポリゴンはサポートされていないため、'netcdf4' 以外の値を渡すと、UNIMPLEMENTED エラーが発生します。
aircraftClass

string

省略可。航空機のクラス。現在、default だけがサポートされています。
data[]

string

省略可。このフィールドは、レスポンスに含めるデータ変数を指定します。1 つ以上のデータ変数を取り扱うことができます。このフィールドが空であるか、指定されていない場合、デフォルトは ["contrails"] です。

例: ["contrails", "expected_effective_energy_forcing"]

例

  • 特定の時点のデフォルトのグローバル コントレイル グリッドを取得するには:

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

    xarray で読み込むと、このリクエストは次のデータセットを返します。

    ディメンション:（経度: 1441、緯度: 721、飛行レベル: 18、時間: 1）
    座標
    名前 サイズ データ型 値
    longitude （経度） float32 -180.0 -179.8 ... 179.8 1...
    latitude （緯度） float32 -90.0 -89.75 -89.5 ... 8...
    flight_level （飛行高度） int16 270 280 290 300 ... 41...
    時間 （時間） datetime64[ns] 2026-01-28T20:00:00
    forecast_reference_time （時間） datetime64[ns] 2026-01-27T08:00:00
    データ変数
    contrails （経度、緯度、飛行高度、時間） float32 0.0 0.0 0.0 0.0 ... 0.0 ...
    属性
    inference_pipeli... contrails.forecast-pipeline_20260115.02_p0
    api_version : contrails.api-service_20260125.00_p0
    aircraft_class : デフォルト

  • 特定の地理的境界に制限され、特定の航空機タイプでフィルタされ、時間が Unix エポック整数として指定されたグリッドを取得するには:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/grids",
  params={"time": 1769508160,
          "bbox": [-40, 20, 20, 60],
          "aircraftType": "A320"
          },
  headers={"x-goog-api-key": API_KEY},
)

  • contrails レイヤと expected_effective_energy_forcing レイヤを使用して、飛行レベルのサブセットと特定の地域に限定されたグリッドを取得するには:

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