擷取兩個機場 (也稱為市場) 之間的一般航班排放量預估值。如果某個市場沒有可用的預估值,回應會傳回含有空白廣告活動欄位的市場物件。系統仍會視為成功。
如要進一步瞭解系統如何計算一般排放量估計值,請前往 GitHub。
要求最多可包含 1000 個市場。如果要求包含的市場超過 1000 個,系統會傳回 INVALID_ARGUMENT 錯誤,並導致要求失敗。
HTTP 要求
POST https://travelimpactmodel.googleapis.com/v1/flights:computeTypicalFlightEmissions
這個網址使用 gRPC 轉碼語法。
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{
"markets": [
{
object ( |
欄位 | |
---|---|
markets[] |
必要欄位。請要求系統提供這個航線組合的一般航班排放量預估值。最多可要求 1000 個市場。 |
回應主體
回應除了包含排放量,也會提供模型版本。
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
---|
{ "typicalFlightEmissions": [ { object ( |
欄位 | |
---|---|
typicalFlightEmissions[] |
要求的市場一般航班排放量。 |
modelVersion |
系統根據這個回應中所有航班的一般航班排放量預估值,所使用的模型版本。 |
市場
一對機場。
JSON 表示法 |
---|
{ "origin": string, "destination": string } |
欄位 | |
---|---|
origin |
必要欄位。航班出發地機場的 IATA 機場代碼,例如「LHR」。 |
destination |
必要欄位。航班目的地機場 IATA 代碼,例如「JFK」。 |
TypicalFlightEmissions
特定市場的一般航班排放量預估值
JSON 表示法 |
---|
{ "market": { object ( |
欄位 | |
---|---|
market |
必要欄位。與要求中的航班 ID 相符。注意:所有 IATA 代碼皆為大寫。 |
emissionsGramsPerPax |
(非必要) 所要求市場的一般航班排放量 (每位乘客)。如果無法計算典型排放量,就不會顯示。如要瞭解無法計算一般航班碳排放量的理由,請參閱 GitHub。 |