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