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。 响应将包含与输入航班段匹配的所有条目，并且顺序相同。如果某个航段没有可用的估算值，则响应将返回包含空排放量字段的航段对象。相应请求仍会被视为成功。缺少排放量估算值的原因包括： 服务器无法识别相应航班。 输入的航班段缺少一个或多个标识符。 航班日期是过去的日期。 相应型号不支持该飞机类型。 缺少座位配置。 相应请求最多可包含 100 个航班段。如果请求包含的航班段超过 100 个，则会失败并显示 INVALID_ARGUMENT 错误。

ComputeFlightEmissions
rpc ComputeFlightEmissions(ComputeFlightEmissionsRequest) returns (ComputeFlightEmissionsResponse) 检索排放量估算值。如需详细了解排放量估算的计算方式，请参阅 GitHub。 响应将包含与输入航班段匹配的所有条目，并且顺序相同。如果某个航段没有可用的估算值，则响应将返回包含空排放量字段的航段对象。相应请求仍会被视为成功。缺少排放量估算值的原因包括： 服务器无法识别相应航班。 输入的航班段缺少一个或多个标识符。 航班日期是过去的日期。 相应型号不支持该飞机类型。 缺少座位配置。 相应请求最多可包含 1,000 个航班段。如果请求包含的直飞航班数量超过 1000 个，则会失败并显示 INVALID_ARGUMENT 错误。

ComputeScope3FlightEmissions

rpc ComputeScope3FlightEmissions(ComputeScope3FlightEmissionsRequest) returns (ComputeScope3FlightEmissionsResponse) 检索一组航班段的温室气体排放量估算值，以用于范围 3 报告。 响应将包含与输入 Scope3FlightSegment 航班段匹配的所有条目，且顺序与输入时相同。系统将使用以下级联逻辑计算估计值（使用第一个可用的值）： 基于 TIM 的排放量，给定 origin、destination、carrier、flightNumber、departureDate 和 cabinClass。 给定 origin、destination、年份（departureDate）和 cabinClass 时的典型航班排放量。 使用 distanceKm、departureDate 中的年份和 cabinClass 计算的基于距离的排放量。 如果此日历年内有未来航班请求，我们不支持 Tier 1 排放，并将回退到 Tier 2 或 3 排放。如果所请求的未来航班不在当前日历年内，我们将返回空响应。我们建议在未来的航班中使用 computeFlightEmissions API。 如果无法通过上述任一方法估算特定航班的碳排放量，响应将返回一个包含空排放量字段的 Scope3FlightEmissions 对象。相应请求仍会被视为成功。一般来说，如果服务器不知道相应航班（例如，不存在特定航班，或者没有所请求配对的典型航班排放量），则会缺少排放量估算值。 如果出现以下情况，请求将失败并显示 INVALID_ARGUMENT 错误： 相应请求包含的航班段超过 1,000 个。 输入的航班段缺少一个或多个标识符。例如，缺少起点/终点，且没有有效的距离（对于 TIM_EMISSIONS 或 TYPICAL_FLIGHT_EMISSIONS 类型匹配），或者缺少距离（对于 DISTANCE_BASED_EMISSIONS 类型匹配；如果您想回退到基于距离的排放量或想获得基于距离的排放量估算值，则需要指定距离）。 航班日期在 2019 年之前（范围 3 数据仅适用于 2019 年及之后）。 飞行距离为 0 或更低。 缺少舱位。 由于请求是使用回退逻辑处理的，因此配置错误的请求可能会使用回退方法返回有效的排放估算值。例如，如果请求的航班号有误，但指定了出发地和目的地，请求仍会成功，但返回的排放量将仅基于典型航班排放量。同样，如果请求缺少典型航班排放请求的来源，但指定了有效距离，则该请求可能会仅基于距离的排放量成功。因此，应检查返回的排放源 (source)，以确认结果是否符合预期。

