Method: flights.computeDetailedFlightEmissions

擷取詳細的預估排放量。

詳細航班碳排放量是每位乘客溫室氣體排放量的預估值，並提供詳細的中繼資料，說明計算方法、碳排放量細目、飛機雲影響和資料來源。

如要進一步瞭解碳排放量估算方式，請參閱 GitHub。

回應會包含與輸入航班航段相符的所有項目，且順序相同。如果特定航段沒有預估值，回應會傳回航段物件，但排放量欄位為空白。系統仍會將要求視為成功。碳排放量預估值未顯示的原因包括：

  • 伺服器無法辨識航班。
  • 輸入的航班航段缺少一或多個 ID。
  • 航班日期為過去的日期。
  • 模型不支援該機型。
  • 缺少座位設定。

要求最多可包含 100 個航班航段。如果要求包含超過 100 個航段，系統會傳回 INVALID_ARGUMENT 錯誤，導致要求失敗。

HTTP 要求

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

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

要求主體

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

JSON 表示法 
{
  "flights": [
    {
      object (Flight)
    }
  ]
}
欄位
flights[]

object (Flight)

必填。直飛航班，可預估回程的碳排放量。

回應主體

flights.computeDetailedFlightEmissions 回應的輸出定義。

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

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

object (FlightWithDetailedEmissions)

列出各個航段的預估排放量。
modelVersion

object (ModelVersion)

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

FlightWithDetailedEmissions

直飛航班，並提供預估碳排放量詳細資料。

JSON 表示法 
{
  "flight": {
    object (Flight)
  },
  "flightEmissionsDetails": {
    object (FlightEmissionsDetails)
  },
  "emissionsMetadata": {
    object (EmissionsMetadata)
  }
}
欄位
flight

object (Flight)

僅供輸出。與要求中的航班 ID 相符。注意：所有 IATA 代碼均為大寫。
flightEmissionsDetails

object (FlightEmissionsDetails)

僅供輸出。所有航班碳排放量資料。
emissionsMetadata

object (EmissionsMetadata)

僅供輸出。航班排放量計算的其他中繼資料。

FlightEmissionsDetails

特定航班的排放量詳細資料。

JSON 表示法 
{
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "emissionsBreakdown": {
    object (EmissionsBreakdown)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket),
  "source": enum (Source)
}
欄位
emissionsGramsPerPax

object (EmissionsGramsPerPax)

僅供輸出。每位乘客的預估排放量。如果無法計算碳排放量，就不會顯示這項資訊。如需無法計算碳排放量的原因清單，請參閱flights.computeDetailedFlightEmissions
emissionsBreakdown

object (EmissionsBreakdown)

僅供輸出。總排放量 (GramsPerPax 值) 中各項排放量的詳細資料。加總的細目值應一律等於 emissionsGramsPerPax。
contrailsImpactBucket

enum (ContrailsImpactBucket)

僅供輸出。飛機雲暖化效應相較於二氧化碳當量總排放量影響的顯著程度。
source

enum (Source)

僅供輸出。排放量資料的來源。

EmissionsBreakdown

總排放量 (GramsPerPax 值) 中各項排放量的詳細資料。加總的細目值應一律等於 emissionsGramsPerPax。

