歸因

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

資料格式

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

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

授權

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