Method: providers.trips.get

获取单个行程的相关信息。

HTTP 请求

GET https://fleetengine.googleapis.com/v1/{name=providers/*/trips/*}

网址采用 gRPC 转码语法。

路径参数

参数
name

string

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

查询参数

参数
header

object (RequestHeader)

标准 Fleet Engine 请求标头。
view

enum (TripView)

应返回的行程字段的子集及其说明。
currentRouteSegmentVersion

string (Timestamp format)

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

时间戳，采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，具有纳秒级分辨率，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
remainingWaypointsVersion

string (Timestamp format)

表示检索 Trip.remaining_waypoints 的最小时间戳（不含该时间戳）。如果它们自该时间戳以来保持不变，则不会在响应中设置 remainingWaypoints。如果未指定此字段，则始终检索 remainingWaypoints。

时间戳，采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，具有纳秒级分辨率，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
routeFormatType

enum (PolylineFormatType)

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

string (Timestamp format)

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

时间戳，采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，具有纳秒级分辨率，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
remainingWaypointsRouteVersion

string (Timestamp format)

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

时间戳，采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，具有纳秒级分辨率，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

请求正文

请求正文必须为空。

响应正文

如果成功，则响应正文包含一个 Trip 实例。

PolylineFormatType

多段线的格式类型。

枚举
UNKNOWN_FORMAT_TYPE 格式未指定或未知。
LAT_LNG_LIST_TYPE google.type.LatLng 的列表。
ENCODED_POLYLINE_TYPE 使用多段线压缩算法编码的多段线。尚不支持解码。