Package google.travel.sustainability.travelimpactmodel.v1

索引

• TravelImpactModelService (介面)
• ComputeDetailedFlightEmissionsRequest (訊息)
• ComputeDetailedFlightEmissionsResponse (訊息)
• ComputeFlightEmissionsRequest (訊息)
• ComputeFlightEmissionsResponse (訊息)
• ComputeScope3FlightEmissionsRequest (訊息)
• ComputeScope3FlightEmissionsResponse (訊息)
• ComputeTypicalFlightEmissionsRequest (訊息)
• ComputeTypicalFlightEmissionsResponse (訊息)
• ContrailsImpactBucket (列舉)
• EasaLabelMetadata (訊息)
• EmissionsBreakdown (訊息)
• EmissionsGramsPerPax (訊息)
• EmissionsMetadata (訊息)
• EmissionsProvenance (訊息)
• EmissionsProvenance.EmissionsProvenanceEntry (訊息)
• EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100 (訊息)
• EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy (列舉)
• EmissionsProvenance.EmissionsProvenanceEntry.DataCategory (列舉)
• EmissionsProvenance.EmissionsProvenanceEntry.DataSource (列舉)
• EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment (訊息)
• EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy (列舉)
• EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType (列舉)
• EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea (訊息)
• EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy (列舉)
• EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation (訊息)
• EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy (列舉)
• EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100 (訊息)
• EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy (列舉)
• EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData (訊息)
• EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata (訊息)
• EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy (列舉)
• Flight (訊息)
• FlightEmissionsDetails (訊息)
• FlightWithDetailedEmissions (訊息)
• FlightWithEmissions (訊息)
• Market (訊息)
• ModelVersion (訊息)
• Scope3FlightEmissions (訊息)
• Scope3FlightEmissions.Scope3DataType (列舉)
• Scope3FlightSegment (訊息)
• Scope3FlightSegment.CabinClass (列舉)
• Source (列舉)
• TypicalFlightEmissions (訊息)

TravelImpactModelService

API，可提供碳排放量估算值。

ComputeDetailedFlightEmissions

rpc ComputeDetailedFlightEmissions(ComputeDetailedFlightEmissionsRequest) returns (ComputeDetailedFlightEmissionsResponse) 擷取詳細的預估排放量。 詳細航班碳排放量是每位乘客溫室氣體排放量的預估值，並提供詳細的中繼資料，說明計算方法、碳排放量細目、飛機雲影響和資料來源。 如要進一步瞭解碳排放量估算方式，請參閱 GitHub。 回應會包含與輸入航班航段相符的所有項目，且順序相同。如果特定航段沒有預估值，回應會傳回航段物件，但排放量欄位為空白。系統仍會將要求視為成功。碳排放量預估值未顯示的原因包括： 伺服器無法辨識航班。 輸入的航班航段缺少一或多個 ID。 航班日期為過去的日期。 模型不支援該機型。 缺少座位設定。 要求最多可包含 100 個航班航段。如果要求包含超過 100 個航段，系統會傳回 INVALID_ARGUMENT 錯誤，導致要求失敗。

ComputeFlightEmissions
rpc ComputeFlightEmissions(ComputeFlightEmissionsRequest) returns (ComputeFlightEmissionsResponse) 擷取預估排放量。如要進一步瞭解碳排放量估算方式，請參閱 GitHub。 回應會包含與輸入航班航段相符的所有項目，且順序相同。如果特定航段沒有預估值，回應會傳回航段物件，但排放量欄位為空白。系統仍會將要求視為成功。碳排放量預估值未顯示的原因包括： 伺服器無法辨識航班。 輸入的航班航段缺少一或多個 ID。 航班日期為過去的日期。 模型不支援該機型。 缺少座位設定。 要求最多可包含 1000 個航班航段。如果要求包含超過 1000 個直飛航班，系統會傳回 INVALID_ARGUMENT 錯誤，導致要求失敗。

ComputeScope3FlightEmissions

