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

このドキュメントでは、連続したルートを作成し、正しいルートを 車両に割り当てることができます。このチュートリアルでは、Fleet Engine をセットアップし、車両を作成して、動作するドライバー アプリと、必要に応じてユーザー アプリを用意していることを前提としています。また、オンデマンド ルートで利用可能なさまざまなルート シナリオにも精通している必要があります。詳しくは、次の関連ガイドをご覧ください。

旅程作成の基本

このセクションでは、 Fleet EnginegRPC と REST のいずれかを使用して作成リクエストを発行します。

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

ルートのフィールド

Fleet Engine でルートを作成するには、次のフィールドを使用します。単一または複数の目的地、連続したルート、共有プール ルートなど、さまざまな種類のルートに異なるフィールドを使用できます。マイページ ルートの作成時にオプション フィールドを指定することも、自分で ルートを更新したあとに

ルートのフィールド
名前 必須 説明
親 ○ プロジェクト ID を含む文字列。この ID は、使用されている ID と同じである必要があります Fleet Engine インテグレーション全体にわたり、同じサービス アカウントで できます。
trip_id ○ このルートを一意に識別する文字列。参照に記載されているように、ルート ID には特定の制限があります。
trip_type ○ 作成するルートのタイプに応じて、TripType に次の値を設定します。 <ph type="x-smartling-placeholder">
    </ph>
  • 単一のデスティネーション: 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。

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

以下は、連続したルートを作成し、それを あります。このシナリオでは、ルートの作成は単一の目的地のルートの場合と同じです。後で別のルートを作成して車両に割り当てます すでに有効なルートがあります

// 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 という 2 つのルートがあるとします。 「ルート B」が表示されます。顧客が迎えに来た ルート A で、降車場所に向かって 別の消費者を乗車するリクエストを受信し、 次のルートはルート Bです

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

次のステップ