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

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

旅程の作成の基本

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

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

旅程フィールド

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

旅程フィールド
名前 必須かどうか 説明
parent はい プロジェクト ID を含む文字列。この ID は、Fleet Engine 統合全体で同じサービス アカウントのロールを使用して使用する必要があります。
trip_id はい この旅程を一意に識別するために作成する文字列。参照に示されているように、旅程 ID には 特定の制限があります。
trip_type はい 作成する旅程の種類に応じて、TripType を次の値に設定します。
  • 単一の目的地: 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。

例: 連続した旅程を作成する

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

// 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です。車両は旅程 A の利用者 を乗車させ、降車地点 に向かう途中で、次の旅程 B の別の利用者 を乗車させるリクエストを受け取ります。

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

次のステップ