直接從 Fleet Engine 擷取行程資料

本指南說明如何直接從 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

擷取剩餘的行程路線控點

行程實體包含 TripWaypoint 類型的重複欄位。這個欄位包含車輛在抵達行程最終下車地點前，需要依序經過的所有中途點。指定「行程分享」檢視畫面，可讓 Fleet Engine 將更新資訊放入 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
從剩餘路徑到上車地點的第 2 個 LatLng
...
從剩餘路徑到取貨地點的最後一個 LatLng
取貨地點 (如與上次不同)
traffic_data
distance_meters = 從目前車輛位置沿著 path_to_waypoint 到上車地點的距離
eta = updated ETA
duration = updated duration
[1] location.point = trip.dropoff_point.point
trip_id = "trip_A"
waypoint_type = DROP_OFF_WAYPOINT_TYPE
path_to_waypoint = LatLng[] 下車路段的第一個 LatLng
下車路段的第 2 個 LatLng
...
最後一個 LatLng (來自下車路段)
dropoff_point (如與上次不同)
traffic_data
distance_meters = 從上車地點沿著 path_to_waypoint 到達下車地點的距離
eta = updated ETA
duration = drop-off leg duration

如果行程是連續或共乘，這份清單可能包含其他行程的途經點，這些途經點會在本次行程之前經過。舉例來說，假設行程 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 的路線上。