ComputeTypicalFlightEmissions
rpc ComputeTypicalFlightEmissions(ComputeTypicalFlightEmissionsRequest) returns (ComputeTypicalFlightEmissionsResponse) 检索两个机场（也称为市场）之间的典型航班排放量估算值。如果某个市场没有可用的估算值，响应将返回包含空排放字段的市场对象。相应请求仍会被视为成功。 如需详细了解典型排放量估算的计算方式，请访问 GitHub。 请求最多可包含 1,000 个市场。如果请求包含的市场数量超过 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%。 此折扣和减排量由 EASA 标签报告，但未包含在此 API 分发的二氧化碳当量估算值中。

EmissionsBreakdown

有关总排放量（以 grams_per_pax 为单位）中各个排放部分的详细信息。汇总细分的值应始终等于 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 仅限输出。EEA 燃油消耗策略。
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

此类型没有字段。

用于估算欧洲经济区燃料消耗的策略。

策略

EEA 燃料消耗策略。未来可能会添加新值。客户端应准备好妥善处理未知枚举值。

枚举
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 仅限输出。有关总排放量（以 grams_per_pax 为单位）中各个排放部分的详细信息。汇总细分的值应始终等于 emissions_grams_per_pax。
contrails_impact_bucket	ContrailsImpactBucket 仅限输出。航迹云增温影响相对于二氧化碳当量总排放量影响的显著性。
source	Source 仅限输出。排放数据的来源。

FlightWithDetailedEmissions

直飞航班，包含排放量估算值详情。

字段
flight	Flight 仅限输出。匹配请求中的实验标识符。注意：所有 IATA 代码均采用大写形式。
flight_emissions_details	FlightEmissionsDetails 仅限输出。所有航班排放数据。
emissions_metadata	EmissionsMetadata 仅限输出。有关航班排放量计算的其他元数据。

FlightWithEmissions

直飞航班，并提供排放量预估值。

字段
flight	Flight 标识符。匹配请求中的实验标识符。注意：所有 IATA 代码均采用大写形式。
source	Source 可选。排放数据的来源。
emissions_grams_per_pax	EmissionsGramsPerPax 可选。每位乘客的排放量估算值。如果无法计算碳排放量，则不会显示此属性。如需查看无法计算排放量的原因列表，请参阅 ComputeFlightEmissions。
easa_label_metadata	EasaLabelMetadata 可选。有关 EASA 航班排放量标签的元数据。仅在排放数据源为 EASA 时进行设置。
contrails_impact_bucket	ContrailsImpactBucket 可选。航迹云增温影响相对于二氧化碳当量总排放量影响的显著性。

Market

一对机场。

字段
origin	string 必需。航班出发地的 IATA 机场代码，例如“LHR”。
destination	string 必需。航班目的地的 IATA 机场代码，例如“JFK”。

ModelVersion

旅行碳排放影响评估模型 (TIM) 版本。如需详细了解模型版本控制，请参阅 GitHub。

字段
major	int32 主要版本：方法发生重大变化（例如，向模型添加新数据源，导致输出发生重大变化）。此类变更不会经常发生，并且会提前很长时间公布。可能涉及 API 版本变更，这些变更将遵循 Google Cloud API 指南
minor	int32 次要版本：对模型进行的更改，虽然在各个架构版本中保持一致，但会更改模型参数或实现。
patch	int32 补丁版本：旨在解决模型实现中的 bug 或不准确之处的实现变更。
dated	string 基于日期的时间序列版本：模型数据集会定期使用刷新后的输入数据重新创建，但算法不会发生变化。

Scope3FlightEmissions

范围 3 航班（附有排放量预估值）。

字段
flight	Scope3FlightSegment 标识符。匹配请求中的实验标识符。
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	碳排放数据来自旅行碳排放影响评估模型 (TIM)。
EASA	排放数据来自 EASA 环保标签。

TypicalFlightEmissions

特定市场的典型航班排放量估算值

字段
market	Market 标识符。匹配请求中的实验标识符。注意：所有 IATA 代码均采用大写形式。
emissions_grams_per_pax	EmissionsGramsPerPax 可选。所请求市场的每位乘客的典型航班排放量。如果无法计算出典型排放量，则不会显示此属性。如需查看无法计算典型航班排放量的原因列表，请参阅 GitHub。