Package maps.fleetengine.v1

BatteryStatus

电池状态，例如是否已充满电或正在充电等。

PowerSource

电池电源的状态。

float

当前电池电量百分比 [0-100]。

SpeedReadingInterval

从上一个途经点到当前途经点的路径上的交通速度。

string

司机从上一个途经点到当前途经点所走的路线。此路径包含地标，因此客户端可以沿路径显示流量标记（请参阅 speed_reading_interval）。目前尚不支持解码。

RequestHeader

标准 Fleet Engine 请求标头。

string

必需。必须采用 providers/{provider} 格式。提供方必须是发出此调用的服务账号所属的 Google Cloud 项目的 ID（例如 sample-cloud-project）。

string

必需。唯一行程 ID。但需遵守以下限制：

• 必须是有效的 Unicode 字符串。
• 长度上限为 64 个字符。
• 根据 Unicode 标准化形式 C 进行标准化。
• 不得包含以下任何 ASCII 字符：“/”“:”“?”“,”或“#”。

Trip

必需。要创建的行程实体。

创建行程时，必须填写以下字段：

• trip_type
• pickup_point

如果您提供以下字段，系统会使用这些字段：

• number_of_passengers
• vehicle_id
• dropoff_point
• intermediate_destinations
• vehicle_waypoints

系统会忽略所有其他 Trip 字段。例如，即使您在创建请求中传入 CANCELED 的 trip_status，所有行程的初始 trip_status 仍为 NEW。

只有 EXCLUSIVE 类型的行程支持 intermediate_destinations。

为共享行程设置 vehicle_id 时，您必须提供 Trip.vehicle_waypoints 列表来指定车辆的剩余途经点的顺序，否则途经点顺序将不确定。

指定 Trip.vehicle_waypoints 时，该列表必须包含车辆行程的所有剩余途经点，不得包含额外的途经点。您必须按以下顺序排列这些途经点：对于给定的行程，上车点位于中途目的地之前，而所有中途目的地都位于下车点之前。EXCLUSIVE 行程的途经点不得与任何其他行程的途经点交错。

系统会使用 trip_id、waypoint_type 和 location 字段，并忽略 vehicle_waypoints 中的所有其他 TripWaypoint 字段。

RequestHeader

标准 Fleet Engine 请求标头。

string

必需。必须采用 providers/{provider} 格式。提供方必须是发出此调用的服务账号所属的 Google Cloud 项目的 ID（例如 sample-cloud-project）。

string

必需。唯一车辆 ID。但需遵守以下限制：

• 必须是有效的 Unicode 字符串。
• 长度上限为 64 个字符。
• 根据 Unicode 标准化形式 C 进行标准化。
• 不得包含以下任何 ASCII 字符：“/”“:”“?”“,”或“#”。

Vehicle

必需。要创建的车辆实体。创建车辆时，必须填写以下字段：

• vehicleState
• supportedTripTypes
• maximumCapacity
• vehicleType

创建车辆时，系统会忽略以下字段：

• name
• currentTrips
• availableCapacity
• current_route_segment
• current_route_segment_end_point
• current_route_segment_version
• current_route_segment_traffic
• route
• waypoints
• waypoints_version
• remaining_distance_meters
• remaining_time_seconds
• eta_to_next_waypoint
• navigation_status

所有其他字段都是可选字段，如果提供，则会使用。

RequestHeader

可选。标准 Fleet Engine 请求标头。

string

必需。必须采用 providers/{provider}/trips/{trip} 格式。提供方必须是发出此调用的服务账号所属的 Google Cloud 项目的 ID（例如 sample-cloud-project）。

RequestHeader

可选。标准 Fleet Engine 请求标头。

string

必需。必须采用 providers/{provider}/vehicles/{vehicle} 格式。{provider} 必须是发出此调用的服务账号所属的 Google Cloud 项目的项目 ID（例如 sample-cloud-project）。

LocationPowerSaveMode

省电模式开启时，位置信息功能在设备上的运行方式。

bool

设备目前是否处于节能模式。

bool

设备是否处于互动状态。

BatteryInfo

有关电池状态的信息。

RequestHeader

标准 Fleet Engine 请求标头。

string

必需。必须采用 providers/{provider}/trips/{trip} 格式。提供方必须是发出此调用的服务账号所属的 Google Cloud 项目的 ID（例如 sample-cloud-project）。

TripView

应返回的 Trip 字段子集及其解释。

Timestamp

表示检索 Trip.route 或 Trip.current_route_segment 数据的最小时间戳（不含）。如果自相应时间戳以来路线数据未发生变化，则响应中不会设置路线字段。如果未指定最小值，则始终会检索路线数据。

Timestamp

已废弃：始终检索 Trip.remaining_waypoints。使用 remaining_waypoints_route_version 控制何时检索 Trip.remaining_waypoints.traffic_to_waypoint 和 Trip.remaining_waypoints.path_to_waypoint 数据。

PolylineFormatType

返回的当前路线格式，LAT_LNG_LIST_TYPE（在 Trip.route 中）或 ENCODED_POLYLINE_TYPE（在 Trip.current_route_segment 中）。默认值为 LAT_LNG_LIST_TYPE。

Timestamp

表示检索 Trip.current_route_segment_traffic 的最小时间戳（不含）。如果自相应时间戳以来流量数据未发生变化，则响应中不会设置 current_route_segment_traffic 字段。如果未指定最小值，则始终会检索流量数据。请注意，流量数据仅适用于按需乘车和送货解决方案客户。

Timestamp

表示检索 Trip.remaining_waypoints.traffic_to_waypoint 和 Trip.remaining_waypoints.path_to_waypoint 数据的最小时间戳（不含）。如果自相应时间戳以来数据未发生变化，则响应中不会设置上述字段。如果未指定 remaining_waypoints_route_version，则始终检索流量和路径。

RequestHeader

标准 Fleet Engine 请求标头。

string

必需。必须采用 providers/{provider}/vehicles/{vehicle} 格式。提供方必须是发出此调用的服务账号所属的 Google Cloud 项目的 ID（例如 sample-cloud-project）。

Timestamp

表示检索 Vehicle.current_route_segment 的最小时间戳（不含）。如果自相应时间戳以来路线未发生变化，则响应中不会设置 current_route_segment 字段。如果未指定最小值，则始终检索 current_route_segment。

Timestamp

表示检索 Vehicle.waypoints 数据的最小时间戳（不含）。如果自相应时间戳以来，途经点未发生变化，则响应中不会设置 vehicle.waypoints 数据。如果未指定此字段，则始终检索 vehicle.waypoints。

string

必需。CLDR 国家/地区代码。例如，US 表示美国，IN 表示印度。

string

车牌号的最后一位数字，如果车牌号中没有数字值，则为“-1”。

• “ABC 1234” ->“4”
• “AB 123 CD” ->“3”
• “ABCDEF” -> “-1”

RequestHeader

标准 Fleet Engine 请求标头。

string

必需。必须采用 providers/{provider} 格式。提供方必须是发出此调用的服务账号所属的 Google Cloud 项目的 ID（例如 sample-cloud-project）。

int32

要返回的车辆数量上限。默认值：100。

string

之前对 ListVehicles 的调用提供的 next_page_token 的值，以便您可以对车辆组进行分页。如果请求的过滤条件与之前对 ListVehicles 的调用的过滤条件不相同，则该值未定义。

Int32Value

指定车辆所需的最小容量。返回的所有车辆的 maximum_capacity 都将大于或等于此值。如果设置，则必须大于或等于 0。

TripType

将响应限制为支持至少一种指定行程类型的车辆。

Duration

将响应限制为在指定时长内向 Fleet Engine 发送过位置更新的车辆。仍会传输位置信息的静止车辆不会被视为过时。如果存在，则必须是有效的正时长。

Category

必需。将响应限制为具有指定类型类别的车辆。不允许UNKNOWN。

string

调用者可以使用 required_attributes、required_one_of_attributes 和 required_one_of_attribute_sets 字段的任意组合来形成复杂的逻辑运算。

required_attributes 是一个列表；required_one_of_attributes 使用的消息允许列表的列表。这两个字段结合使用，可构成以下表达式：

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

将响应限制为具有指定属性的车辆。此字段表示一种合取/AND 操作。最多允许添加 50 个 required_attributes。这与车辆上允许的最大属性数量相符。每个重复的字符串都应采用“键:值”格式。

string

将响应限制为在每个 VehicleAttributeList 中至少具有一个指定属性的车辆。在每个列表中，车辆必须至少匹配一个属性。此字段在每个 VehicleAttributeList 中表示包含性析取/OR 操作，在 VehicleAttributeList 的集合中表示合取/AND 操作。每个重复字符串都应采用“key1:value1|key2:value2|key3:value3”格式。

string

required_one_of_attribute_sets 提供额外的功能。

与 required_one_of_attributes 类似，required_one_of_attribute_sets 使用的消息允许包含列表的列表，从而支持如下表达式：

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

将响应限制为与 VehicleAttributeList 中的所有属性匹配的车辆。在每个列表中，车辆必须与所有属性匹配。此字段在每个 VehicleAttributeList 中都是一种合取/AND 操作，在 VehicleAttributeList 的集合中是一种包含性析取/OR 操作。每个重复字符串都应采用“key1:value1|key2:value2|key3:value3”格式。

VehicleState

将响应限制为具有相应车辆状态的车辆。

bool

仅返回有当前行程的车辆。

string

可选。列出车辆时要应用的过滤查询。如需查看过滤条件语法示例，请参阅 http://aip.dev/160。

