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

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

旅程の作成の基本

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

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

トリップ フィールド

Fleet Engine で配車を作成するには、次のフィールドを使用します。配車の種類（1 か所または複数か所の目的地、連続した配車、相乗り）に応じて、異なるフィールドを使用できます。省略可能なフィールドは、配車の作成時に指定することも、配車の更新時に後で設定することもできます。

トリップ フィールド
名前 必須かどうか 説明
parent ○ プロジェクト ID を含む文字列。この ID は、Fleet Engine 統合全体で同じサービス アカウントのロールを使用して使用される ID と同じである必要があります。
trip_id ○ このトリップを一意に識別するために作成する文字列。配車 ID には 特定の制限があります。これは参照に示されています。
trip_type ○ 作成するトリップの種類に応じて、TripType を次の値に設定します。
  • 1 か所の目的地: SHARED または EXCLUSIVE に設定します。
  • 複数か所の目的地: EXCLUSIVE に設定します。
  • 連続した配車: 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 が配車の到着予定時刻を計算して追跡できるように、車両に割り当てる必要があります。これは、配車の作成時または後で配車を更新するときに行うことができます。

SearchVehiclesRequest

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

たとえば、2 つの連続したトリップがあるとします。トリップ A と トリップ Bです。車両は Trip Aの利用者 を乗せ、降車 場所に向かう途中で、次のトリップである Trip Bの別の利用者を乗せるリクエストを受け取ります。

  • getVehicle() を呼び出すと、remainingWaypoints が返されます。これには、
    A 降車 → B 乗車 → B 降車が含まれます。
  • getTrip() または onTripRemainingWaypointsUpdated 配車 A の コールバックは を返します remainingWaypoints これには
    A 降車 が含まれます。
  • 配車 B の getTrip() または onTripRemainingWaypointsUpdated コールバックは、remainingWaypoints を返します。これには、
    A 降車 → B 乗車 → および B 降車 が含まれます。

次のステップ