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
(deprecated) |
string (Timestamp format)
已废弃：始终检索 Trip.remaining_waypoints。使用 remainingWaypointsRouteVersion 控制何时检索 Trip.remaining_waypoints.traffic_to_waypoint 和 Trip.remaining_waypoints.path_to_waypoint 数据。 采用 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 实例。
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-08-31。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC)：2025-08-31。"],[[["\u003cp\u003eRetrieves detailed trip information for a specified provider and trip ID.\u003c/p\u003e\n"],["\u003cp\u003eAllows customization of the data returned using query parameters such as \u003ccode\u003eview\u003c/code\u003e, \u003ccode\u003erouteFormatType\u003c/code\u003e, and various version parameters.\u003c/p\u003e\n"],["\u003cp\u003eRequires an empty request body and a valid \u003ccode\u003ename\u003c/code\u003e path parameter in the format \u003ccode\u003eproviders/{provider}/trips/{trip}\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eIf successful, the response includes a \u003ccode\u003eTrip\u003c/code\u003e object containing comprehensive trip details.\u003c/p\u003e\n"],["\u003cp\u003eOffers the flexibility to request routes in either \u003ccode\u003eLAT_LNG_LIST_TYPE\u003c/code\u003e or \u003ccode\u003eENCODED_POLYLINE_TYPE\u003c/code\u003e format.\u003c/p\u003e\n"]]],[],null,[]]