此字段旨在取代 required_attributes、required_one_of_attributes 和 required_one_of_attributes_sets 字段。如果此处指定了非空值，则以下字段必须为空：required_attributes、required_one_of_attributes 和 required_one_of_attributes_sets。

此过滤器的作用类似于包含其他限制条件（例如 vehicle_state 或 on_trip_only）的 AND 子句。

请注意，系统仅支持针对车辆属性（例如 attributes.<key> = <value> 或 attributes.<key1> = <value1> AND attributes.<key2> = <value2>）的查询。过滤查询中允许的限制数量上限为 50。

此外，所有属性都存储为字符串，因此唯一支持的属性比较是字符串比较。为了与数字或布尔值进行比较，必须明确引用这些值，以便将其视为字符串（例如 attributes.<key> = "10" 或 attributes.<key> = "true"）。

Viewport

可选。一种过滤器，用于将返回的车辆限制为最后一次已知位置位于视口定义的矩形区域内的车辆。

Vehicle

符合请求中条件的车辆。返回的车辆数量上限由请求中的 page_size 字段决定。

string

用于检索下一页车辆的令牌。如果没有更多符合请求条件的车辆，则为空。

int64

必需。所有页面中符合请求条件的车辆总数。

string

必需。必须采用 providers/{provider}/billableTrips/{billable_trip} 格式。提供方必须是发出此调用的服务账号所属的 Google Cloud 项目的 ID（例如 sample-cloud-project）。

string

必需。行程所在国家/地区的双字母国家/地区代码。价格是根据国家/地区代码定义的。

BillingPlatformIdentifier

发出请求的平台。

string

与所报告的行程直接相关的标识符。这些通常是在行程 ID 可用之前完成的预订前操作的 ID（例如会话 ID）。related_ids 的数量上限为 50。

SolutionType

报告的行程所使用的 GMP 产品解决方案类型（例如 ON_DEMAND_RIDESHARING_AND_DELIVERIES）。

string

BCP-47 语言代码，例如 en-US 或 sr-Latn。如需了解详情，请参阅 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。如果未指定，则响应可能采用任何语言，但如果存在英文名称，则优先采用英文。字段值示例：en-US。

string

必需。发起请求的地区的 CLDR 地区代码。字段值示例：US。

string

调用 SDK 的版本（如适用）。版本格式为“major.minor.patch”，例如：1.1.2。

string

运行调用 SDK 的操作系统的版本。字段值示例：4.4.1、12.1。

string

运行调用 SDK 的设备的型号。字段值示例：iPhone12,1、SM-G920F。

SdkType

发送请求的 SDK 的类型。

string

调用 SDK 所依赖的 MapSDK 版本（如果适用）。版本格式为“major.minor.patch”，例如：5.2.1。

string

调用 SDK 所依赖的 NavSDK 版本（如果适用）。版本格式为“major.minor.patch”，例如：2.1.0。

Platform

调用 SDK 的平台。

string

调用 SDK 的 Android 设备的制造商，仅适用于 Android SDK。字段值示例：Samsung。

int32

调用 SDK 的 Android API 级别，仅适用于 Android SDK。字段值示例：23。

string

可选 ID，可提供此 ID 以便出于日志记录目的来标识请求。

RequestHeader

标准 Fleet Engine 请求标头。

string

必需。必须采用 providers/{provider} 格式。提供方必须是发出此调用的服务账号所属的 Google Cloud 项目的 ID（例如 sample-cloud-project）。

string

与请求中的行程关联的车辆。如果未指定，则返回的行程不包含：

• current_route_segment
• remaining_waypoints
• remaining_distance_meters
• eta_to_first_waypoint

bool

如果设置为 true，则响应会包含影响司机路线的行程。

int32

如果未设置，则服务器将决定要返回的结果数。

string

将此参数设置为之前在 SearchTripsResponse 中返回的值，以便从之前的搜索结果继续。

Duration

如果指定，则返回在时间 (current - minimum_staleness) 之后未更新的行程。

Trip

所请求车辆的行程列表。

string

在 SearchTripsRequest 中传递此令牌，以翻阅列表结果。API 每次调用都会返回一个行程列表，当没有更多结果时，行程列表为空。

RequestHeader

标准 Fleet Engine 请求标头。

string

必需。必须采用 providers/{provider} 格式。提供方必须是发出此调用的服务账号所属的 Google Cloud 项目的 ID（例如 sample-cloud-project）。

TerminalLocation

必需。要搜索的附近自提点。

TerminalLocation

客户的预期下车地点。如果 trip_types 包含 TripType.SHARED，则此字段为必填字段。

int32

必需。定义接客点周围的车辆搜索半径。系统只会返回搜索半径范围内的车辆。值必须介于 400 米到 10,000 米之间（含 400 米和 10,000 米）。

int32

必需。指定要返回的车辆数量上限。该值必须介于 1 到 50 之间（含 1 和 50）。

int32

必需。指定行程中考虑的乘客人数。该值必须大于或等于 1。容量值中不包含司机。

TripType

必需。表示建议的行程类型。必须只包含一种类型。不允许使用 UNKNOWN_TRIP_TYPE。将搜索范围限制为仅包含支持相应行程类型的车辆。

Duration

将搜索范围限制为在指定时长内向 Fleet Engine 发送过位置信息更新的车辆。仍会传输位置信息的静止车辆不会被视为过时。如果未设置此字段，服务器会使用 5 分钟作为默认值。

VehicleType

必需。将搜索范围限定为具有指定类型之一的车辆。必须至少指定一种车辆类型。不允许使用类别为 UNKNOWN 的 VehicleTypes。

VehicleAttribute

调用者可以使用 required_attributes、required_one_of_attributes 和 required_one_of_attribute_sets 字段的任意组合来形成复杂的逻辑运算。

required_attributes 是一个列表；required_one_of_attributes 使用的消息允许列表的列表。这两个字段结合使用，可构成以下表达式：

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

将搜索范围限制为仅包含指定属性的车辆。此字段表示一种合取/AND 操作。最多允许添加 50 个 required_attributes。这与车辆允许的最大属性数量相符。

VehicleAttributeList

将搜索范围限制为仅包含每个 VehicleAttributeList 中至少一个指定属性的车辆。在每个列表中，车辆必须至少匹配一个属性。此字段在每个 VehicleAttributeList 中是包含性析取/OR 操作，在 VehicleAttributeList 的集合中是合取/AND 操作。

VehicleAttributeList

required_one_of_attribute_sets 提供额外的功能。

与 required_one_of_attributes 类似，required_one_of_attribute_sets 使用的消息允许包含列表的列表，从而支持如下表达式：

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

将搜索范围限制为仅包含 VehicleAttributeList 中所有属性的车辆。在每个列表中，车辆必须与所有属性匹配。此字段在每个 VehicleAttributeList 中都是一种合取/AND 操作，在 VehicleAttributeList 的集合中是一种包含性析取/OR 操作。

VehicleMatchOrder

必需。指定所需的结果排序标准。

bool

这表示具有单次有效行程的车辆是否符合此搜索条件。此字段仅在未指定 current_trips_present 时使用。如果未指定 current_trips_present 且此字段为 false，则搜索结果中会排除已分配行程的车辆。如果未指定 current_trips_present 且此字段为 true，则搜索结果可以包含具有一次状态为 ENROUTE_TO_DROPOFF 的有效行程的车辆。指定 current_trips_present 时，此字段不能设置为 true。

默认值为 false。

string

表示与此 SearchVehicleRequest 关联的行程。

CurrentTripsPresent

这表示正在进行行程的车辆是否符合此搜索条件。如果 trip_type 包含 SHARED，则必须将此标记设置为 CURRENT_TRIPS_PRESENT_UNSPECIFIED 以外的值。

string

可选。搜索车辆时要应用的过滤查询。如需查看过滤条件语法示例，请参阅 http://aip.dev/160。

此字段旨在取代 required_attributes、required_one_of_attributes 和 required_one_of_attributes_sets 字段。如果此处指定了非空值，则以下字段必须为空：required_attributes、required_one_of_attributes 和 required_one_of_attributes_sets。

此过滤器的作用类似于包含其他限制条件（例如 minimum_capacity 或 vehicle_types）的 AND 子句。

请注意，系统仅支持针对车辆属性（例如 attributes.<key> = <value> 或 attributes.<key1> = <value1> AND attributes.<key2> = <value2>）的查询。过滤查询中允许的限制数量上限为 50。

此外，所有属性都存储为字符串，因此唯一支持的属性比较是字符串比较。为了与数字或布尔值进行比较，必须明确引用这些值，以便将其视为字符串（例如 attributes.<key> = "10" 或 attributes.<key> = "true"）。

VehicleMatch

符合 SearchVehiclesRequest 条件的车辆列表，按 SearchVehiclesRequest.order_by 字段排序。

int32

相应时间段在路径中的起始索引。在 JSON 中，当索引为 0 时，相应字段将显示为未填充。

int32

相应区间在路径中的结束索引。在 JSON 中，当索引为 0 时，相应字段将显示为未填充。

Speed

相应时间间隔内的流量速度。

LatLng

必需。表示实际位置。

Timestamp

指明了停车时间。

Timestamp

仅限输入。已弃用。使用时间戳字段。

LatLng

表示航点的确切 LatLng。必须将 point 或 place 指定为输入。如果同时指定了这两个参数，则 point 将用于路由，而 place 将用于元数据。如果仅指定 place 作为输入，系统将根据 place 计算 point 并将其包含在输出中。

