Method: flights.computeDetailedFlightEmissions

检索详细的排放量预估值。

详细的航班排放量数据是透明的人均温室气体排放量估算值,并辅以全面的元数据,详细说明了计算方法、排放量明细、航迹云影响和数据来源。

如需详细了解排放量预估值的计算方式,请参阅 GitHub。

响应将包含与输入航段匹配的所有条目,且顺序相同。如果某个航段没有可用的估算值,则响应将返回包含空白排放字段的航段对象。该请求仍会被视为成功。排放量预估值缺失的原因包括:

  • 服务器无法识别该航班。
  • 输入的航段缺少一个或多个标识符。
  • 航班日期已过。
  • 模型不支持该飞机类型。
  • 缺少席位配置。

请求最多可包含 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)
  },
  "errors": [
    {
      object (Status)
    }
  ]
}
字段
flight

object (Flight)

仅限输出。与请求中的航班标识符匹配。注意:所有 IATA 代码均采用大写形式。

flightEmissionsDetails

object (FlightEmissionsDetails)

仅限输出。所有航班排放数据。

emissionsMetadata

object (EmissionsMetadata)

仅限输出。有关航班排放量计算的其他元数据。

errors[]

object (Status)

仅限输出。详细说明为何无法返回航班详细排放量估算值的错误。当存在排放量预估值时,此字段为空。

FlightEmissionsDetails

特定航班排放量的详细信息。

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

object (EmissionsGramsPerPax)

仅限输出。每位乘客的排放量预估值。如果无法计算碳排放量,则不会显示。如需查看无法计算排放量的原因列表,请参阅 flights.computeDetailedFlightEmissions

emissionsBreakdown

object (EmissionsBreakdown)

仅限输出。有关 total emissionsGramsPerPax 值的各个排放量部分的详细信息。细分值之和应始终等于 emissionsGramsPerPax。

contrailsImpactBucket

enum (ContrailsImpactBucket)

仅限输出。航迹云增温影响与总二氧化碳当量排放影响相比的显著性。

source

enum (Source)

仅限输出。排放数据的来源。

EmissionsBreakdown

有关 total emissionsGramsPerPax 值的各个排放量部分的详细信息。细分值之和应始终等于 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

有关用于计算排放量估算值的数据来源的信息,包括影响因素及其数据源。

在 provenanceEntries 中,provenanceEntryType 充当标识影响因素的“键”,并且每种条目类型始终只有一个条目。每个条目中的其余字段描述了该特定条目类型,并且可能会或可能不会根据影响因素和可用数据进行填充。

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

object (EmissionsProvenance.EmissionsProvenanceEntry)

仅限输出。用于计算排放量的所有影响因素。每个条目类型 (provenanceEntryType) 都充当标识因素的“键”,每个条目类型始终只有一个条目。其余字段用于描述该特定因素,可能会填充,也可能不会填充。

EmissionsProvenance.EmissionsProvenanceEntry

排放量计算中单个影响因素的详细信息。每个条目代表一个因素,其中 provenanceEntryType 作为标识该因素的键,其他字段则描述该因素,这些字段可能已填充,也可能未填充。

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)

仅限输出。欧洲经济区 (EEA) 燃油消耗策略。

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 中所定义。