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

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

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

旅程作成の基本

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

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

Trip Fields

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

Trip フィールド

名前	必須	説明
parent	○	プロジェクト ID を含む文字列。この ID は、フリート エンジン統合全体で同じサービス アカウント ロールで使用される ID と同じである必要があります。
trip_id	○	この乗車を一意に識別するために作成する文字列。参照に記載されているように、乗車 ID には特定の制限があります。
trip_type	○	作成する乗車タイプに応じて、TripType を次の値に設定します。 単一の宛先: SHARED または EXCLUSIVE に設定します。 Multi-destination: 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() または乗車 A の onTripRemainingWaypointsUpdated コールバックのいずれかが、A _降車を含む remainingWaypoints を返します。
  
• getTrip() または Trip B の onTripRemainingWaypointsUpdated コールバックは、
  、A _Drop-off → B _Pickup → B _Drop-off を含む remainingWaypoints を返します。

次のステップ

• 共有プール乗車を作成する
• Driver SDK を設定する