本文件說明如何建立單一目的地行程、設定正確的欄位,以及將行程指派給要執行的車輛。本文假設您已經設定 Fleet Engine,也已建立一個車輛並擁有可正常運作的驅動程式應用程式,並視需要新增消費者應用程式。詳情請參閱以下相關指南:
行程建立基本資訊
本節說明在 Fleet Engine 中建立行程所需的要求詳細資料。您可以使用 gRPC 和 REST 發出建立要求。
行程欄位
請使用下列欄位在 Fleet Engine 中建立行程。您可以針對不同的行程類型使用不同的欄位:單程或多目的地、往返或共用的泳池行程。您可以在建立行程時提供選用欄位,也可以在日後更新行程時設定這些欄位。
名稱 | 必要/自選 | 說明 |
---|---|---|
父項 | 是 | 包含專案 ID 的字串。這個 ID 必須與整個 Fleet Engine 整合項目中使用的 ID 相同,並具備相同的服務帳戶角色。 |
trip_id | 是 | 您建立的用於識別此行程的專屬字串。行程 ID 具有特定限制,如參考資料所示。 |
trip_type | 是 | 針對您要建立的行程類型,將 TripType 設為下列值:
|
pickup_point | 是 | 行程的起點。 |
中級目的地 | 是 | 僅限多重目的地行程:駕駛人在上車和下車之間造訪的中繼目的地清單。如同 |
vehicle_waypoints | 是 | 僅限共用集區行程:這個欄位支援交錯多個行程的路線控點。內含指定車輛剩餘的所有路線控點,以及這趟行程的上車和下車路線控點。您可以呼叫 |
number_of_passengers | 否 | 行程的乘客人數。 |
dropoff_point | 否 | 行程目的地。 |
vehicle_id | 否 | 指派給行程的車輛 ID。 |
範例:單程行程
以下範例說明如何建立前往 Grand Indonesia East Mall 的旅程。這趟行程有兩名乘客,屬於專屬行程,狀態為 NEW
。行程的 provider_id
必須與 Google Cloud 專案 ID 相同。範例顯示了專案 ID 為 my-rideshare-co-gcp-project
的 Google Cloud 專案。這項專案也必須包含服務帳戶,才能呼叫 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;
}