連続したルートを作成する

このドキュメントでは、連続したルートを作成し、正しいフィールドを設定して、車両に割り当てて実行する方法について説明します。このチュートリアルでは、Fleet Engine をセットアップし、車両を作成して、動作するドライバー アプリと、必要に応じてユーザー アプリを用意していることを前提としています。また、オンデマンド ルートで利用可能なさまざまなルート シナリオにも精通している必要があります。詳しくは、次の関連ガイドをご覧ください。

• Fleet Engine を設定する
• 車両を作成する
• オンデマンドの賃走の概要の移動のシナリオ

旅行の作成の基本

このセクションでは、Fleet Engine でルートを作成するために必要なリクエストの詳細について説明します。作成リクエストは、gRPC または REST を使用して発行します。

• CreateTrip() メソッド: gRPC または REST
• CreateTripRequest メッセージ: gRPC のみ

ルート フィールド

Fleet Engine でルートを作成するには、次のフィールドを使用します。1 つの目的地または複数の目的地、連続したルート、プールを共有するなど、ルートの種類に応じて異なるフィールドを使用できます。省略可能なフィールドは、ルートの作成時に指定することも、後でルートを更新するときに設定することもできます。

例: 連続したルートを作成する

以下は、連続したルートを作成して車両に割り当てる方法を示しています。このシナリオでは、ルートの作成は単一の目的地のルートの場合と同じです。後で別のルートを作成して、すでにアクティブなルートがある車両に割り当てます。

// 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 でルートの到着予定時刻を計算して追跡できるように、車両に割り当てる必要があります。この設定は、ルートの作成時または後でルートを更新するときに行えます。

ルートを車両に割り当てると、連続するルートに関連付けられたウェイポイントが車両のウェイポイント フィールドに自動的に追加されます。ルートの remainingWaypoints フィールドには、ルートが降車する前に訪れる別のルートを含む、すべての地点のリストが格納されています。

たとえば、ルート A と ルート B の 2 つの連続したルートについて考えてみましょう。車両がルート A の乗客を乗車させ、降車地に向かっている途中で、次のルート（ルート B）の別の乗客を乗車させるリクエストを運転手が受け取った。

• getVehicle() を呼び出すと、次の要素を含む remainingWaypoints が返されます。
  A _降車 → B _乗車 → B _降車。
• getTrip() または ルート A の onTripRemainingWaypointsUpdated コールバックは、次を含む remainingWaypoints を返します。
  A の_乗車地。
• getTrip() または ルート B の onTripRemainingWaypointsUpdated コールバックは、
  A _降車 → B _集荷 → B _降車を含む remainingWaypoints を返します。

次のステップ

• 共有の乗合ルートを作成する
• Driver SDK を設定する