Package google.travel.sustainability.travelimpactmodel.v1

索引

• TravelImpactModelService（接口）
• ComputeFlightEmissionsRequest（消息）
• ComputeFlightEmissionsResponse（消息）
• EmissionsGramsPerPax（消息）
• Flight（消息）
• FlightWithEmissions（消息）
• ModelVersion（消息）

TravelImpactModelService

通过 API 提供碳排放量预估值。

ComputeFlightEmissions
rpc ComputeFlightEmissions(ComputeFlightEmissionsRequest) returns (ComputeFlightEmissionsResponse) 用于检索排放量预估的无状态方法。有关如何计算排放量预估值的详细信息：https://github.com/google/travel-impact-model 响应将包含与输入飞行路程匹配的所有条目（顺序相同）。如果无法针对特定飞行段提供预估值，则响应将返回发射字段为空的飞行段对象。该请求仍会被视为成功。缺少排放量预估值的原因包括： 服务器无法识别该航班。 输入的航段缺少一个或多个标识符。 排期是过去的日期。 此模型不支持该飞机类型。 缺少座位配置。 请求最多可包含 1000 个航段。如果请求包含的直飞航班超过 1000 个，则 将会失败，并返回 INVALID_STRING 错误。

ComputeFlightEmissionsRequest

[ComputeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.ComputeFlightEmissions] 请求的输入定义。

字段
flights[]	Flight 必需。要为其返回排放量预估值的直飞航班。

ComputeFlightEmissionsResponse

[ComputeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.ComputeFlightEmissions] 响应的输出定义。

字段
flight_emissions[]	FlightWithEmissions 航段列表（含排放量预估值）。
model_version	ModelVersion 计算此响应中所有航班的排放量预估值时使用的模型版本。

EmissionsGramsPerPax

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

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

广告投放期

与某个请求项目直接关联的航班排放量预估值相关的所有详情。

字段
origin	string 必需。航班出发地的 IATA 机场代码，例如“LHR”。
destination	string 必需。航班目的地的 IATA 机场代码，例如“JFK”。
operating_carrier_code	string 必需。IATA 运营商代码，例如“AA”。
flight_number	int32 必需。航班号，例如 324。
departure_date	Date 必需。航班日期（采用出发地机场所在时区）。必须是当前或将来的日期。

FlightWithEmissions

直飞航班（提供预估排放量）。

字段
flight	Flight 必需。匹配请求中的航班标识符。注意：所有 IATA 代码均采用大写形式。
emissions_grams_per_pax	EmissionsGramsPerPax 可选。每位乘客的排放量预估值。如果无法计算排放量，则此值将不存在。如需查看无法计算排放量的原因列表，请参阅 [ComputeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.ComputeFlightEmissions]。

ModelVersion

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

字段
major	int32 主要版本：方法的重大更改（例如，向模型中添加新的数据源会导致输出内容发生重大变化）。此类更改没有频繁发生，并会提前公布。可能涉及 API 版本更改，这些更改将遵循 https://cloud.google.com/endpoints/docs/openapi/versioning-an-api#backwards-incompatible 中的准则
minor	int32 次要版本：对模型所做的更改，虽然在架构版本之间保持一致，但会更改模型参数或实现。
patch	int32 补丁版本：旨在解决模型实现中的错误或不准确的实现变更。
dated	string 注明日期的版本：系统会使用刷新的输入数据重新创建模型数据集，但不会定期对算法进行更改。