JSON 表示法 
{
  "wttEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "ttwEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
欄位
wttEmissionsGramsPerPax

object (EmissionsGramsPerPax)

每位乘客自開採到最終使用的預估碳排放量。如果無法計算碳排放量，就不會顯示這項資訊。如要查看無法計算碳排放量的原因清單，請參閱flights.computeFlightEmissions。
ttwEmissionsGramsPerPax

object (EmissionsGramsPerPax)

每位乘客的油箱到尾流排放量預估值。如果無法計算碳排放量，就不會顯示這項資訊。如要查看無法計算碳排放量的原因清單，請參閱flights.computeFlightEmissions。

EmissionsMetadata

所有其他中繼資料。

JSON 表示法 
{
  "emissionsProvenance": {
    object (EmissionsProvenance)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "timWebsiteEmissionsCalculatorUrl": string
}
欄位
emissionsProvenance

object (EmissionsProvenance)

僅供輸出。用於計算碳排放量資料的資料出處詳細資料，包括影響因素及其資料來源。
easaLabelMetadata

object (EasaLabelMetadata)

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

string

僅供輸出。連結至 travelimpactmodel.org 碳排放量計算機網站。範例：https://travelimpactmodel.org/lookup/flight?itinerary=ZRH-BOS-LX-52-20261225。

EmissionsProvenance

用於計算預估排放量的資料出處資訊，包括影響因素和資料來源。

JSON 表示法 
{
  "provenanceEntries": [
    {
      object (EmissionsProvenance.EmissionsProvenanceEntry)
    }
  ]
}
欄位
provenanceEntries[]

object (EmissionsProvenance.EmissionsProvenanceEntry)

僅供輸出。用於計算排放量的所有影響因素。

EmissionsProvenance.EmissionsProvenanceEntry

碳排放量計算中單一影響因素的詳細資料。

JSON 表示法 
{
  "provenanceEntryType": enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType),
  "source": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource),
  "sourceVersion": string,
  "dataCategory": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory),

  // Union field data_strategy can be only one of the following:
  "fuelBurnEeaStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy),
  "loadFactorsT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy),
  "loadFactorsChAviationStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy),
  "cargoMassFractionT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy),
  "seatAreaRatioIataStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy),
  "distanceAdjustmentStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)
  // End of list of possible types for union field data_strategy.

  // Union field data_value can be only one of the following:
  "loadFactorsData": number,
  "cargoMassFractionData": number,
  "seatAreaRatioData": {
    object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)
  },
  "estimatedFlightDistanceKm": integer
  // End of list of possible types for union field data_value.
}
欄位
provenanceEntryType

enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType)

僅供輸出。出處項目的類型。
source

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource)

僅供輸出。資料來源。
sourceVersion

string

僅供輸出。來源資料的版本。例如「2025/04」。
dataCategory

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory)

僅供輸出。資料來源的資料類別。
聯集欄位 data_strategy。用來計算指定資料來源排放量的策略。欄位集會對應至 data_source 類型。data_strategy 只能是下列其中一項：
fuelBurnEeaStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy)

僅供輸出。歐盟經濟區燃料消耗策略。
loadFactorsT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy)

僅供輸出。T100 載客量因素策略。
loadFactorsChAviationStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy)

僅供輸出。CH Aviation 載客量因素策略。
cargoMassFractionT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy)

僅供輸出。T100 貨物質量分數策略。
seatAreaRatioIataStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy)

僅供輸出。IATA 座位區域比率策略。
distanceAdjustmentStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)

僅供輸出。距離調整策略。
聯集欄位 data_value。指定資料來源的資料值。欄位集會對應至 provenance_entry_type。data_value 只能是下列其中一項：
loadFactorsData

number

僅供輸出。負載係數資料值。如未設定，則無法取得負載係數值。
cargoMassFractionData

number

僅供輸出。貨物質量分數值。如未設定，則無法取得貨物質量分數值。
seatAreaRatioData

object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)

僅供輸出。各艙等的座位面積比值。如未設定，系統不會提供座位區域比率值。
estimatedFlightDistanceKm

integer

僅供輸出。使用距離調整係數 (DAF) 計算的 CCD 飛行階段預估飛行距離 (以公里為單位)。如未設定，系統就不會提供預估飛行距離值。

EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType

出處項目的類型。日後可能會新增值。用戶端應準備好妥善處理不明的列舉值。

列舉
EMISSIONS_PROVENANCE_ENTRY_TYPE_UNSPECIFIED 未指定出處項目類型。
FUEL_BURN 燃料消耗記錄類型。
LOAD_FACTORS 載入因素項目類型。
CARGO_MASS_FRACTION 貨物質量分數輸入類型。
SEATING_CONFIG 座位配置項目類型。
SEAT_AREA_RATIOS 座位區比率輸入類型。
DISTANCE_ADJUSTMENT 距離調整項類型。

EmissionsProvenance.EmissionsProvenanceEntry.DataSource

