本頁面由 Cloud Translation API 翻譯而成。

建立返回的行程

本文件說明如何建立「返回之旅」，並設定欄位並指定車輛，然後指派給車輛完成本文假設您已設定機群建立車輛、取得可正常運作的駕駛應用程式也可以選擇購買消費者應用程式你應該也已經熟悉以量計價行程可用的情境。請參閱下列相關指南：顯示：

設定 Fleet Engine
建立車輛
隨選行程總覽中的「行程情境」

行程建立基本資訊

本節將說明建立行程時必要的要求詳細資料機群引擎您可以使用 gRPC 和 REST 發出建立要求。

CreateTrip() 方法：gRPC 或 REST
CreateTripRequest 訊息：僅限 gRPC

，瞭解如何調查及移除這項存取權。

行程欄位

請使用下列欄位在 Fleet Engine 中建立行程。不同的是 ] 欄位包含一或多個目的地往返共乘或共享泳池行程。個人中心可以在建立行程時提供選填欄位，你也可以自行設定稍後更新行程時即可派上用場

行程欄位
名稱	必要/自選	說明
父項	是	包含專案 ID 的字串。這組 ID 必須與使用的 ID 相同以同一個服務帳戶，全面整合 Fleet Engine 服務角色。
trip_id	是	您建立的字串，可明確識別這趟行程。行程 ID 必須包含相關限制。
trip_type	是	針對您要建立的行程類型，將 TripType 設為下列值：單一目的地：設為 `SHARED` 或 `EXCLUSIVE`，多重目的地：設為 `EXCLUSIVE`。 Back-to-back (返回)：設為 `EXCLUSIVE`。共用集區：設為 `SHARED`。
pickup_point	是	行程的起點。
中級目的地	是	僅限多重目的地的行程：駕駛人在這兩個地點造訪的中繼目的地清單上車和下車地點。和 `dropoff_point` 一樣，這個欄位您之後也可以呼叫 `UpdateTrip` 來設定多目的地「行程」定義包含中繼目的地。
vehicle_waypoints	是	僅限共用集區行程：這個欄位支援交錯多個行程的路線控點。其中包含已指派車輛的所有其他路線控點做為這趟行程的上車和下車路線控點。您可以設定這個欄位呼叫 `CreateTrip` 或 `UpdateTrip`。你也可以使用 `waypoints` 欄位更新車輛路線控點呼叫 `UpdateVehicle`。服務不會在 `GetTrip` 呼叫中傳回這項資訊。
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 _放棄。