擷取凝結尾跡歸因指標

GET https://contrails.googleapis.com/v2/attributions:GetAttributionMetrics： 依據界線、時間戳記和歸因方法，取得凝結尾雲歸因指標的匯總資料。

如果成功，回應會傳回 AttributionMetrics 物件，其中包含：

  • flight_attributed_length_metres 欄位，代表指定範圍內歸因於凝結尾跡的飛行路徑子集長度(以公尺為單位)。
  • effective_energy_forcing_joules 欄位，代表指定邊界內所有凝結尾流的有效能量強制力 (以焦耳為單位)。有效能量強迫是從網格化 CoCiP 預報輸出內容中擷取有效輻射強迫，並以線性方式插補而得。
  • rf_erf_conversion_factor 欄位，代表用於從輻射作用力 (RF) 取得有效輻射作用力 (ERF) 的轉換常數。

查詢參數

參數
bounds[]

string

必填。字串配對清單，每個配對都必須採用「緯度,經度」格式，指定代表地理區域的邊界多邊形頂點。

至少須指定三個界線。邊界必須形成有效的 S2Polygon 多邊形 (例如沒有重複的頂點，也沒有自我相交)；如要進一步瞭解 S2Polygon，請參閱 S2Geometry 說明文件。

範例：["37.7,-122.41", "37.78,-122.42", "37.79,-122.43"]
startTime

string

必填。要求歸因凝結尾跡偵測的開始時間。

格式：ISO 8601 日期時間字串

範例：2026-01-20T21:00:00Z
endTime

string

必填。要求歸因凝結尾跡偵測的結束時間 (含)。

請注意，endTime 不得超過 startTime 超過 14 天。

格式：ISO 8601 日期時間字串

範例：2026-01-12T21:00:00Z
attributionMethod

enum (AttributionMethod)

必填。將凝結尾跡歸因於航班航段的方法。

格式：必須是 ATTRIBUTION_METHOD_OBSERVATION、ATTRIBUTION_METHOD_COCIP 或 ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP。