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 使用多段线压缩算法编码的多段线。尚不支持解码。