rpc ComputeScope3FlightEmissions(ComputeScope3FlightEmissionsRequest) returns (ComputeScope3FlightEmissionsResponse) 擷取一組航班航段的溫室氣體排放量估計值，用於範圍 3 報告。 回應會包含與輸入的 Scope3FlightSegment 航班區段相符的所有項目，順序與輸入時相同。系統會使用下列層疊邏輯計算預估值 (使用第一個可用的值)： 根據 origin、destination、carrier、flightNumber、departureDate 和 cabinClass 提供的資料，以旅遊影響模型 (TIM) 為基礎計算的排放量。 origin、destination、departureDate 年和 cabinClass 的一般航班碳排放量。 使用 distanceKm、departureDate 和 cabinClass 計算的距離相關排放量。 如果今年度有未來的航班要求，我們不支援第 1 級排放量，將改用第 2 級或第 3 級排放量。如果要求的未來航班不在今年，我們會傳回空白回應。建議您在日後的測試中使用 computeFlightEmissions API。 如果使用上述任一方法，都無法取得特定航班的預估排放量，回應就會傳回 Scope3FlightEmissions 物件，但排放量欄位會留空。系統仍會將要求視為成功。一般來說，如果伺服器無法辨識航班 (例如沒有特定航班，或無法提供所要求配對的一般航班碳排放量)，就會發生碳排放量估算值遺失的情況。 如有下列情況，要求會失敗並顯示 INVALID_ARGUMENT 錯誤： 要求包含超過 1,000 個航班航段。 輸入的航班航段缺少一或多個 ID。舉例來說，如果缺少 TIM_EMISSIONS 或 TYPICAL_FLIGHT_EMISSIONS 類型相符項目的有效距離，或缺少 DISTANCE_BASED_EMISSIONS 類型相符項目的距離 (如要改用距離計算排放量或取得距離估算值，就必須指定距離)。 航班日期在 2019 年之前 (僅提供 2019 年之後的範圍 3 資料)。 飛行距離為 0 或更低。 缺少艙等。 由於系統會使用備用邏輯處理要求，因此設定錯誤的要求可能會使用備用方法傳回有效的排放量估算值。舉例來說，如果要求中的航班編號有誤，但指定了出發地和目的地，要求仍會成功，但傳回的排放量只會根據一般航班排放量計算。同樣地，如果一般航班碳排放量要求缺少出發地，但指定了有效距離，則要求可能會僅根據距離計算碳排放量，並成功執行。因此，請檢查傳回的排放量來源 (source)，確認結果符合預期。

ComputeTypicalFlightEmissions
rpc ComputeTypicalFlightEmissions(ComputeTypicalFlightEmissionsRequest) returns (ComputeTypicalFlightEmissionsResponse) 擷取兩個機場 (又稱市場) 之間的一般航班排放量預估值。如果特定市場沒有預估值，回應會傳回市場物件，但排放量欄位為空白。但系統仍會將要求視為成功。 如要進一步瞭解典型碳排放量估算值的計算方式，請參閱 GitHub。 要求最多可包含 1000 個市場。如果要求包含超過 1000 個市場，系統會傳回 INVALID_ARGUMENT 錯誤，導致要求失敗。

ComputeDetailedFlightEmissionsRequest

輸入 ComputeDetailedFlightEmissions 要求的定義。

欄位
flights[]	Flight 必填。直飛航班，可預估回程的碳排放量。

ComputeDetailedFlightEmissionsResponse

ComputeDetailedFlightEmissions 回應的輸出定義。

欄位
flights_with_detailed_emissions[]	FlightWithDetailedEmissions 列出各個航段的預估排放量。
model_version	ModelVersion 計算此回應中所有航班預估排放量時所用的模型版本。

ComputeFlightEmissionsRequest

輸入 ComputeFlightEmissions 要求的定義。

欄位
flights[]	Flight 必填。直飛航班，可預估回程的碳排放量。

ComputeFlightEmissionsResponse

ComputeFlightEmissions 回應的輸出定義。

