Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

歸因

特定航班清單的歸因飛機雲區段。

資料格式

歸因飛機雲的要求包含結構如下的資料：

JSON 表示法
{ "attributions": [ { object (`Attribution`) } ] }

欄位

欄位
`attributions[]`	`object (Attribution)` `BatchGetAttributionsRequest.names` 中指定的每個資源名稱都有一個對應的屬性清單。這份清單中的作者順序會與 `BatchGetAttributionsRequest` 中的名稱順序一致。如果找不到航班，回應中對應的 Attribution 訊息只會填入 `name` 欄位，`flightDetails` 和 `contrail` 則會留空。

attributions[]

object (Attribution)

BatchGetAttributionsRequest.names 中指定的每個資源名稱都有一個對應的屬性清單。這份清單中的作者順序會與 BatchGetAttributionsRequest 中的名稱順序一致。如果找不到航班，回應中對應的 Attribution 訊息只會填入 name 欄位，flightDetails 和 contrail 則會留空。

歸因

代表特定航班的匯總飛機雲事件，匯總所有歸因的飛機雲區段 (例如總公里數和能量)。

JSON 表示法
{ "name": string, "flightDetails": { object (`FlightDetails`) }, "contrail": { object (`ContrailAttributes`) }, "segments": [ { object (`SegmentAttribution`) } ], "visualizationUrl": string }

欄位
`name`	`string` ID。航班的資源名稱。格式： `carriers/{carrier}/flightNumbers/{flightNumber}/departureDates/{departure_date}/departureAirports/{departure_airport}` 組成要素： `{carrier}`：2 個字元的國際航空運輸協會航空公司代碼 (例如 `"AA"`、`"UA"`)。 `{flightNumber}`：1 到 4 位數的航班編號 (例如 `"123"`)。 `{departure_date}`：航班出發日期，依出發地機場當地時間計算，格式為 `YYYY-MM-DD` (2024 年起提供)。 `{departure_airport}`：由 3 個字母組成的 IATA 機場代碼 (例如 `"JFK"`、`"LHR"`)。
`flightDetails`	`object (FlightDetails)` 這班航班的詳細資訊。
`contrail`	`object (ContrailAttributes)` 整趟航班的匯總飛機雲屬性。這是所有歸因航段的飛機雲屬性總和。狀態解讀 (在找到的航班中)：如果顯示：已執行凝結尾分析。`ContrailAttributes` 內的欄位代表結果 (例如 `lengthMeters > 0` 表示飛機雲已歸因)。如果出現空白的 `ContrailAttributes` 訊息，表示已執行分析，但 `lengthMeters` 和能量強迫評估結果均為零。如果沒有：無法對這個航班執行凝結尾分析。這通常是因為輸入資料不足 (例如缺少天氣資料或飛行路徑不確定)。這不代表沒有形成飛機雲，只是無法判斷。提示：在某些程式設計語言中，您可以使用產生的 `has_contrail()` 方法，先檢查這個欄位是否存在，再存取其成員。
`segments[]`	`object (SegmentAttribution)` 各區段的飛機雲歸因。每個項目代表航班中產生飛機雲的不同時間間隔。
`visualizationUrl`	`string` 僅供輸出。點選這個連結，即可前往 ContrailExplorer 的 ContrailWatch 頁面，查看這趟航班飛機雲歸因的互動式圖表。顯示與衛星偵測到的飛機雲相符的飛行路徑。只有在使用 `ATTRIBUTION_VIEW_OBSERVATION` 檢視畫面時，才會填入找到的航班。

FlightDetails

定義回應中傳回的完整航班資訊。

JSON 表示法
{ "carrier": string, "flightNumber": integer, "departureTime": string, "icao24": string, "originAirport": string, "destinationAirport": string, "callSign": string, "analyzedFlightDistanceMeters": integer }

JSON 表示法

{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": integer
}

