本文件說明如何建立「返回之旅」,並設定 欄位並指定車輛,然後指派給車輛完成本文假設您已設定機群 建立車輛、取得可正常運作的駕駛應用程式 也可以選擇購買消費者應用程式你應該也已經熟悉 以量計價行程可用的情境。請參閱下列相關指南: 顯示:
- 設定 Fleet Engine
- 建立車輛
- 隨選行程總覽中的「行程情境」
行程建立基本資訊
本節將說明建立行程時必要的要求詳細資料 機群引擎您可以使用 gRPC 和 REST 發出建立要求。
,瞭解如何調查及移除這項存取權。行程欄位
請使用下列欄位在 Fleet Engine 中建立行程。不同的是 ] 欄位包含一或多個目的地 往返共乘或共享泳池行程。個人中心 可以在建立行程時提供選填欄位,你也可以自行設定 稍後更新行程時即可派上用場
名稱 | 必要/自選 | 說明 |
---|---|---|
父項 | 是 | 包含專案 ID 的字串。這組 ID 必須與使用的 ID 相同 以相同的服務帳戶全面整合 Fleet Engine 服務 角色。 |
trip_id | 是 | 您建立的字串,可明確識別這趟行程。行程 ID 必須包含 相關限制。 |
trip_type | 是 | 針對您要建立的行程類型,將 TripType 設為下列值:
|
pickup_point | 是 | 行程的起點。 |
中級目的地 | 是 | 僅限多重目的地的行程:駕駛人在這兩個地點造訪的中繼目的地清單
上車和下車地點。和 |
vehicle_waypoints | 是 | 僅限共用集區行程:這個欄位支援交錯多個行程的路線控點。
其中包含已指派車輛的所有其他路線控點
做為這趟行程的上車和下車路線控點。您可以設定這個欄位
呼叫 |
number_of_passengers | 否 | 行程的乘客人數。 |
dropoff_point | 否 | 行程目的地。 |
vehicle_id | 否 | 指派給行程的車輛 ID。 |
範例:建立往返行程
以下示範如何建立返回行程並指派給 。在這個情境中,行程建立方式與單一目的地相同 行程。你稍後只能建立另一趟行程並指派給車輛 通知車輛仍在執行中
// A vehicle with ID 'my-vehicle' is already created and it is assigned to a trip with ID 'current-trip'.
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String VEHICLE_ID =" my-vehicle";
static final String TRIP_ID = "back-to-back-trip");
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
String parent = "providers/" + PROJECT_ID;
Trip trip = Trip.newBuilder()
.setTripType(TripType.EXCLUSIVE)
.setPickupPoint(
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.195139).setLongitude(106.820826)))
.setDropoffPoint(
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.1275).setLongitude(106.6537)))
.setVehicleId(VEHICLE_ID)
.build();
// Create trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
.setParent(parent)
.setTripId(TRIP_ID)
.setTrip(trip)
.build();
// Error handling.
try {
// Fleet Engine automatically assigns a 'waypoints' list to the trip containing
// the vehicle's current trip waypoints.
Trip createdTrip =
tripService.createTrip(createTripRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case ALREADY_EXISTS:
break;
case PERMISSION_DENIED:
break;
}
return;
}
更新往返行程
為往返行程指派車輛時, 即使已經獲派車輛也一樣
在 Fleet Engine 中建立的任何行程都必須指派給車輛,才能 幫助 Fleet Engine 計算及追蹤行程的預計到達時間。您也可以在 建立行程,或在稍後更新行程時。
將行程指派給車輛後,Fleet Engine 會自動
與往返車輛路線控點相關的路線控點
] 欄位。行程的 remainingWaypoints
欄位包含
路線控點,包括先前造訪過的其他行程
行程的下車地點。
舉例來說,假設有兩個往返行程:行程 A 和行程 B。車輛已接貨 顯示「Trip A」(行程 A),且在前往下車地點時 則司機收到領取另一個消費者的要求 下一趟行程 Trip B。
- 呼叫
getVehicle()
會傳回remainingWaypoints
包含:
放棄 → B 取貨 → B 放棄。 getTrip()
或onTripRemainingWaypointsUpdated
回呼: Trip A 會傳回remainingWaypoints
包含:
放棄。getTrip()
或onTripRemainingWaypointsUpdated
回呼: Trip B 會傳回remainingWaypoints
包含:
一位下車 → B 上車地點 → 和 B 放棄。