Method: batchGetAttributions

根據航班資訊取得多個飛機雲歸因。

如果成功，回應會是尾流歸因清單。

HTTP 要求

GET https://contrails.googleapis.com/v2/{parent=attributions}:batchGet

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

必填。所有擷取歸因共用的父項資源。格式：歸因

查詢參數

參數
names[]

string

必填。要擷取的航班資源名稱。單一要求最多可提供 100 個名稱。

格式：

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")。

要求主體

要求主體必須為空白。

回應主體

回應，其中包含 attributions.batchGet 的已歸因凝結尾跡。

如果成功，回應主體會含有以下結構的資料：

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 Epoch；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 中的 SegmentAttribution.contrail 不同，原因如下：lengthMeters

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

enum (DataSource)

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

DataSource

用於偵測凝結尾的衛星資料來源。日後可能會新增其他值。

列舉
DATA_SOURCE_UNSPECIFIED 未指定資料來源。
GOES_EAST_FULL_DISK GOES-East 全球掃描資料。
GOES_WEST_FULL_DISK GOES-West 全球掃描資料。
MTG_000_FULL_DISK MTG-000 全磁碟掃描資料。
HIMAWARI_FULL_DISK 從向日葵完整磁碟掃描取得的資料。