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

このドキュメントでは、連続した乗車を作成し、正しいフィールドを設定して、車両に割り当てて乗車を完了する方法について説明します。このガイドは、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 に設定します。
  • 複数宛先: 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 が乗車予定到着時刻を計算して追跡できるように、車両に割り当てる必要があります。これは、旅行の作成中に行うことも、後で旅行を更新するときに行うこともできます。

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

たとえば、Trip A と Trip B の 2 つの連続した移動があるとします。車両がルート A のお客様を乗車させ、降車場所に向かう途中で、次のルート ルート B の別のお客様を乗車させるリクエストがドライバーに届きました。

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

次のステップ