此页面由 Cloud Translation API 翻译。

直接从 Fleet Engine 检索行程数据

本指南介绍了如何直接从 Fleet Engine 检索行程数据，以替代使用 Consumer SDK。您可以使用此方法更好地控制最终用户体验，同时仍然利用 Fleet Engine 的实时准确车辆位置、预计到达时间和路线。

如需详细了解如何使用消费者 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 的重复字段。此字段包含车辆在此行程的最终下车点之前将需要依序行驶的所有航点。指定“历程共享”视图会指示 Fleet Engine 将更新后的信息放入剩余的数据路点 [0] TripWaypoint 中。在其他非行程分享视图中，该航点通常不会反映分配车辆的最新位置。请参阅 RPC 或 REST 参考文档。

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

以下是行程 A 的 remaining_waypoints 字段示例：

[0]	location.point = trip.pickup_point.point
	`trip_id` = "trip_A"
	`waypoint_type` = `PICKUP_WAYPOINT_TYPE`
	路径点 = LatLng[]	从剩余路线到取件点的第一个 LatLng
		从剩余路径到上车点的第二个 LatLng
		…
		从剩余路线到取件点的最后 LatLng
		pickup_point [提货点]（如果与 last [提货点] 不同）
	traffic_data
	距离 = 从当前车辆位置沿着 path_to_waypoint 到上车点的距离
	预计到达时间 = 更新的预计到达时间
	时长 = 更新后的时长

[1]	location.point = trip.dropoff_point.point
	trip_id =“trip_A”
	Waypoint_type = DROP_OFF_WAYPOINT_TYPE
	path_to_waypoint = LatLng[]	下车点第 1 个 LatLng
		下车点路段的第 2 个 LatLng
		…
		从下车点出发的上一个 LatLng
		dropoff_point，如果与上次不同
	traffic_data
	distance_meters = 上车点沿着 path_to_waypoint 到下车点的距离
	预计到达时间 = 更新的预计到达时间
	时长 = 下车段时长

对于连续的和共享的池化行程，此列表可能包含在此行程之前要遍历的其他行程的航点。例如，假设行程 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 的路线。