string

表示相应位置的地点资源名称。格式为 places/{place_id}。必须将 point 或 place 指定为输入。如果同时指定了这两个参数，则 point 将用于路由，而 place 将用于元数据。只有当输入中包含 place 时，输出中才会包含 place，这意味着不会执行从 LatLng 到 place 的查找。

这是一项实验性功能。

PointSource

仅限输出。point 字段的来源。

TerminalPointId

已弃用：请改用 place 字段。

string

已弃用：请改用 place 字段。

string

已弃用。

WaypointType

已弃用：Vehicle.waypoint 将包含此数据。

string

已弃用。

string

已弃用。

string

已弃用。

VisualTrafficReportPolylineRendering

折线图，显示客户行程中一段路线上所有区域的交通速度。

string

仅限输出。格式为“providers/{provider}/trips/{trip}”

string

进行此行程的车辆的 ID。

TripStatus

行程的当前状态。

TripType

行程的类型。

TerminalLocation

客户指定的上车地点。

StopLocation

仅限输入。接载客户时的实际位置。此字段供提供商提供有关实际取货信息的反馈。

StopLocation

仅限输入。司机到达上车点的实际时间和位置。此字段供提供商提供有关上车点实际到达信息的反馈。

Timestamp

仅限输出。乘客的预计未来上车时间或实际的上车时间。

TerminalLocation

行程请求中的中途经停点（除了上车点和下车点）。最初，此功能将不支持合乘行程。

Timestamp

表示上次修改 intermediate_destinations 的时间。您的服务器应缓存此值，并在更新 intermediate_destination_index 时将其传递到 UpdateTripRequest 中，以确保 intermediate_destinations 不会发生变化。

int32

当 TripStatus 为 ENROUTE_TO_INTERMEDIATE_DESTINATION 时，一个介于 [0..N-1] 之间的数字，表示车辆接下来将经过哪个中间目的地。当 TripStatus 为 ARRIVED_AT_INTERMEDIATE_DESTINATION 时，表示车辆所处的中间目的地，取值范围为 [0..N-1]。此值由提供方设置。如果没有 intermediate_destinations，则忽略此字段。

StopLocation

仅限输入。司机到达中途目的地的实际时间和位置。此字段供提供商提供有关中途目的地实际到达信息的反馈。

StopLocation

仅限输入。客户从中途目的地出发的实际时间和地点。此字段供提供商提供有关中途目的地实际取货信息的反馈。

TerminalLocation

客户指定的下车地点。

StopLocation

仅限输入。客户实际下车的时间和地点。此字段供提供商提供有关实际下车信息的反馈。

Timestamp

仅限输出。乘客到达最终目的地的预计未来时间，或乘客到达最终目的地的实际时间。

TripWaypoint

仅限输出。从当前位置到下车点的完整路径（含）。此路径可能包含其他行程中的途经点。

TripWaypoint

此字段支持手动对行程的途经点进行排序。它包含分配车辆的所有剩余途经点，以及本次行程的上车和下车途经点。如果行程尚未分配给车辆，Fleet Engine 会忽略此字段。出于隐私考虑，此字段仅由服务器在 UpdateTrip 和 CreateTrip 调用中填充，而不会在 GetTrip 调用中填充。

LatLng

仅限输出。此行程中从当前位置到 remaining_waypoints 中的第一个条目的预期路线。请注意，第一个途经点可能属于其他行程。

string

仅限输出。下一个途经点的编码路径。

注意：此字段仅供 Driver SDK 和 Consumer SDK 使用。尚不支持解码。

Timestamp

仅限输出。表示路线的上次修改时间。

注意：此字段仅供 Driver SDK 和 Consumer SDK 使用。

ConsumableTrafficPolyline

仅限输出。指明 current_route_segment 沿途的路况（如有）。

注意：此字段仅供 Driver SDK 和 Consumer SDK 使用。

Timestamp

仅限输出。表示上次修改 current_route_segment_traffic 的时间。

注意：此字段仅供 Driver SDK 和 Consumer SDK 使用。

TripWaypoint

仅限输出。current_route_segment 结束时的途经点。

Int32Value

仅限输出。current_route_segment 字段中的剩余行驶距离。如果行程未分配给车辆，或者行程已完成或已取消，则该值未指定。

Timestamp

仅限输出。到达下一个途经点的预计时间（remaining_waypoints 字段中的第一个条目）。如果行程未分配给车辆，或者行程处于非活动状态（已完成或已取消），则该值为未指定。

Duration

仅限输出。从返回 Trip 数据到 Trip.eta_to_first_waypoint 中的时间之间的时长。如果行程未分配给车辆，或者行程处于非活动状态（已完成或已取消），则该值为未指定。

Timestamp