欄位
flight_emissions[]	FlightWithEmissions 列出各個航段的預估排放量。
model_version	ModelVersion 計算此回應中所有航班預估排放量時所用的模型版本。

ComputeScope3FlightEmissionsRequest

要求範圍 3 排放量的航班航段清單。

欄位
flights[]	Scope3FlightSegment 必填。要傳回預估排放量的航班。
model_version	ModelVersion (選用步驟) 計算這項要求中所有航班預估排放量時所用的模型版本。

ComputeScope3FlightEmissionsResponse

內含預估範圍 3 排放量的航班清單。

欄位
flight_emissions[]	Scope3FlightEmissions 列出各個航段的預估排放量。
model_version	ModelVersion 計算此回應中所有航班預估排放量時所用的模型版本。

ComputeTypicalFlightEmissionsRequest

要求一般排放量的機場 (市場) 配對清單。

欄位
markets[]	Market 必填。請索取這個市場配對的一般航班排放量預估值。最多可要求 1,000 個市場。

ComputeTypicalFlightEmissionsResponse

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

欄位
typical_flight_emissions[]	TypicalFlightEmissions 要求該市場的一般航班排放量。
model_version	ModelVersion 計算此回應中所有航班的一般航班排放量估計值時所用的模型版本。

ContrailsImpactBucket

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

列舉
CONTRAILS_IMPACT_UNSPECIFIED	未指定凝結尾跡影響。
CONTRAILS_IMPACT_NEGLIGIBLE	相較於二氧化碳當量總排放量，凝結尾的影響微不足道。
CONTRAILS_IMPACT_MODERATE	飛機雲的影響與二氧化碳當量總排放量相當。
CONTRAILS_IMPACT_SEVERE	飛機雲的影響大於二氧化碳當量總排放量的影響。

EasaLabelMetadata

歐盟航空安全總署 (EASA) 航班排放量標籤的中繼資料。

欄位
label_issue_date	Date 標籤核發日期。
label_expiry_date	Date 標籤的有效期限。標籤會顯示到這個日期為止。
label_version	string 標籤版本。
saf_discount_percentage	double 標籤適用的永續航空燃料 (SAF) 排放量折扣百分比。以小數表示的百分比。值介於 [0,1] 之間。舉例來說，0.0021 代表 0.21%。 這項折扣和減排量是由歐盟航空安全總署標籤回報，但未納入此 API 分發的 CO2e 預估值。

EmissionsBreakdown

總排放量 (以每位乘客的克數為單位) 中，各項排放量所占的比例。加總的細目值應一律等於 emissions_grams_per_pax。

欄位
wtt_emissions_grams_per_pax	EmissionsGramsPerPax 每位乘客自開採到最終使用的預估碳排放量。如果無法計算碳排放量，就不會顯示這項資訊。如要查看無法計算碳排放量的原因清單，請參閱ComputeFlightEmissions。
ttw_emissions_grams_per_pax	EmissionsGramsPerPax 每位乘客的油箱到尾流排放量預估值。如果無法計算碳排放量，就不會顯示這項資訊。如要查看無法計算碳排放量的原因清單，請參閱ComputeFlightEmissions。

EmissionsGramsPerPax

依艙等分組的碳排放量結果。

欄位
first	int32 頭等艙一位乘客的排放量 (以公克為單位)。無論飛機是否設有頭等艙座位，系統一律會計算並填入這個欄位。
business	int32 商務艙一位乘客的排放量 (以公克為單位)。無論飛機是否有商務艙座位，系統一律會計算並填入這個欄位。
premium_economy	int32 豪華經濟艙一位乘客的排放量 (以公克為單位)。無論飛機是否設有豪華經濟艙座位，系統一律會計算並填入這個欄位。
economy	int32 經濟艙一位乘客的排放量 (以公克為單位)。無論飛機是否設有經濟艙座位，系統一律會計算並填入這個欄位。

EmissionsMetadata

所有其他中繼資料。

