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)

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

FlightWithEmissions

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

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

object (Flight)

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

enum (Source)

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

object (EmissionsGramsPerPax)

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

object (EasaLabelMetadata)

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

enum (ContrailsImpactBucket)

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