仅限输出。表示 remaining_waypoints 的上次更改时间（添加、移除或更改了途经点）。

Timestamp

仅限输出。表示 remaining_waypoints.path_to_waypoint 和 remaining_waypoints.traffic_to_waypoint 的上次修改时间。您的客户端应用应缓存此值，并在 GetTripRequest 中传递该值，以确保仅在 remaining_waypoints 的路径和流量更新时才返回这些路径和流量。

int32

不可变。表示本次行程的乘客人数，不包括司机。车辆必须有可用容量才能在 SearchVehicles 响应中返回。

VehicleLocation

仅限输出。表示车辆在路线上的最后报告位置。

bool

仅限输出。指示车辆的 last_location 是否可以贴靠到 current_route_segment。如果 last_location 或 current_route_segment 不存在，则为 False。由 Fleet Engine 计算。系统会忽略来自客户端的任何更新。

TripView

已填充的 Trip 字段子集以及应如何解读这些字段。

TripAttribute

自定义行程属性的列表。每个属性都必须具有唯一的键。

string

属性的键。键不得包含英文冒号字符 (:)。

string

字符串类型的属性值。

bool

布尔值类型的属性值。

double

双精度类型的属性值。

TerminalLocation

相应途经点的位置。

string

与此途经点关联的行程。

WaypointType

此途经点在此行程中扮演的角色，例如上车点或下车点。

LatLng

从上一个途经点到当前途经点的路径。如果这是第一个途经点，则路径是从车辆的当前位置到该途经点。仅在请求时填充此字段。

string

从上一个途经点到当前途经点的编码路径。

注意：此字段仅供 Driver SDK 和 Consumer SDK 使用。尚不支持解码。

ConsumableTrafficPolyline

前往此途经点的路径上的路况。请注意，流量信息仅适用于 Google 地图平台出行和配送解决方案客户。

Int32Value

从上一个途径点到当前途径点的路径距离。如果这是第一个途经点，则路径距离是指从车辆当前位置到途经点的距离。

Timestamp

到达此途经点的预计时间。

Duration

从上一个途经点到此途经点的旅行时间。如果这是第一个途经点，则行驶时间是从车辆当前位置到该途经点的时间。

RequestHeader

标准 Fleet Engine 请求标头。

string

必需。必须采用 providers/{provider}/trips/{trip} 格式。提供方必须是发出此调用的服务账号所属的 Google Cloud 项目的 ID（例如 sample-consumer-project）。

Trip

必需。与更新关联的行程。

以下字段由 Fleet Engine 维护。请勿使用 Trip.update 更新这些内容。

• current_route_segment
• current_route_segment_end_point
• current_route_segment_traffic
• current_route_segment_traffic_version
• current_route_segment_version
• dropoff_time
• eta_to_next_waypoint
• intermediate_destinations_version
• last_location
• name
• number_of_passengers
• pickup_time
• remaining_distance_meters
• remaining_time_to_first_waypoint
• remaining_waypoints
• remaining_waypoints_version
• route

更新共享行程的 Trip.vehicle_id 时，您必须提供 Trip.vehicle_waypoints 列表来指定剩余途经点的顺序，否则顺序将不确定。

指定 Trip.vehicle_waypoints 时，该列表必须包含车辆行程的所有剩余途经点，不得包含额外的途经点。您必须按以下顺序排列这些途经点：对于给定的行程，上车点位于中途目的地之前，而所有中途目的地都位于下车点之前。EXCLUSIVE 行程的途经点不得与任何其他行程的途经点交错。系统会使用 trip_id、waypoint_type 和 location 字段，并忽略 vehicle_waypoints 中的所有其他 TripWaypoint 字段。

为避免出现包含多个目的地的行程的竞态条件，您应在将行程状态更新为 ENROUTE_TO_INTERMEDIATE_DESTINATION 时提供 Trip.intermediate_destinations_version。传递的 Trip.intermediate_destinations_version 必须与 Fleet Engine 的版本一致。如果不满足此条件，请求将失败。

FieldMask

必需。用于指示要更新的 Trip 中的字段的字段掩码。update_mask 必须包含至少一个字段。

RequestHeader

标准 Fleet Engine 请求标头。

string

必需。必须采用 providers/{provider}/vehicles/{vehicle} 格式。提供方必须是发出此调用的服务账号所属的 Google Cloud 项目的 ID（例如 sample-cloud-project）。

VehicleAttribute

必需。要更新的车辆属性。未提及的属性不会被更改或移除。

VehicleAttribute

必需。更新后的完整车辆属性列表，包括新增、更改和未更改的属性。

RequestHeader

标准 Fleet Engine 请求标头。

string

必需。必须采用 providers/{provider}/vehicles/{vehicle} 格式。{provider} 必须是发出此调用的服务账号所属的 Google Cloud 项目的项目 ID（例如 sample-cloud-project）。