欄位
`carrier`	`string` 航班的 IATA 航空公司代碼 (例如「AA」)。
`flightNumber`	`integer` 航班編號 (例如「123」)。
`departureTime`	`string` 出發日期，格式為 YYYYMMDD，以出發地機場的時區為準。
`icao24`	`string` ICAO 24 位元飛機位址
`originAirport`	`string` IATA 出發地機場代碼。
`destinationAirport`	`string` 目的地機場 IATA 代碼。
`callSign`	`string` 飛機的呼號。這個欄位應優先填入航空管制 (ATC) 通訊中使用的呼號。如果沒有特定的 ATC 呼號，或與標準航班指定碼相同，這個欄位會保留標準航班指定碼 (通常是商業航班的航空公司代碼和航班編號組合)。
`analyzedFlightDistanceMeters`	`integer` 分析的飛行距離，以公尺為單位。

ContrailAttributes

代表航班或航段的飛機雲屬性。

JSON 表示法
{ "lengthMeters": integer, "effectiveEnergyForcingJoules": string }

欄位

欄位
`lengthMeters`	`integer` 飛機雲歸因的飛行路徑子集長度(以公尺為單位)。計算方式是飛行路線控點之間的大圓距離。
`effectiveEnergyForcingJoules`	`string (int64 format)` 總有效飛機雲能量強迫，以焦耳為單位。這項指標是從 4D 網格 CoCiP 預測輸出內容中，擷取有效輻射強迫力，並以線性內插法計算得出。這項方法可能隨時變動。

lengthMeters

integer

飛機雲歸因的飛行路徑子集長度(以公尺為單位)。計算方式是飛行路線控點之間的大圓距離。

effectiveEnergyForcingJoules

string (int64 format)

總有效飛機雲能量強迫，以焦耳為單位。這項指標是從 4D 網格 CoCiP 預測輸出內容中，擷取有效輻射強迫力，並以線性內插法計算得出。這項方法可能隨時變動。

SegmentAttribution

代表航班特定時間區隔的飛機雲歸因。

JSON 表示法

JSON 表示法
{ "startTime": string, "endTime": string, "contrail": { object (`ContrailAttributes`) }, "detectionEvidences": [ { object (`ContrailDetectionEvidence`) } ], "attributionMethod": enum (`AttributionMethod`), "longGapInterpolation": boolean, "waypointAttributions": [ { object (`WaypointAttribution`) } ] }

{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ],
  "attributionMethod": enum (AttributionMethod),
  "longGapInterpolation": boolean,
  "waypointAttributions": [
    {
      object (WaypointAttribution)
    }
  ]
}

欄位
`startTime`	`string (Timestamp format)` 飛機雲所屬航段的開始時間。這個時間戳記採用世界標準時間 Epoch 秒數。
`endTime`	`string (Timestamp format)` 飛機雲歸因的航段結束時間。這個時間戳記採用世界標準時間 Epoch 秒數。
`contrail`	`object (ContrailAttributes)` 這個特定路段的飛機雲屬性。
`detectionEvidences[]`	`object (ContrailDetectionEvidence)` 個別衛星飛機雲偵測結果，可做為歸因於這個航段的依據。
`attributionMethod`	`enum (AttributionMethod)` 僅供輸出。將飛機雲歸因於這個區段的方法 (例如 CoCiP 模型或直接觀察)。
`longGapInterpolation`	`boolean` 僅供輸出。如果區段飛行路徑是透過插補長時間 ADS-B 資料差距 (>5 分鐘) 產生，則為 True。
`waypointAttributions[]`	`object (WaypointAttribution)` 僅供輸出。這個路段中，每個路線控點的飛機雲屬性對應。

ContrailDetectionEvidence

單一衛星觀測飛機雲的詳細資料。

JSON 表示法
{ "observationTime": string, "observedLengthMeters": integer, "dataSource": enum (`DataSource`) }

欄位

