本文件說明如何建立單一目的地行程,並設定正確的 欄位並指定車輛,然後指派給車輛完成本文假設您已設定機群 建立車輛,取得可正常運作的駕駛應用程式 也可以選擇購買消費者應用程式請參閱下列相關指南:
行程建立基本資訊
本節將說明建立行程時必要的要求詳細資料 機群引擎您可以使用 gRPC 和 REST 發出建立要求。
行程欄位
請使用下列欄位在 Fleet Engine 中建立行程。不同的是 ] 欄位包含一或多個目的地 往返共乘或共享泳池行程。個人中心 可以在建立行程時提供選填欄位,你也可以自行設定 稍後更新行程時即可派上用場
名稱 | 必要/自選 | 說明 |
---|---|---|
parent | 是 | 包含專案 ID 的字串。這組 ID 必須與使用的 ID 相同 以相同的服務帳戶全面整合 Fleet Engine 服務 角色。 |
trip_id | 是 | 您建立的字串,可明確識別這趟行程。如參考資料所示,行程 ID 有特定限制。 |
trip_type | 是 | 針對要建立的行程類型,將 TripType 設為下列值:
|
pickup_point | 是 | 行程的起點。 |
中級目的地 | 是 | 僅限多重目的地的行程:駕駛人在這兩個地點造訪的中繼目的地清單
上車和下車地點。和 |
vehicle_waypoints | 是 | 僅限共用集區行程:這個欄位支援交錯多個行程的路線控點。
其中包含已指派車輛的所有其他路線控點
做為這趟行程的上車和下車路線控點。您可以設定這個欄位
呼叫 |
number_of_passengers | 否 | 行程的乘客人數。 |
dropoff_point | 否 | 行程目的地。 |
vehicle_id | 否 | 指派給行程的車輛 ID。 |
範例:單程行程
以下範例說明如何建立前往大印尼的行程
東購物中心。這趟行程包含兩名乘客,專屬於乘客,並處於以下狀態
NEW
。行程的 provider_id
必須與 Google Cloud 相同
專案 ID下列範例顯示了具有專案 ID 的 Google Cloud 專案
my-rideshare-co-gcp-project
。這項專案也必須包含服務帳戶
呼叫 Fleet Engine。詳情請參閱「服務帳戶角色」。
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
// Trip initial settings.
String parent = "providers/" + PROJECT_ID;
Trip trip = Trip.newBuilder()
.setTripType(TripType.EXCLUSIVE) // Use TripType.SHARED for carpooling.
.setPickupPoint( // Grand Indonesia East Mall.
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.195139).setLongitude(106.820826)))
.setNumberOfPassengers(2)
// Provide the drop-off point if available.
.setDropoffPoint(
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.1275).setLongitude(106.6537)))
.build();
// Create trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
.setParent(parent)
.setTripId("trip-8241890") // Trip ID assigned by the provider.
.setTrip(trip) // The initial state is NEW.
.build();
// Error handling.
try {
Trip createdTrip = tripService.createTrip(createTripRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case ALREADY_EXISTS:
break;
case PERMISSION_DENIED:
break;
}
return;
}