欄位
emissions_provenance	EmissionsProvenance 僅供輸出。用於計算碳排放量資料的資料出處詳細資料，包括影響因素及其資料來源。
easa_label_metadata	EasaLabelMetadata 僅供輸出。歐盟航空安全總署 (EASA) 航班排放量標籤的中繼資料。只有在排放量資料來源為 EASA 時，才需要設定這項屬性。
tim_website_emissions_calculator_url	string 僅供輸出。連結至 travelimpactmodel.org 碳排放量計算機網站。範例：https://travelimpactmodel.org/lookup/flight?itinerary=ZRH-BOS-LX-52-20261225。

EmissionsProvenance

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

欄位
provenance_entries[]	EmissionsProvenance.EmissionsProvenanceEntry 僅供輸出。用於計算排放量的所有影響因素。

EmissionsProvenanceEntry

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

欄位
provenance_entry_type	EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType 僅供輸出。出處項目的類型。
source	EmissionsProvenance.EmissionsProvenanceEntry.DataSource 僅供輸出。資料來源。
source_version	string 僅供輸出。來源資料的版本。例如「2025/04」。
data_category	EmissionsProvenance.EmissionsProvenanceEntry.DataCategory 僅供輸出。資料來源的資料類別。
聯集欄位 data_strategy。用來計算指定資料來源排放量的策略。欄位集會對應至 data_source 類型。data_strategy 只能是下列其中一項：
fuel_burn_eea_strategy	EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy 僅供輸出。歐盟經濟區燃料消耗策略。
load_factors_t100_strategy	EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy 僅供輸出。T100 載客量因素策略。
load_factors_ch_aviation_strategy	EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy 僅供輸出。CH Aviation 載客量因素策略。
cargo_mass_fraction_t100_strategy	EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy 僅供輸出。T100 貨物質量分數策略。
seat_area_ratio_iata_strategy	EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy 僅供輸出。IATA 座位區域比率策略。
distance_adjustment_strategy	EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy 僅供輸出。距離調整策略。
聯集欄位 data_value。指定資料來源的資料值。欄位集會對應至 provenance_entry_type。data_value 只能是下列其中一項：
load_factors_data	double 僅供輸出。負載係數資料值。如未設定，則無法取得負載係數值。
cargo_mass_fraction_data	double 僅供輸出。貨物質量分數值。如未設定，則無法取得貨物質量分數值。
seat_area_ratio_data	EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData 僅供輸出。各艙等的座位面積比值。如未設定，系統不會提供座位區域比率值。
estimated_flight_distance_km	int32 僅供輸出。使用距離調整係數 (DAF) 計算的 CCD 飛行階段預估飛行距離 (以公里為單位)。如未設定，系統就不會提供預估飛行距離值。

CargoMassFractionT100

這個類型沒有任何欄位。

用於 T100 貨物質量分數的策略。

策略

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

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

DataCategory

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

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

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	資料由倫敦帝國學院提供。

DistanceAdjustment

這個類型沒有任何欄位。

用於調整距離的策略。

策略

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

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

EmissionsProvenanceEntryType

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

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

FuelBurnEea

這個類型沒有任何欄位。

用於估算歐洲經濟區燃料燃燒量的策略。

策略

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

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

LoadFactorsChAviation

這個類型沒有任何欄位。

用於 CH-Aviation 乘載率的策略。

策略

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

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

LoadFactorsT100

這個類型沒有任何欄位。

用於 T100 負載係數的策略。

策略

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

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

SeatAreaRatioData

座位區域比率資料值。經濟艙一律為 1.0，做為參考點；其他艙等的值則相對於經濟艙。無論機上是否有該艙等，這 4 個欄位一律都會設定。

欄位
first	double 僅供輸出。第一個艙等資料值。
business	double 僅供輸出。商務艙艙等資料值。
premium_economy	double 僅供輸出。豪華經濟艙艙等資料值。
economy	double 僅供輸出。經濟艙艙等資料值。

SeatAreaRatioIata

這個類型沒有任何欄位。

IATA 座位區域比率所用的策略。

策略

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

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

檔期

