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

このドキュメントでは、連続したトリップを作成し、正しいフィールドを設定して、車両に割り当ててトリップを完了する方法について説明します。このガイドは、Fleet Engine を設定済みで、車両を作成済みで、ドライバー アプリが動作しており、必要に応じて消費者向けアプリも動作していることを前提としています。また、オンデマンド乗車で利用できるさまざまな乗車シナリオについても理解している必要があります。関連する次のガイドをご覧ください。

旅程の作成の基本

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

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

Trip Fields（トリップ フィールド）

次のフィールドを使用して、Fleet Engine で乗車を作成します。単一または複数の目的地、連続した乗車、相乗りなど、さまざまな種類の乗車に異なるフィールドを使用できます。オプション フィールドは、トリップを新規作成するときに指定することも、トリップを更新するときに後で設定することもできます。

Trip フィールド
名前 必須かどうか 説明
親 ○ プロジェクト ID を含む文字列。この ID は、フリート エンジン統合全体で使用される ID と同じで、同じサービス アカウントのロールが必要です。
trip_id ○ この乗車を一意に識別するために作成する文字列。参照に示されているように、乗車 ID には特定の制限があります。
trip_type ○ 作成するトリップタイプに応じて、TripType を次の値に設定します。
  • 単一の宛先: SHARED または EXCLUSIVE に設定します。
  • 複数目的地: EXCLUSIVE に設定します。
  • Back-to-back: EXCLUSIVE に設定します。
  • 共有プーリング: SHARED に設定します。
pickup_point ○ 旅行の出発地。
経由地 ○

複数目的地トリップのみ: 乗車場所と降車場所の間に運転手が立ち寄る中間地点のリスト。dropoff_point と同様に、このフィールドは UpdateTrip を呼び出すことで後から設定することもできますが、複数目的地トリップには定義上、中間地点が含まれます。
vehicle_waypoints ○

相乗り専用の乗車: このフィールドは、複数の乗車の経由地をインターリーブすることをサポートします。割り当てられた車両の残りのすべてのウェイポイントと、このトリップの乗車場所と降車地点が含まれます。このフィールドは、CreateTrip または UpdateTrip を呼び出すことで設定できます。UpdateVehicle の呼び出しで waypoints フィールドを使用して、車両の経由地を更新することもできます。プライバシー上の理由から、この情報は GetTrip 呼び出しで返されません。
number_of_passengers いいえ 旅行の乗客数。
dropoff_point いいえ 旅行の目的地。
vehicle_id いいえ ルートに割り当てられている車両の ID。

例: 連続したトリップを作成する

次の例では、連続した乗車を作成して車両に割り当てる方法を示します。このシナリオでは、旅行の作成は 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 がトリップの到着予定（時刻）を計算して追跡できるように、車両に割り当てる必要があります。これは、旅行の作成中に行うことも、後で旅行を更新するときに行うこともできます。

車両にルートを割り当てると、Fleet Engine は連続するルートに関連付けられた経由地を車両の経由地フィールドに自動的に追加します。乗車ルートの remainingWaypoints フィールドには、乗車ルートの降車地点の前に立ち寄る他の乗車ルートの経由地を含む、すべての経由地のリストが含まれます。

たとえば、トリップ A とトリップ B の 2 つの連続したトリップを考えてみましょう。車両がトリップ A の乗客を乗せ、降車場所に向かっている途中で、ドライバーは次のトリップ トリップ B の乗客を乗せるリクエストを受け取ります。

  • getVehicle() を呼び出すと、次のものを含む remainingWaypoints が返されます。
    A Drop-off → B Pickup → B Drop-off。
  • getTrip() または Trip A の onTripRemainingWaypointsUpdated コールバックのいずれかが、次のものを含む remainingWaypoints を返します。
    降車。
  • getTrip() または Trip B の onTripRemainingWaypointsUpdated コールバックは、
    （A 降車 → B 乗車 → B 降車）を含む remainingWaypoints を返します。

次のステップ