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 相符。注意:所有 IATA 代碼皆為大寫。

emissionsGramsPerPax

object (EmissionsGramsPerPax)

(非必要) 所要求市場的一般航班排放量 (每位乘客)。如果無法計算典型排放量,就不會顯示。如要瞭解無法計算一般航班碳排放量的理由,請參閱 GitHub