Method: flights.computeFlightEmissions

用于检索排放量估算的无状态方法。如需详细了解排放量估算值的计算方式，请参阅 GitHub

响应将包含与输入航段匹配的所有条目，并按相同的顺序排列。如果某个航段没有估算值，则响应将返回包含空排放量字段的航段对象。相应请求仍会被视为成功。排放量估计值缺失的原因包括：

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

该请求最多可包含 1,000 个航班段。如果请求包含的直飞航班超过 1000 个，则会失败并显示 INVALID_ARGUMENT 错误。

HTTP 请求

POST https://travelimpactmodel.googleapis.com/v1/flights:computeFlightEmissions

网址采用 gRPC 转码语法。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "flights": [
    {
      object (Flight)
    }
  ]
}
字段
flights[]

object (Flight)

必需。直飞航班，用于返回排放量估算值。

响应正文

针对 flights.computeFlightEmissions 响应的输出定义。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "flightEmissions": [
    {
      object (FlightWithEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
字段
flightEmissions[]

object (FlightWithEmissions)

包含排放量预估值的航段列表。
modelVersion

object (ModelVersion)

计算此响应中所有航班的排放量估算值所依据的模型版本。

机票

与直飞航班排放量估算值的单个请求项相关的所有详细信息。

JSON 表示法 
{
  "origin": string,
  "destination": string,
  "operatingCarrierCode": string,
  "flightNumber": integer,
  "departureDate": {
    object (Date)
  }
}
字段
origin

string

必需。航班出发地的 IATA 机场代码，例如“LHR”。
destination

string

必需。航班目的地的 IATA 机场代码，例如“JFK”。
operatingCarrierCode

string

必需。IATA 航空公司代码，例如“AA”。
flightNumber

integer

必需。航班号，例如 324。
departureDate

object (Date)

必需。航班日期（以始发机场的时区为准）。必须是当前或未来的日期。

日期

表示整个或部分日历日期（例如生日）。一天中的时间和时区要么在别处指定，要么不重要。日期相对于公历。可以表示以下任一情况：

  • 包含非零年份、月份和天值的完整日期。
  • 月份和天，年份值为零（例如周年纪念日）。
  • 单独的年份，月份和天值为零。
  • 年份和月份，天值为零（例如，信用卡到期日期）。

相关类型：

JSON 表示法 
{
  "year": integer,
  "month": integer,
  "day": integer
}
字段
year

integer

日期中的年份。必须介于 1 到 9999 之间，或为 0（即指定不含年份的日期）。
month

integer

一年中的第几个月。必须介于 1 到 12 之间，或为 0（即只指定年份，不指定月份和天值）。
day

integer

一个月中的第几天。必须介于 1 到 31 之间并且对年份和月份有效，或为 0（即天不重要，指定单独的年份或者年份和月份）。

FlightWithEmissions

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

JSON 表示法 
{
  "flight": {
    object (Flight)
  },
  "source": enum (Source),
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket)
}
字段
flight

object (Flight)

必需。匹配请求中的实验标识符。注意：所有 IATA 代码均采用大写形式。
source

enum (Source)

可选。排放数据来源。
emissionsGramsPerPax

object (EmissionsGramsPerPax)

可选。每位乘客的排放量预估值。如果无法计算碳排放量，则不会显示此属性。如需查看无法计算排放量的原因列表，请参阅 flights.computeFlightEmissions。
easaLabelMetadata

object (EasaLabelMetadata)

可选。有关 EASA 航班排放量标签的元数据。仅在排放数据源为 EASA 时设置。
contrailsImpactBucket

enum (ContrailsImpactBucket)

可选。航迹云增温影响相对于二氧化碳当量总排放量影响的显著性。

来源

排放数据来源。

枚举
SOURCE_UNSPECIFIED 碳排放数据的来源未指定。
TIM 排放数据来自旅行影响模型。
EASA 排放数据来自 EASA 环保标签。

EasaLabelMetadata

有关 EASA 航班排放量标签的元数据。

JSON 表示法 
{
  "labelIssueDate": {
    object (Date)
  },
  "labelExpiryDate": {
    object (Date)
  },
  "labelVersion": string,
  "safDiscountPercentage": number
}
字段
labelIssueDate

object (Date)

标签的签发日期。
labelExpiryDate

object (Date)

标签的失效日期。标签可显示至此日期结束。
labelVersion

string

标签的版本。
safDiscountPercentage

number

应用于标签的可再生航空燃料 (SAF) 排放折扣百分比。以小数形式表示的百分比。这些值介于区间 [0,1] 内。例如，0.0021 表示 0.21%。

此折扣和减排量由 EASA 标签报告，但未包含在此 API 分发的二氧化碳当量估算值中。

ContrailsImpactBucket

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

枚举
CONTRAILS_IMPACT_UNSPECIFIED 未指定凝结尾迹影响。
CONTRAILS_IMPACT_NEGLIGIBLE 与二氧化碳当量总排放量相比，航迹云的影响微不足道。
CONTRAILS_IMPACT_MODERATE 航迹云的影响与二氧化碳当量的总排放量相当。
CONTRAILS_IMPACT_SEVERE 航迹云的影响高于二氧化碳当量排放总量的影响。