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 数据的最小时间戳（不包括该时间戳）。如果路线数据自此时间戳起保持不变，则响应中不会设置路线字段。如果未指定最小值，则始终检索路线数据。

使用 RFC 3339，其中生成的输出将始终采用 Z 归一化，并使用 0、3、6 或 9 个小数位。也接受除“Z”以外的偏移量。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
remainingWaypointsVersion

string (Timestamp format)

表示检索 Trip.remaining_waypoints 的最小时间戳（不包括该时间戳）。如果自此时间戳以来未发生变化，则响应中不会设置 remainingWaypoints。如果未指定此字段，则始终检索 remainingWaypoints。

使用 RFC 3339，其中生成的输出将始终采用 Z 归一化，并使用 0、3、6 或 9 个小数位。也接受除“Z”以外的偏移量。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
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 字段。如果未指定下限，系统将始终检索流量数据。请注意，此功能仅适用于按需乘车和送货解决方案客户。

使用 RFC 3339，其中生成的输出将始终采用 Z 归一化，并使用 0、3、6 或 9 个小数位。也接受除“Z”以外的偏移量。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
remainingWaypointsRouteVersion

string (Timestamp format)

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

使用 RFC 3339，其中生成的输出将始终采用 Z 归一化，并使用 0、3、6 或 9 个小数位。也接受除“Z”以外的偏移量。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

请求正文

请求正文必须为空。

响应正文

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

PolylineFormatType

多段线格式的类型。

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