检索预测网格

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

可选。此字段用于指定要在响应中包含哪些数据变量。它可以处理一个或多个数据变量。 如果此字段为空或未提供，则默认为 ["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
    数据变量
    凝结尾迹 （经度、纬度、飞行高度层、时间） 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},
)