歸因

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

資料格式

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

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 表示凝結尾跡已歸因)。
  • 如果沒有：無法對這趟航班執行凝結尾跡分析。
    • 這通常是因為輸入資料不足 (例如缺少天氣資料或飛行路徑不確定)。
    • 這並不代表沒有形成凝結尾跡，只是無法判斷。
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

出發日期，以出發地機場的時區為準；int：Unix 紀元或 str：ISO 8601。
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)

有效凝結尾流能量強迫的總和，以焦耳為單位。目前是根據氣候平均值計算，之後可能會有所變動。

SegmentAttribution

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

JSON 表示法 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ]
}
欄位
startTime

string (Timestamp format)

歸因於凝結尾跡的航班航段開始時間。這個時間戳記是以世界標準時間為準的 Epoch 秒數。
endTime

string (Timestamp format)

歸因於凝結尾跡的航班區段結束時間。這個時間戳記是以世界標準時間為準的 Epoch 秒數。
contrail

object (ContrailAttributes)

這個特定區隔的 Contrail 屬性。
detectionEvidences[]

object (ContrailDetectionEvidence)

個別衛星凝結尾跡偵測結果，可做為歸因於這段航程的證據。

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 和 MTG。GOES East 歸因的品質已達正式版水準，而 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 從向日葵完整磁碟掃描取得的資料。