Method: flights.computeScope3FlightEmissions

擷取一組航段的 GHG 排放量預估值，用於範圍 3 報告。

回應會包含與輸入 Scope3FlightSegment 航班航段相符的所有項目，並按照提供的順序排列。系統會使用下列串聯邏輯計算預估值 (使用第一個可用的邏輯)：

  1. 根據 origin、destination、carrier、flightNumber、departureDate 和 cabinClass，由 TIM 預估的排放量。
  2. origin、destination、departureDate 年和cabinClass的一般航班排放量。
  3. 依距離計算的排放量，計算依據為distanceKm、departureDate年和cabinClass。

如果要求的是本曆年未來的航班，我們不支援第 1 級排放量，會改用第 2 級或第 3 級排放量。如果要求的未來航班不在本曆年內，我們會傳回空白回應。建議日後改用 computeFlightEmissions API。

如果某個航班無法透過這三種方法取得預估值，回應會傳回 Scope3FlightEmissions 物件，其中排放量欄位為空白。要求仍會視為成功。一般來說，如果伺服器不清楚航班資訊 (例如沒有特定航班，或無法取得所要求航班的一般航班排放量)，就不會顯示預估排放量。

如有下列情況，要求會失敗並傳回 INVALID_ARGUMENT 錯誤：

  • 要求包含超過 1,000 個航段。
  • 輸入的航段缺少一或多個 ID。舉例來說，如果缺少起點/目的地，且 TIM_EMISSIONS 或 TYPICAL_FLIGHT_EMISSIONS 類型比對沒有有效距離，或 DISTANCE_BASED_EMISSIONS 類型比對缺少距離 (如要改用距離排放量，或想取得距離排放量預估值，則須指定距離)。
  • 航班日期早於 2019 年 (系統僅提供 2019 年及之後的範圍 3 資料)。
  • 飛行距離為 0 或更低。
  • 缺少艙等。

由於要求是透過備用邏輯處理，因此設定錯誤的要求可能會使用備用方法傳回有效的排放量預估值。舉例來說，如果要求中的航班編號有誤，但指定了出發地和目的地，要求仍會成功，但傳回的碳排放量只會根據一般航班碳排放量計算。同樣地，如果一般航班碳排放量要求缺少出發地，但指定了有效距離，系統可能會單純根據距離碳排放量成功處理要求。因此，請務必檢查傳回的排放量來源 (source)，確認結果符合預期。

HTTP 要求

POST https://travelimpactmodel.googleapis.com/v1/flights:computeScope3FlightEmissions

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

要求主體

要求主體會包含結構如下的資料：

JSON 表示法 
{
  "flights": [
    {
      object (Scope3FlightSegment)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
欄位
flights[]

object (Scope3FlightSegment)

必填。要傳回預估碳排放量的航班。
modelVersion

object (ModelVersion)

(選用步驟) 用於計算這項要求中所有航班預估排放量的模型版本。

回應主體

航班清單，附有範圍 3 預估排放量。

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

JSON 表示法 
{
  "flightEmissions": [
    {
      object (Scope3FlightEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
欄位
flightEmissions[]

object (Scope3FlightEmissions)

含有預估排放量的航段清單。
modelVersion

object (ModelVersion)

用於計算這項回覆中所有航班預估排放量的模型版本。

Scope3FlightSegment

用於擷取範圍 3 排放量的航班參數。

JSON 表示法 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (Scope3FlightSegment.CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
欄位
departureDate

object (Date)

必填。航班日期 (以出發地機場的時區為準)。一般航班和距離排放量模型只需要年 (月和日的值會遭到忽略，因此可以省略、設為 0，或設為有效日期)。同樣地，如果未提供 TIM 排放量的特定日期，我們會改用一般航班 (或依距離計算) 的排放量。
cabinClass

enum (Scope3FlightSegment.CabinClass)

必填。航班艙等。
origin

string

(選用步驟) 航班出發地的 3 個字元國際航空運輸協會機場代碼，例如 YVR。如果同時提供目的地、航空公司和航班編號，系統會使用這項資訊比對特定航班。如果沒有相符的航班，我們會先嘗試將航班與指定出發地和目的地機場之間的一般航班進行比對。如果沒有，但有提供飛行距離，則會使用距離排放模型。
destination

string

(選用步驟) 航班目的地的 3 個字元國際航空運輸協會機場代碼，例如 ICN。如果與出發地、航空公司和航班編號一併提供，則會用於比對特定航班。如果沒有相符的航班，我們會先嘗試將航班與指定出發地和目的地機場之間的一般航班進行比對。如果沒有，但有提供飛行距離，則會使用距離排放模型。
carrierCode

string

(選用步驟) 2 個字元的國際航空運輸協會 (IATA) 航空公司代碼，例如 KE。如要比對特定航班，則必須提供這項資訊。否則，一般航班和距離排放模型不會使用這個欄位。這可以是營運和行銷航空公司的代碼 (即涵蓋共用班號)。
flightNumber

integer

(選用步驟) 最多 4 位數的航班編號，例如 71，範圍為 [1, 9999]。如果同時指定航班編號、出發地、目的地和航空公司，系統會先使用這個值比對特定航班。如果未指定航班編號，系統會先嘗試比對航班與指定出發地和目的地機場之間的一般航班。如果失敗和/或未提供出發地和目的地，我們會根據提供的飛行距離，使用距離式排放模型。
distanceKm

string (int64 format)

(選用步驟) 距離 (公里)，例如 2423，從 [1, 1e12) 公里。如果未提供出發地和目的地，或沒有相符的一般航班，則會使用這個值，根據距離比對航班和排放量。

Scope3FlightSegment.CabinClass

航班艙等。

列舉
CABIN_CLASS_UNSPECIFIED 未指定艙等。
ECONOMY 經濟艙。
PREMIUM_ECONOMY 豪華經濟艙。
BUSINESS 商務艙。
FIRST 頭等艙。

Scope3FlightEmissions

範圍 3 航班，附預估排放量。

JSON 表示法 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3FlightEmissions.Scope3DataType),
  "modelVersion": string
}
欄位
flight

object (Scope3FlightSegment)

ID。與要求中的航班 ID 相符。
wtwEmissionsGramsPerPax

string (int64 format)

(選用步驟) 根據所要求資訊，每位乘客的航班總排放量 (燃料開採到裝載和燃料裝載到排放的總和)。這是總排放量，除非你有特定原因要使用 TTW 或 WTT 排放量，否則應使用這個數字。
ttwEmissionsGramsPerPax

string (int64 format)

(選用步驟) 根據要求的資訊，計算每位乘客的油箱到尾流飛行排放量。
wttEmissionsGramsPerPax

string (int64 format)

(選用步驟) 根據要求的資訊，計算每位乘客的燃料生產階段航班排放量。
source

enum (Scope3FlightEmissions.Scope3DataType)

(選用步驟) 排放量資料的來源。
modelVersion

string

(選用步驟) 計算排放量時使用的模型版本。

Scope3FlightEmissions.Scope3DataType

用於計算範圍 3 排放量的比對類型。這項資訊用於範圍 3 回覆，標示計算排放量時使用的方法。

列舉
SCOPE3_DATA_TYPE_UNSPECIFIED 未指定資料類型。
TIM_EMISSIONS 根據出發地、目的地、航空公司、航班編號、出發日期和年份，提供 TIM 排放量。
TYPICAL_FLIGHT_EMISSIONS 根據出發地、目的地和年份，提供一般航班排放量。
DISTANCE_BASED_EMISSIONS 根據行駛距離和年份計算的排放量。