Vehicle

必需。要应用的 Vehicle 实体值。更新 Vehicle 时，以下字段可能无法更新，因为它们由服务器管理。

• available_capacity
• current_route_segment_version
• current_trips
• name
• waypoints_version

如果更新 attributes 字段，则车辆的所有属性都会替换为请求中提供的属性。如果您只想更新部分属性，请参阅 UpdateVehicleAttributes 方法。

同样，waypoints 字段可以更新，但必须包含车辆当前的所有途经点，而不能包含其他途经点。

FieldMask

必需。一个字段掩码，用于指明要更新 Vehicle 的哪些字段。必须提供至少一个字段名称。

string

仅限输出。相应车辆的唯一名称。格式为 providers/{provider}/vehicles/{vehicle}。

VehicleState

车辆状态。

TripType

相应车辆支持的行程类型。

string

仅限输出。当前分配给相应车辆的行程的 trip_id 列表。

VehicleLocation

车辆上次报告的位置。

VehicleLocation

仅限输入。相应车辆过去曾到过但尚未向 Fleet Engine 报告的位置。此功能用于在 UpdateVehicleRequest 中记录之前无法发送到服务器的位置。这种情况通常发生在车辆未连接到互联网时。

int32

相应车辆可搭载的骑手总数。此值不考虑司机。此值必须大于或等于 1。

VehicleAttribute

车辆属性列表。一辆车最多可以有 100 个属性，并且每个属性都必须有一个唯一的键。

VehicleType

必需。相应车辆的类型。可用于过滤 SearchVehicles 结果中的车辆。还会影响预计到达时间和路线计算。

LicensePlate

车辆的车牌信息。

TerminalLocation

已弃用：请改用 Vehicle.waypoints。

string

指定驾驶员应用打算前往下一个途经点的路线的多段线。此列表也会在 Trip.current_route_segment 中针对分配给车辆的所有有效行程返回。

注意：此字段仅供 Driver SDK 使用。尚不支持解码。

TrafficPolylineData

仅限输入。Fleet Engine 会使用这些信息来改进行程分享功能。注意：此字段仅供 Driver SDK 使用。

Timestamp

仅限输出。设置 current_route_segment 的时间。它可以由客户端存储，并在未来的 GetVehicle 请求中传递，以防止返回未更改的路线。

TripWaypoint

current_route_segment 结束时的途经点。驱动程序可以在 UpdateVehicle 调用中提供此信息，可以是完整的行程航点、航点 LatLng，也可以是 current_route_segment 的最后一个 LatLng。然后，如果航点未完全指定，Fleet Engine 会尽力插值到实际航点。在 UpdateVehicle 调用中，除非还指定了 current_route_segment，否则系统会忽略此字段。

Int32Value

current_route_segment 的剩余行驶距离。此值也会在 Trip.remaining_distance_meters 中针对分配给车辆的所有有效行程返回。如果 current_route_segment 字段为空，则该值未指定。

Timestamp

waypoints 字段中第一个条目的预计到达时间。如果 waypoints 字段为空或 Vehicle.current_route_segment 字段为空，则该值未指定。

更新车辆时，同一请求中的 remaining_time_seconds 优先于 eta_to_first_waypoint。

Int32Value

仅限输入。current_route_segment 的剩余驾驶时间。如果 waypoints 字段为空或 Vehicle.current_route_segment 字段为空，则该值未指定。如果所有当事方都使用同一时钟，则此值应与 eta_to_first_waypoint - current_time 一致。

更新车辆时，同一请求中的 remaining_time_seconds 优先于 eta_to_first_waypoint。

TripWaypoint

分配给相应车辆的剩余途经点。

Timestamp

仅限输出。waypoints 字段的上次更新时间。客户端应缓存此值并在 GetVehicleRequest 中传递该值，以确保仅在 waypoints 字段更新时才返回该字段。

bool

指示司机是否接受连续行程。如果为 true，即使车辆当前已分配给某次行程，SearchVehicles 也可能包含该车辆。默认值为 false。

NavigationStatus

车辆的导航状态。

DeviceSettings

仅限输入。与驾驶员使用的移动设备中的设置相关的信息。

Category

车辆类型类别

string

属性的键。键不得包含英文冒号字符 (:)。

string

属性的值。

string

字符串类型的属性值。

注意：此字段与 value 字段完全相同，但后者最终将被弃用。对于创建或更新方法，可以使用任一字段，但强烈建议使用 string_value。如果同时设置了 string_value 和 value，它们必须完全相同，否则系统会抛出错误。这两个字段都会填充在响应中。

bool

布尔值类型的属性值。

double

双精度类型的属性值。

VehicleAttribute

相应集合中的属性列表。

LatLng

