此页面由 Cloud Translation API 翻译。

直接从 Fleet Engine 检索行程数据

本指南介绍了如何直接从 Fleet Engine 检索行程数据，以替代使用 Consumer SDK。您可以通过这种方法更好地控制最终用户体验，同时仍能利用车队管理引擎提供的准确实时车辆位置信息、预计到达时间和路线。

如需详细了解如何使用 Consumer SDK，请参阅分享按需行程的历程。

检索行程信息

如需直接从车队引擎检索行程信息，请调用 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 的重复字段。此字段包含车辆在本次行程的最终下车点之前需要按顺序经过的所有路点。指定“行程分享”视图会告知车队引擎将更新后的信息放入 remaining_waypoints[0] TripWaypoint。在其他非行程分享视图中，该航点通常不会反映分配车辆的最新位置。请参阅 RPC 或 REST 参考文档。

如需了解详情，请参阅行程简介指南中的行程状态和剩余车辆航点。

下面是行程“行程 A”的 remaining_waypoints 字段示例：

[0]	location.point = trip.pickup_point.point
	`trip_id` = "trip_A"
	`waypoint_type` = `PICKUP_WAYPOINT_TYPE`
	path_to_waypoint = LatLng[]	从剩余路线到自提点的第一个 LatLng
		距离自提点的剩余路线的第二个 LatLng
		…
		从剩余路线到取件点的最后 LatLng
		pickup_point，如果与上次不同
	traffic_data
	distance_meters = 从当前 vehicle_location 沿着 path_to_waypoint 到上车地点的距离
	eta = 更新后的预计到达时间
	时长 = 更新后的时长

[1]	location.point = trip.dropoff_point.point
	trip_id = "trip_A"
	waypoint_type = DROP_OFF_WAYPOINT_TYPE
	path_to_waypoint = LatLng[]	下车点路段的第 1 个 LatLng
		下车点路段的第二个 LatLng
		…
		下车点路段中的上一个 LatLng
		dropoff_point，如果与上次不同
	traffic_data
	distance_meters = 上车点沿着 path_to_waypoint 到下车点的距离
	eta = 更新后的预计到达时间
	时长 = 下车点路段时长

对于接连行程和拼车行程，此列表可能包含此行程之前要经过的其他行程中的航点。例如，假设行程 B 分配给了与行程 A 相同的车辆。然后，系统会按如下方式填充行程 A 的 remaining_waypoints 字段。为简洁起见，我们省略了大多数字段，但这些字段的填充方式与上例保持一致。

[0]	trip_id = "trip_A"
[0]	waypoint_type = PICKUP_WAYPOINT_TYPE
[1]	trip_id = "trip_B"
[1]	waypoint_type = PICKUP_WAYPOINT_TYPE
[2]	trip_id = "trip_B"
[2]	waypoint_type = DROP_OFF_WAYPOINT_TYPE
[3]	trip_id = "trip_A"
[3]	waypoint_type = DROP_OFF_WAYPOINT_TYPE

系统会以类似的方式填充行程 B 的 remaining_waypoint 字段，但只会显示前三个条目，因为行程 A 的下车点不属于行程 B 的路线。