Method: flights.computeTypicalFlightEmissions

擷取兩個機場 (又稱市場) 之間的一般航班排放量預估值。如果特定市場沒有預估值,回應會傳回市場物件,但排放量欄位為空白。但系統仍會將要求視為成功。

如要進一步瞭解典型碳排放量估算值的計算方式,請參閱 GitHub

要求最多可包含 1000 個市場。如果要求包含超過 1000 個市場,系統會傳回 INVALID_ARGUMENT 錯誤,導致要求失敗。

HTTP 要求

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

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

要求主體

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

JSON 表示法
{
  "markets": [
    {
      object (Market)
    }
  ]
}
欄位
markets[]

object (Market)

必填。要求提供這個市場配對的一般航班排放量預估值。最多可要求 1000 個市場。

回應主體

回覆內容包括碳排放量和模型版本。

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

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

object (TypicalFlightEmissions)

要求該市場的一般航班排放量。

modelVersion

object (ModelVersion)

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

市場

一對機場。

JSON 表示法
{
  "origin": string,
  "destination": string
}
欄位
origin

string

必填。航班出發地機場的 IATA 機場代碼,例如「LHR」。

destination

string

必填。航班目的地的 IATA 機場代碼,例如「JFK」。

TypicalFlightEmissions

特定市場的一般航班碳排放量預估值

JSON 表示法
{
  "market": {
    object (Market)
  },
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
欄位
market

object (Market)

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

emissionsGramsPerPax

object (EmissionsGramsPerPax)

(選用步驟) 所要求市場中,每位乘客的一般航班排放量。如果無法計算一般排放量,就不會顯示這項資訊。如要查看無法計算一般航班碳排放量的原因清單,請參閱 GitHub