擷取預測格線

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 載入時，這項要求會傳回下列資料集：

    尺寸：(longitude: 1441, latitude: 721, flight_level: 18, time: 1)
    座標
    名稱 尺寸 資料類型 值
    longitude (經度) float32 -180.0 -179.8 ... 179.8 1...
    latitude (緯度) float32 -90.0 -89.75 -89.5 ... 8...
    flight_level (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},
)