- HTTP 请求
- 请求正文
- 响应正文
- FlightWithDetailedEmissions
- FlightEmissionsDetails
- EmissionsBreakdown
- EmissionsMetadata
- EmissionsProvenance
- EmissionsProvenance.EmissionsProvenanceEntry
- EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType
- EmissionsProvenance.EmissionsProvenanceEntry.DataSource
- EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy
- EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy
- EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy
- EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy
- EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy
- EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy
- EmissionsProvenance.EmissionsProvenanceEntry.DataCategory
- 试试看!
检索详细的排放量预估值。
详细的航班排放量数据是透明的人均温室气体排放量估算值,并辅以全面的元数据,详细说明了计算方法、排放量明细、航迹云影响和数据来源。
如需详细了解排放量预估值的计算方式,请参阅 GitHub。
响应将包含与输入航段匹配的所有条目,且顺序相同。如果某个航段没有可用的估算值,则响应将返回包含空白排放字段的航段对象。该请求仍会被视为成功。排放量预估值缺失的原因包括:
- 服务器无法识别该航班。
- 输入的航段缺少一个或多个标识符。
- 航班日期已过。
- 模型不支持该飞机类型。
- 缺少席位配置。
请求最多可包含 100 个航段。如果请求包含超过 100 个航段,则会失败并返回 INVALID_ARGUMENT 错误。
HTTP 请求
POST https://travelimpactmodel.googleapis.com/v1/flights:computeDetailedFlightEmissions
网址采用 gRPC 转码语法。
请求正文
请求正文中包含结构如下的数据:
| JSON 表示法 |
|---|
{
"flights": [
{
object ( |
| 字段 | |
|---|---|
flights[] |
必需。要返回排放量预估值的直飞航班。 |
响应正文
flights.computeDetailedFlightEmissions 响应的输出定义。
如果成功,响应正文将包含结构如下的数据:
| JSON 表示法 |
|---|
{ "flightsWithDetailedEmissions": [ { object ( |
| 字段 | |
|---|---|
flightsWithDetailedEmissions[] |
包含排放量预估值的航段列表。 |
modelVersion |
用于计算此响应中所有航班排放量预估值的模型版本。 |
FlightWithDetailedEmissions
直飞航班,包含排放量预估值详情。
| JSON 表示法 |
|---|
{ "flight": { object ( |
| 字段 | |
|---|---|
flight |
仅限输出。与请求中的航班标识符匹配。注意:所有 IATA 代码均采用大写形式。 |
flightEmissionsDetails |
仅限输出。所有航班排放数据。 |
emissionsMetadata |
仅限输出。有关航班排放量计算的其他元数据。 |
errors[] |
仅限输出。详细说明为何无法返回航班详细排放量估算值的错误。当存在排放量预估值时,此字段为空。 |
FlightEmissionsDetails
特定航班排放量的详细信息。
| JSON 表示法 |
|---|
{ "emissionsGramsPerPax": { object ( |
| 字段 | |
|---|---|
emissionsGramsPerPax |
仅限输出。每位乘客的排放量预估值。如果无法计算碳排放量,则不会显示。如需查看无法计算排放量的原因列表,请参阅 |
emissionsBreakdown |
仅限输出。有关 total emissionsGramsPerPax 值的各个排放量部分的详细信息。细分值之和应始终等于 emissionsGramsPerPax。 |
contrailsImpactBucket |
仅限输出。航迹云增温影响与总二氧化碳当量排放影响相比的显著性。 |
source |
仅限输出。排放数据的来源。 |
EmissionsBreakdown
有关 total emissionsGramsPerPax 值的各个排放量部分的详细信息。细分值之和应始终等于 emissionsGramsPerPax。
| JSON 表示法 |
|---|
{ "wttEmissionsGramsPerPax": { object ( |
| 字段 | |
|---|---|
wttEmissionsGramsPerPax |
每位乘客的燃料生产和运输阶段排放量预估值。如果无法计算碳排放量,则不会显示。如需查看无法计算排放量的原因列表,请参阅 |
ttwEmissionsGramsPerPax |
每位乘客的“从油箱到尾迹”排放量预估值。如果无法计算碳排放量,则不会显示。如需查看无法计算排放量的原因列表,请参阅 |
EmissionsMetadata
所有其他元数据。
| JSON 表示法 |
|---|
{ "emissionsProvenance": { object ( |
| 字段 | |
|---|---|
emissionsProvenance |
仅限输出。用于计算排放数据的来源详细信息,包括影响因素及其数据源。 |
easaLabelMetadata |
仅限输出。有关 EASA 航班排放量标签的元数据。仅在排放数据源为 EASA 时设置。 |
timWebsiteEmissionsCalculatorUrl |
仅限输出。 |
EmissionsProvenance
有关用于计算排放量估算值的数据来源的信息,包括影响因素及其数据源。
在 provenanceEntries 中,provenanceEntryType 充当标识影响因素的“键”,并且每种条目类型始终只有一个条目。每个条目中的其余字段描述了该特定条目类型,并且可能会或可能不会根据影响因素和可用数据进行填充。
| JSON 表示法 |
|---|
{
"provenanceEntries": [
{
object ( |
| 字段 | |
|---|---|
provenanceEntries[] |
仅限输出。用于计算排放量的所有影响因素。每个条目类型 ( |
EmissionsProvenance.EmissionsProvenanceEntry
排放量计算中单个影响因素的详细信息。每个条目代表一个因素,其中 provenanceEntryType 作为标识该因素的键,其他字段则描述该因素,这些字段可能已填充,也可能未填充。
| JSON 表示法 |
|---|
{ "provenanceEntryType": enum ( |
| 字段 | |
|---|---|
provenanceEntryType |
仅限输出。来源条目的类型。充当标识影响因素的“键”;此消息中的其余字段用于描述该因素,可能会填充,也可能不会填充。 |
source |
仅限输出。数据来源。 |
sourceVersion |
仅限输出。源数据的版本。例如“2025/04”。 |
dataCategory |
仅限输出。数据源的数据类别。 |
联合字段 data_strategy。用于计算给定数据源排放量的策略。字段集将与 data_source 类型相对应。data_strategy 只能是下列其中一项: |
|
fuelBurnEeaStrategy |
仅限输出。欧洲经济区 (EEA) 燃油消耗策略。 |
loadFactorsT100Strategy |
仅限输出。T100 载重因素策略。 |
loadFactorsChAviationStrategy |
仅限输出。CH Aviation 载重因素策略。 |
cargoMassFractionT100Strategy |
仅限输出。T100 货物质量分数策略。 |
seatAreaRatioIataStrategy |
仅限输出。IATA 座位区域比率策略。 |
distanceAdjustmentStrategy |
仅限输出。距离调整策略。 |
联合字段 data_value。给定数据源的数据值。字段集将与 provenance_entry_type 对应。data_value 只能是下列其中一项: |
|
loadFactorsData |
仅限输出。负载系数数据值。如果未设置,则负载系数的值不可用。 |
cargoMassFractionData |
仅限输出。货物质量分数。如果未设置,则货运质量分数不可用。 |
seatAreaRatioData |
仅限输出。每个舱位的座位面积比值。如果未设置,则座位面积比值不可用。 |
estimatedFlightDistanceKm |
仅限输出。使用距离调整系数 (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 中所定义。 |