Method: flights.computeFlightEmissions

用于检索排放量预估的无状态方法。有关如何计算排放量预估值的详细信息：https://github.com/google/travel-impact-model

响应将包含与输入飞行路程匹配的所有条目（顺序相同）。如果无法针对特定飞行段提供预估值，则响应将返回发射字段为空的飞行段对象。该请求仍会被视为成功。缺少排放量预估值的原因包括：

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

请求最多可包含 1000 个航段。如果请求包含的直飞航班超过 1000 个，则 将会失败，并返回 INVALID_STRING 错误。

HTTP 请求

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

网址采用 gRPC 转码语法。

请求正文

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

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

object (Flight)

必需。要为其返回排放量预估值的直飞航班。

响应正文

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

[flights.computeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.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)

必需。航班日期（采用出发地机场所在时区）。必须是当前或将来的日期。

日期

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

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

相关类型：

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)
  },
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
字段
flight

object (Flight)

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

object (EmissionsGramsPerPax)

可选。每位乘客的排放量预估值。如果无法计算排放量，则此值将不存在。如需查看无法计算排放量的原因列表，请参阅 [flights.computeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.ComputeFlightEmissions]。

EmissionsGramsPerPax

按舱位结果分组的排放量。

JSON 表示法 
{
  "first": integer,
  "business": integer,
  "premiumEconomy": integer,
  "economy": integer
}
字段
first

integer

头等舱中一位乘客的排放量（以克为单位）。无论飞机是否具有头等舱座位，此字段始终会计算和填充。
business

integer

一名商务舱乘客的排放量（以克为单位）。无论飞机是否具有商务舱座位，此字段始终会计算和填充。
premiumEconomy

integer

一名乘客的高级经济舱排放量（以克为单位）。无论飞机是否具有高级经济舱座位，此字段始终会计算和填充。
economy

integer

一位乘客的经济舱排放量（以克为单位）。无论飞机是否具有经济舱座位，此字段始终会计算和填充。

ModelVersion

旅行影响模型版本。如需详细了解模型版本控制，请参阅 https://github.com/google/travel-impact-model/#versioning。

JSON 表示法 
{
  "major": integer,
  "minor": integer,
  "patch": integer,
  "dated": string
}
字段
major

integer

主要版本：方法的重大更改（例如，向模型中添加新的数据源会导致输出内容发生重大变化）。此类更改没有频繁发生，并会提前公布。可能涉及 API 版本更改，这些更改将遵循 https://cloud.google.com/endpoints/docs/openapi/versioning-an-api#backwards-incompatible 中的准则
minor

integer

次要版本：对模型所做的更改，虽然在架构版本之间保持一致，但会更改模型参数或实现。
patch

integer

补丁版本：旨在解决模型实现中的错误或不准确的实现变更。
dated

string

注明日期的版本：系统会使用刷新的输入数据重新创建模型数据集，但不会定期对算法进行更改。