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)
  }
}
字段
flight

object (Flight)

仅限输出。匹配请求中的实验标识符。注意：所有 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)

仅限输出。有关“每位乘客的排放量”（以克为单位）总排放量的各个排放部分的详细信息。汇总细分的值应始终等于 emissionsGramsPerPax。
contrailsImpactBucket

enum (ContrailsImpactBucket)

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

enum (Source)

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

EmissionsBreakdown

有关“每位乘客的排放量”（以克为单位）总排放量的各个排放部分的详细信息。汇总细分的值应始终等于 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)

仅限输出。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

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

枚举
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 中定义的默认值数据。