车辆的位置。当位置信息发送到 Fleet Engine 时，车辆的位置是 GPS 位置。当您在响应中收到此值时，车辆的位置信息可以是 GPS 位置信息、补充位置信息或其他一些估计的位置信息。来源在 location_sensor 中指定。

DoubleValue

已弃用：请改用 latlng_accuracy。

DoubleValue

以半径表示的精确度为 location 米。

Int32Value

车辆行驶方向（以度为单位）。0 表示北。有效范围为 [0,360)。

DoubleValue

已弃用：请改用 heading_accuracy。

DoubleValue

精确度为 heading 度。

DoubleValue

海拔高度（以米为单位，高于 WGS84）。

DoubleValue

已弃用：请改用 altitude_accuracy。

DoubleValue

altitude 的精度，以米为单位。

Int32Value

车辆速度，单位为千米/小时。已弃用：请改用 speed。

DoubleValue

车辆速度（以米/秒为单位）

DoubleValue

speed 的精确度，以米/秒为单位。

Timestamp

传感器根据其时钟报告 location 的时间。

Timestamp

仅限输出。服务器接收到位置信息的时间。

LocationSensor

位置数据提供方（例如 GPS）。

BoolValue

location 是否贴合道路。

BoolValue

仅限输入。指示移动设备上是否已启用 GPS 传感器。

Int32Value

仅限输入。自首次将相应位置信息发送到服务器以来经过的时间（以秒为单位）。对于首次更新，此值为零。如果时间未知（例如，当应用重启时），此值会重置为零。

Int32Value

仅限输入。已弃用：现在使用其他信号来确定位置是否过时。

LatLng

原始车辆位置（未经道路贴合器处理）。

Timestamp

与原始位置信息相关联的时间戳。

LocationSensor

原始位置信息的来源。默认为 GPS。

DoubleValue

以米为单位的半径，精确度为 raw_location。

LatLng

来自 Android 的一体化位置信息提供程序的位置信息。

Timestamp

更新 flp_location 的时间戳

DoubleValue

以半径表示的精确度为 flp_location 米。

Int32Value

车辆行驶方向（以度为单位），由融合位置信息提供程序确定。0 表示北。有效范围为 [0,360)。

LatLng

集成应用提供的补充位置信息。

Timestamp

与补充位置信息相关联的时间戳。

LocationSensor

补充位置信息的来源。默认为 CUSTOMER_SUPPLIED_LOCATION。

DoubleValue

以米为单位的半径，精确度为 supplemental_location。

bool

已弃用：请改用 is_road_snapped。

Vehicle

必需。与请求匹配的车辆。

Timestamp

车辆从当前位置到达请求中指定的上车点的预计行驶时间。空值表示车辆的预计到达时间计算失败。如果 SearchVehiclesRequest.include_back_to_back 为 true 且相应车辆有正在进行的行程，则 vehicle_pickup_eta 会包含完成当前正在进行的行程所需的时间。

Int32Value

从车辆当前位置到请求中指定的上车点的距离，包括现有行程的任何中间上车点或下车点。此距离包括计算出的驾车（路线）距离，以及导航终点与请求的上车点之间的直线距离。（导航终点与请求的上车点之间的距离通常很小。）空值表示距离计算有误。

Int32Value

必需。车辆与请求中指定的上车点之间的直线距离。

Timestamp

车辆从当前位置到请求中指定的下车点的完整行驶预计到达时间。预计到达时间包括在请求中指定的 dropoff_point 之前停靠任何航点的时间。只有在请求中指定了下车点时，系统才会填充此值。空值表示在计算预计到达时间时出错。

Int32Value

车辆从上车点到请求中指定的下车点的行驶距离（以米为单位）。此距离仅指两点之间的距离，不包括车辆位置或在车辆到达上车点或下车点之前必须经过的任何其他点。仅当请求中指定了 dropoff_point 时，系统才会填充此值。空值表示无法计算从上车点到请求中指定的下车点的距离。

TripType

必需。用于计算前往上车点的预计到达时间的请求的行程类型。

Waypoint

用于计算预计到达时间的有序途经点列表。该列表包含车辆位置、车辆有效行程的接客点以及请求中提供的接客点。空列表表示车辆的预计到达时间计算失败。

VehicleMatchType

车辆匹配的类型。

VehicleMatchOrder

请求的车辆匹配排序顺序。等同于 ordered_by。

VehicleMatchOrder

请求的车辆匹配排序顺序。等同于 requested_ordered_by。

RoadStretch

可选。应沿多段线渲染的道路段。路段保证不会重叠，但不一定覆盖整个路线。

如果没有要设置样式的路段，客户端应应用路线的默认样式。

Style

必需。要应用的样式。

int32

必需。样式应应用于 [offset_meters, offset_meters + length_meters) 之间。

int32

必需。应用样式的路径的长度。

LatLng

相应途经点的位置。

Timestamp

车辆预计到达此途经点的时间。