Method: flights.computeFlightEmissions

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

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

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

请求最多可包含 1,000 个航班航段。如果请求包含 1, 000 个以上的直飞航班，则会失败并显示 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)

必需。航班在出发地机场时区的日期。必须是当前或未来的日期。

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 排放量数据来自 Travel Impact Model。
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 航迹云影响高于二氧化碳当量总排放量影响。