與單一要求項目相關的所有詳細資料，用於直接航班排放量估算。

欄位
origin	string 必填。航班出發地機場的 IATA 機場代碼，例如「LHR」。
destination	string 必填。航班目的地的 IATA 機場代碼，例如「JFK」。
operating_carrier_code	string 必填。IATA 航空公司代碼，例如「AA」。
flight_number	int32 必填。航班編號，例如 324。
departure_date	Date 必填。航班日期 (以出發地機場時區為準)。必須是現在或未來的日期。

FlightEmissionsDetails

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

欄位
emissions_grams_per_pax	EmissionsGramsPerPax 僅供輸出。每位乘客的預估排放量。如果無法計算碳排放量，就不會顯示這項資訊。如需無法計算碳排放量的原因清單，請參閱ComputeDetailedFlightEmissions
emissions_breakdown	EmissionsBreakdown 僅供輸出。總排放量 (以每位乘客的克數為單位) 中，各項排放量所占的比例。加總的細目值應一律等於 emissions_grams_per_pax。
contrails_impact_bucket	ContrailsImpactBucket 僅供輸出。飛機雲暖化效應相較於二氧化碳當量總排放量影響的顯著程度。
source	Source 僅供輸出。排放量資料的來源。

FlightWithDetailedEmissions

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

欄位
flight	Flight 僅供輸出。與要求中的航班 ID 相符。注意：所有 IATA 代碼均為大寫。
flight_emissions_details	FlightEmissionsDetails 僅供輸出。所有航班碳排放量資料。
emissions_metadata	EmissionsMetadata 僅供輸出。航班排放量計算的其他中繼資料。

FlightWithEmissions

直飛航班，並提供預估排放量。

欄位
flight	Flight ID。與要求中的航班 ID 相符。注意：所有 IATA 代碼均為大寫。
source	Source (選用步驟) 排放量資料的來源。
emissions_grams_per_pax	EmissionsGramsPerPax (選用步驟) 每位乘客的預估排放量。如果無法計算碳排放量，就不會顯示這項資訊。如要查看無法計算碳排放量的原因清單，請參閱ComputeFlightEmissions。
easa_label_metadata	EasaLabelMetadata (選用步驟) 歐盟航空安全總署 (EASA) 航班排放量標籤的中繼資料。只有在排放量資料來源為 EASA 時，才需要設定這項屬性。
contrails_impact_bucket	ContrailsImpactBucket (選用步驟) 飛機雲暖化效應相較於二氧化碳當量總排放量影響的顯著程度。

市場

一對機場。

欄位
origin	string 必填。航班出發地機場的 IATA 機場代碼，例如「LHR」。
destination	string 必填。航班目的地的 IATA 機場代碼，例如「JFK」。

ModelVersion

旅遊影響模型版本。如要進一步瞭解模型版本控管，請參閱 GitHub。

欄位
major	int32 主要版本：方法有重大變更 (例如在模型中加入新資料來源，導致輸出結果出現重大變化)。這類異動不會經常發生，且我們會提前公告。可能涉及 API 版本變更，這會遵守 Google Cloud API 指南
minor	int32 次要版本：模型變更，與結構定義版本一致，但會變更模型參數或實作方式。
patch	int32 修補程式版本：實作變更，旨在解決模型實作中的錯誤或不準確之處。
dated	string 有日期的版本：模型資料集會以更新後的輸入資料重新建立，但演算法不會定期變更。

Scope3FlightEmissions

範圍 3 航班的預估排放量。

欄位
flight	Scope3FlightSegment ID。與要求中的航班 ID 相符。
wtw_emissions_grams_per_pax	int64 (選用步驟) 根據要求資訊，每位乘客的航班排放總量 (油井到油箱和油箱到尾流的排放量總和)。這是排放總量，除非有使用 TTW 或 WTT 排放量的具體原因，否則應使用這個數字。
ttw_emissions_grams_per_pax	int64 (選用步驟) 根據要求資訊，計算每位乘客的「油箱到尾流」航班排放量。
wtt_emissions_grams_per_pax	int64 (選用步驟) 根據要求資訊，計算每位乘客的油井到油箱航班排放量。
source	Scope3FlightEmissions.Scope3DataType (選用步驟) 排放量資料的來源。

