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），进行此调用的服务账号所属的 Google Cloud 项目所属的项目。

查询参数

参数
header

object (RequestHeader)

标准 Fleet Engine 请求标头。
view

enum (TripView)

应返回的 Trip 字段的子集及其解释。
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 使用多段线压缩算法编码的多段线。尚不支持解码。