Method: flights.computeFlightEmissions

用於擷取預估排放量的無狀態方法。如要進一步瞭解碳排放量估算方式，請參閱 GitHub。

回應會包含與輸入航班航段相符的所有項目，順序相同。如果特定航段沒有預估值，回應會傳回航段物件，但排放量欄位為空白。但系統仍會將要求視為成功。如果沒有碳排放量估算結果，可能的原因包括：

  • 伺服器無法辨識航班。
  • 輸入的航班航段缺少一或多個 ID。
  • 航班日期是過去日期。
  • 模型不支援該機型。
  • 缺少座位設定。

要求最多可包含 1000 個航班航段。如果要求包含超過 1000 個直飛航班，系統會傳回 INVALID_ARGUMENT 錯誤，導致要求失敗。

HTTP 要求

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

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

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "flights": [
    {
      object (Flight)
    }
  ]
}
欄位
flights[]

object (Flight)

必要欄位。直達航班，用於預估回程排放量。

回應主體

flights.computeFlightEmissions 回應的輸出定義。

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

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

object (FlightWithEmissions)

列出各段航班的預估排放量。
modelVersion

object (ModelVersion)

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

檔期

與單一要求項目相關的所有詳細資料，用於直接航班排放量預估。

JSON 表示法 
{
  "origin": string,
  "destination": string,
  "operatingCarrierCode": string,
  "flightNumber": integer,
  "departureDate": {
    object (Date)
  }
}
欄位
origin

string

必要欄位。航班出發地機場的 IATA 代碼，例如「LHR」。
destination

string

必要欄位。航班目的地的 IATA 機場代碼，例如「JFK」。
operatingCarrierCode

string

必要欄位。IATA 航空公司代碼，例如「AA」。
flightNumber

integer

必要欄位。航班號碼，例如 324。
departureDate

object (Date)

必要欄位。航班日期，以出發地機場的時區為準。必須是現在或未來的日期。

日期

表示完整或部分的日曆日期，例如生日。您可以視重要性決定是否要在別處指定時段和時區。日期以公曆為主，這可以代表下列其中一項：

  • 完整日期，具有非零的年、月和日值。
  • 月和日，年值為零 (例如週年紀念日)。
  • 只有年，月和日值為零。
  • 年和月，日值為零 (例如信用卡到期日)。

相關類型：

JSON 表示法 
{
  "year": integer,
  "month": integer,
  "day": integer
}
欄位
year

integer

日期年份。必須為 1 到 9999；如要指定不含年份的日期，請輸入 0。
month

integer

一年中的月份。必須為 1 到 12；如要指定不含日期的年份，請輸入 0。
day

integer

當月第幾日。必須為 1 到 31，並屬於有效的年和月；如果只指定年份，或只指定年份和月份，而不指定當月第幾日的話，請輸入 0。

FlightWithEmissions

直飛航班，並提供預估排放量。

JSON 表示法 
{
  "flight": {
    object (Flight)
  },
  "source": enum (Source),
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket)
}
欄位
flight

object (Flight)

必要欄位。與要求中的航班 ID 相符。注意：所有 IATA 代碼均為大寫。
source

enum (Source)

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

object (EmissionsGramsPerPax)

(選用步驟) 每位乘客的預估排放量。如果無法計算碳排放量，就不會顯示這項資訊。如要查看無法計算碳排放量的原因清單，請參閱flights.computeFlightEmissions。
easaLabelMetadata

object (EasaLabelMetadata)

(選用步驟) 歐盟航空安全總署 (EASA) 航班排放量標籤的中繼資料。只有在排放量資料來源為 EASA 時才設定。
contrailsImpactBucket

enum (ContrailsImpactBucket)

(選用步驟) 飛機雲暖化效應相較於二氧化碳當量總排放量影響的顯著程度。

來源

排放量資料的來源。

列舉
SOURCE_UNSPECIFIED 碳排放量資料來源不明。
TIM 碳排放量資料來自旅遊影響模型。
EASA 排放量資料來自歐盟航空安全總署 (EASA) 的環保標籤。

EasaLabelMetadata

歐盟航空安全總署 (EASA) 航班排放量標籤的中繼資料。

JSON 表示法 
{
  "labelIssueDate": {
    object (Date)
  },
  "labelExpiryDate": {
    object (Date)
  },
  "labelVersion": string,
  "safDiscountPercentage": number
}
欄位
labelIssueDate

object (Date)

標籤核發日期。
labelExpiryDate

object (Date)

標籤的有效期限。標籤會顯示到這個日期為止。
labelVersion

string

標籤版本。
safDiscountPercentage

number

標籤套用的永續航空燃料 (SAF) 排放量折扣百分比。以小數表示的百分比。值介於 [0,1] 區間。舉例來說，0.0021 代表 0.21%。

這項折扣和減排量是由歐盟航空安全總署標籤回報，但未納入此 API 發布的 CO2e 預估值。

ContrailsImpactBucket

飛機雲暖化效應相較於二氧化碳當量總排放量影響的顯著程度。

列舉
CONTRAILS_IMPACT_UNSPECIFIED 未指定凝結尾跡影響。
CONTRAILS_IMPACT_NEGLIGIBLE 相較於二氧化碳當量總排放量，飛機雲的影響微不足道。
CONTRAILS_IMPACT_MODERATE 飛機雲的影響與二氧化碳當量總排放量相當。
CONTRAILS_IMPACT_SEVERE 飛機雲的影響大於總 CO2e 排放量。