Scope3DataType

用於計算範圍 3 排放量的比對類型。用於範圍 3 回覆，標示計算排放量所用的方法。

列舉
SCOPE3_DATA_TYPE_UNSPECIFIED	未指定資料類型。
TIM_EMISSIONS	根據出發地、目的地、航空公司、航班編號、出發日期和年份，計算出 TIM 排放量。
TYPICAL_FLIGHT_EMISSIONS	特定出發地、目的地和年份的一般航班碳排放量。
DISTANCE_BASED_EMISSIONS	根據行駛距離和年份計算的排放量。

Scope3FlightSegment

用來擷取範圍 3 排放量的航班參數。

欄位
departure_date	Date 必填。航班日期 (以出發地機場時區為準)。一般航班和距離計算排放量模式只需要年份 (系統會忽略月份和日期值，因此可以省略、設為 0 或設為有效日期)。因此，如果未提供 TIM 排放量的特定日期，我們會改用一般航班 (或以距離為準) 的排放量。
cabin_class	Scope3FlightSegment.CabinClass 必填。航班的艙等。
origin	string (選用步驟) 航班出發地的 3 個字元 IATA 機場代碼，例如 YVR。如果同時提供目的地、航空公司和航班編號，系統就會使用這項資訊比對特定航班。如果沒有相符的航班，系統會先嘗試比對所提供出發和抵達機場之間的典型航班。否則，如果提供航班距離，我們會使用以距離為準的排放量模式。
destination	string (選用步驟) 航班目的地的 3 個字元 IATA 機場代碼，例如 ICN。如果提供出發地、航空公司和航班編號，系統會使用這項資訊比對特定航班。如果沒有相符的航班，系統會先嘗試比對所提供出發和抵達機場之間的典型航班。否則，如果提供航班距離，我們會使用以距離為準的排放量模式。
carrier_code	string (選用步驟) 2 個字元的 IATA 航空公司代碼，例如 KE。如要比對特定航班，就必須提供這項資訊。否則，這項資料不會用於一般航班和距離的碳排放量模型。這可以是承運和銷售航空公司代碼 (即涵蓋代碼共用)。
flight_number	int32 (選用步驟) 最多 4 位數的航班編號，例如 71，範圍為 [1, 9999]。如果指定出發地、目的地和航空公司，系統會先使用這項資訊比對特定航班。如果未指定航班編號，系統會先嘗試比對航班與所提供出發地和目的地機場之間的典型航班。如果失敗，且/或未提供起點和目的地，我們會根據提供的飛行距離，使用以距離為準的排放量模型。
distance_km	int64 (選用步驟) 以公里為單位，例如 2423，範圍為 [1, 2.5e16) 公里。如果未提供起點和目的地，或沒有相符的典型航班，系統會根據這項資訊比對航班與距離相關的排放量。

CabinClass

航班的艙等。

列舉
CABIN_CLASS_UNSPECIFIED	未指定艙等。
ECONOMY	經濟艙。
PREMIUM_ECONOMY	豪華經濟艙。
BUSINESS	商務艙。
FIRST	頭等艙。

來源

排放量資料的來源。

列舉
SOURCE_UNSPECIFIED	碳排放量資料來源不明。
TIM	排放量資料來自旅遊影響模型。
EASA	排放量資料來自歐盟航空安全總署 (EASA) 的環保標籤。

TypicalFlightEmissions

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

欄位
market	Market ID。與要求中的航班 ID 相符。注意：所有 IATA 代碼均為大寫。
emissions_grams_per_pax	EmissionsGramsPerPax (選用步驟) 所要求市場中，每位乘客的一般航班排放量。如果無法計算一般排放量，就不會顯示這項資訊。如要查看無法計算一般航班碳排放量的原因清單，請參閱 GitHub。