歸因

特定航班清單的歸因凝結尾跡區隔。

資料格式

要求歸因凝結尾流包含下列結構的資料：

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

object (Attribution)

每個資源名稱 (在 BatchGetAttributionsRequest.names 中指定) 各有一個出處資訊。這份清單中的出處順序會與 BatchGetAttributionsRequest 中的名稱順序一致。如果系統找不到航班，回應中對應的 Attribution 訊息只會填入 name 欄位，flightDetails 和 contrail 則會空白。

歸因

代表特定航班的匯總凝結尾跡事件，總結所有歸因的凝結尾跡區隔 (例如總公里數和能源)。

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

string

ID。航班的資源名稱。

格式：

carriers/{carrier}/flightNumbers/{flightNumber}/departureDates/{departure_date}/departureAirports/{departure_airport}

元件：

  • {carrier}：2 個字元的 IATA 航空公司代碼 (例如 "AA"、"UA")。
  • {flightNumber}：1 到 4 位數的航班號碼 (例如 "123")。
  • {departure_date}：出發機場當地時間的航班出發日期，格式為 YYYY-MM-DD。
  • {departure_airport}：由 3 個字母組成的 IATA 機場代碼 (例如 "JFK"、"LHR")。
flightDetails

object (FlightDetails)

這個航班的詳細資訊。
contrail

object (ContrailAttributes)

整趟航班的飛機雲屬性匯總資料。這是所有歸因區段的凝結尾跡屬性總和。

狀態解讀 (在找到的航班中)：

  • 如果出現：已執行凝結尾跡分析。ContrailAttributes 內的欄位表示結果 (例如，lengthMeters > 0 表示凝結尾跡已歸因)。如果出現空白的 ContrailAttributes 訊息，表示系統已執行分析，但 lengthMeters 和能源強制評估結果皆為零。
  • 如果沒有：無法對這趟航班執行凝結尾跡分析。
    • 這通常是因為輸入資料不足 (例如缺少天氣資料或飛行路徑不確定)。
    • 這並不代表沒有形成凝結尾跡，只是無法判斷。
segments[]

object (SegmentAttribution)

各區段的凝結尾跡歸因。每個項目代表航班中歸因於凝結尾跡的不同時間間隔。

FlightDetails

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

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 預報輸出內容中擷取有效輻射強迫，並以線性方式插補而得。這套方法可能會隨時變更。

SegmentAttribution

代表航班特定時間段的凝結尾跡歸因。

JSON 表示法 
{
  "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)

這個特定區隔的 Contrail 屬性。
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)

僅供輸出。用於偵測的衛星資料來源。

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 從向日葵 8 號衛星掃描完整磁碟取得的資料。

凝結尾跡 API 衛星圖像的依據如下：

WaypointAttribution

代表航段中特定航點的凝結尾跡屬性。

JSON 表示法 
{
  "time": string,
  "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 著作權資訊 API 公開的資料是依據 CC BY-NC 4.0 授權。