本指南介绍了如何直接从 Fleet Engine 检索行程数据，作为使用 Consumer SDK 的替代方案。您可以使用此方法更好地控制最终用户体验，同时仍可利用 Fleet Engine 准确、实时的车辆位置、预计到达时间和路线。
如需详细了解如何使用 Consumer SDK，请参阅共享按需行程的行程。
检索行程信息
如需直接从 Fleet Engine 检索行程信息，请调用 GetTrip 方法，并指定 JOURNEY_SHARING_V1S 视图。请参阅 RPC 或 REST 的参考文档。
当乘客主动监控车辆进度时，您的服务器通常会轮询行程服务，以获取每个行程的状态。车辆位置信息通常每 10 秒更新一次，您的系统应以相同的频率进行轮询。您可以监控 Trip.last_location.update_time 字段，查看自上次调用 GetTrip 以来是否有任何更新。
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "trip-A";
String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_ID;
GetTripRequest getTripRequest =
GetTripRequest.newBuilder()
.setName(tripName)
.setView(JOURNEY_SHARING_V1S)
.build();
Trip trip = tripService.getTrip(getTripRequest);
生成的 Trip 对象具有以下字段，其中填充了行程的最新可用信息：
name |
trip_status |
remaining_waypoints |
vehicle_id |
trip_type |
last_location |
number_of_passengers |
pickup_point |
view (== JOURNEY_SHARING_V1S) |
actual_pickup_point |
intermediate_destinations |
intermediate_destination_index |
pickup_time |
intermediate_destinations_version |
dropoff_point |
actual_dropoff_point |
dropoff_time |
|
检索剩余行程航点
Trip 实体包含一个类型为 TripWaypoint 的重复字段。此字段包含车辆在到达此行程的最终下车点之前需要按顺序行驶的所有航点。指定行程共享视图会告知 Fleet Engine 将更新后的信息放入 remaining_waypoints[0] TripWaypoint 中。在其他非行程分享视图中，该航点通常不会反映所分配车辆的最新位置。请参阅 RPC 或 REST 的参考文档。
如需了解详情，请参阅行程简介指南中的行程状态和剩余车辆航点。
以下是行程 A 的 remaining_waypoints 字段示例：
| |||||||||||||||||||||
| |||||||||||||||||||||
对于背靠背行程和拼车行程，此列表可能包含在本次行程之前要经过的其他行程的航点。例如，假设行程 B 与行程 A 分配给同一辆车。然后，行程 A 的 remaining_waypoints 字段将填充如下。
为简洁起见，大多数字段已被省略，但它们会与前面的示例保持一致。
| [0] | trip_id = "trip_A" |
|---|---|
| waypoint_type = PICKUP_WAYPOINT_TYPE | |
| [1] | trip_id = "trip_B" |
| waypoint_type = PICKUP_WAYPOINT_TYPE | |
| [2] | trip_id = "trip_B" |
| waypoint_type = DROP_OFF_WAYPOINT_TYPE | |
| [3] | trip_id = "trip_A" |
| waypoint_type = DROP_OFF_WAYPOINT_TYPE |
行程 B 的 remaining_waypoint 字段也会以类似方式填充，但只会显示前三个条目，因为行程 A 的下车点不属于行程 B 的路线。