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

FlightDetails

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

JSON 表示法 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": string
}
欄位
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

與航點相關聯的飛機呼號。
analyzedFlightDistanceMeters

string (int64 format)

分析的飛行距離 (以公尺為單位)。

ContrailAttributes

代表航班的凝結尾跡屬性。

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

string (int64 format)

預估凝結尾流形成長度 (以公尺為單位)。
effectiveEnergyForcingJoules

string (int64 format)

歸因於這趟航班的有效能源強迫總量 (以焦耳為單位)。