擷取兩個機場 (又稱市場) 之間的一般航班排放量預估值。如果特定市場沒有預估值,回應會傳回市場物件,但排放量欄位為空白。但系統仍會將要求視為成功。
如要進一步瞭解典型碳排放量估算值的計算方式,請參閱 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。與要求中的航班 ID 相符。注意:所有 IATA 代碼均為大寫。 |
emissionsGramsPerPax |
(選用步驟) 所要求市場中,每位乘客的一般航班排放量。如果無法計算一般排放量,就不會顯示這項資訊。如要查看無法計算一般航班碳排放量的原因清單,請參閱 GitHub。 |