欄位
`observationTime`	`string (Timestamp format)` 偵測到飛機雲的衛星圖像拍攝時間。這通常是掃描作業的開始時間。這個時間戳記採用世界標準時間 Epoch 秒數。
`observedLengthMeters`	`integer` 在 `observationTime` 指定的衛星圖像中，偵測到的線性凝結尾特徵端對端長度 (以公尺為單位)。這個長度可能與 `SegmentAttribution.contrail` 中的 `lengthMeters` 不同，原因如下：凝結尾跡在形成和觀測之間，可能已在大氣中演變 (例如擴散、變長等)。歸因演算法只能確定這條飛機雲有一部分是由這趟航班造成。
`dataSource`	`enum (DataSource)` 僅供輸出。這項偵測作業使用的衛星資料來源。

observationTime

string (Timestamp format)

偵測到飛機雲的衛星圖像拍攝時間。這通常是掃描作業的開始時間。這個時間戳記採用世界標準時間 Epoch 秒數。

observedLengthMeters

integer

在 observationTime 指定的衛星圖像中，偵測到的線性凝結尾特徵端對端長度 (以公尺為單位)。這個長度可能與 SegmentAttribution.contrail 中的 lengthMeters 不同，原因如下：

凝結尾跡在形成和觀測之間，可能已在大氣中演變 (例如擴散、變長等)。
歸因演算法只能確定這條飛機雲有一部分是由這趟航班造成。

dataSource

enum (DataSource)

僅供輸出。這項偵測作業使用的衛星資料來源。

DataSource

用於偵測飛機雲的衛星資料來源。日後可能會新增其他值。

在可用的衛星資料輸出中，以 GOES East 和 Himawari 為基礎的歸因資料具有正式版品質，而以 MTG 為基礎的歸因資料仍處於 Beta 版階段，且正在積極提升品質。

列舉
`DATA_SOURCE_UNSPECIFIED`	未指定的資料來源。
`GOES_EAST_FULL_DISK`	GOES-East 全盤掃描資料。
`GOES_WEST_FULL_DISK`	GOES-West 全盤掃描資料。
`MTG_000_FULL_DISK`	資料來源：MTG-000 全磁碟掃描。
`HIMAWARI_FULL_DISK`	向日葵衛星全圓盤掃描資料。

Contrails API 衛星圖像的依據如下：

NOAA GOES 資料 2019–2026
EUMETSAT Meteosat FCI 資料 2024–2026 年，以及
JAMSTEC DIAS (Himawari data) 2025–2026

WaypointAttribution

代表航段中特定路線控點的凝結尾屬性。

JSON 表示法
{ "time": string, "contrailAttributes": { object (`ContrailAttributes`) } }

欄位

欄位
`time`	`string (Timestamp format)` 路線控點的時間，以世界標準時間 Epoch 秒數表示。
`contrailAttributes`	`object (ContrailAttributes)` 在這個特定路線控點對應的飛機雲屬性。

time

string (Timestamp format)

路線控點的時間，以世界標準時間 Epoch 秒數表示。

contrailAttributes

object (ContrailAttributes)

在這個特定路線控點對應的飛機雲屬性。

AttributionMethod

定義用於歸因的特定程序或方法。

列舉
`ATTRIBUTION_METHOD_OBSERVATION`	歸因結果完全是根據衛星偵測到的飛機雲比對而得。
`ATTRIBUTION_METHOD_COCIP`	歸因完全仰賴物理驅動的 CoCiP 模擬。
`ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP`	混合歸因模型，結合 CoCiP 模型預測結果，並根據衛星偵測資料調整。偵測結果：如果出現 `detectionEvidences`，表示系統預測並透過觀測確認有飛機雲，因此會提高暖化權重。未偵測到：如果缺少 `detectionEvidences`，表示系統預測到飛機雲，但未觀察到，因此計算出的暖化效應會打折扣。
`ATTRIBUTION_METHOD_UNSPECIFIED`	未指定方法。

附註

每個 DataSource 都會使用不同的界限來處理觀察型檢視：

衛星涵蓋範圍定界框 (平面麥卡托檢視)

授權

ContrailWatch Attributions API 公開的資料，是依據 CC BY-NC 4.0 授權。