碳排放量來源因素的資料來源。日後可能會新增值。用戶端應準備好妥善處理不明的列舉值。

列舉
DATA_SOURCE_UNSPECIFIED 未指定資料來源。
EEA 資料由歐洲環境署 (EEA) 提供。
T100 資料來源為美國運輸統計局提供的 T-100 資料集。
CH_AVIATION 資料由 ch-aviation 提供。
OAG 資料由 Official Aviation Guide (OAG) 提供。
OPERATING_CARRIER 營運航空公司提供的資料。
AIRCRAFT_MODEL_TYPICAL 根據機型提供的典型資料。
GLOBAL_DEFAULT 全域預設值，用於沒有其他資料來源時。
IATA 資料由國際航空運輸協會 (IATA) 提供。
ICL 資料由倫敦帝國學院提供。

EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy

歐盟燃料消耗策略。日後可能會新增值。用戶端應準備好妥善處理不明的列舉值。

列舉
STRATEGY_UNSPECIFIED 未指定策略。
AIRCRAFT_MAPPING_FALLBACK_WITH_CORRECTION_FACTOR 已套用靜態修正係數。
AIRCRAFT_MAPPING_EXACT 使用精確的飛機對應。
AIRCRAFT_MAPPING_FALLBACK 系統使用備用飛機對應。

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy

T100 載客量因素策略。日後可能會新增值。用戶端應準備好妥善處理不明的列舉值。

列舉
STRATEGY_UNSPECIFIED 未指定策略。
CARRIER_ROUTE_MONTH 依航空公司、路線和旅行月份劃分的資料。
CARRIER_MONTH 依貨運公司和旅行月份劃分的資料。
ACTUAL_CARRIER_ROUTE_YEAR_MONTH 與航空公司、路線、年份和月份相符的歷來資料。

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy

CH-Aviation 載客量因素策略。日後可能會新增值。用戶端應準備好妥善處理不明的列舉值。

列舉
STRATEGY_UNSPECIFIED 未指定策略。
CARRIER_MONTH 依貨運公司和旅行月份劃分的資料。
ACTUAL_CARRIER_YEAR_MONTH 符合電信業者、年份和月份的歷來資料。

EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy

T100 貨物質量分數策略。日後可能會新增值。用戶端應準備好妥善處理不明的列舉值。

列舉
STRATEGY_UNSPECIFIED 未指定策略。
CARRIER_ROUTE_AIRCRAFT_CLASS 按航空公司、航線和機型分類的資料。
ROUTE_AIRCRAFT_CLASS 按航線和機艙等級分類的資料。
DISTANCE_AIRCRAFT_CLASS 按距離帶和機型類別劃分的資料。
ACTUAL_CARRIER_ROUTE_YEAR_MONTH_AIRCRAFT_CLASS 與航空公司、路線、年份、月份和機艙等級相符的歷來資料。

EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy

IATA 座位區域比率策略。日後可能會新增值。用戶端應準備好妥善處理不明的列舉值。

列舉
STRATEGY_UNSPECIFIED 未指定策略。
NARROW_AIRCRAFT_BODY 使用窄體飛機的座位區域比率。
WIDE_AIRCRAFT_BODY 使用廣體飛機的座位區域比率。

EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy

距離調整策略。日後可能會新增值。用戶端應準備好妥善處理不明的列舉值。

列舉
STRATEGY_UNSPECIFIED 未指定策略。
ORIGIN_DESTINATION 距離調整係數取決於出發地和目的地機場組合。
COUNTRY_PAIR 距離調整係數，由出發地和目的地國家/地區配對決定。
DEFAULT 由於我們未找到機場或國家/地區專屬的調整因素，因此距離調整因素是根據預設值計算。

EmissionsProvenance.EmissionsProvenanceEntry.DataCategory

資料來源的資料類別。日後可能會新增值。用戶端應準備好妥善處理不明的列舉值。

列舉
DATA_CATEGORY_UNSPECIFIED 未指定資料類別。
PRIMARY ISO 14083 定義的主要資料。
MODELED 根據 ISO 14083 定義的模擬資料。
DEFAULT ISO 14083 中定義的預設值資料。