このドキュメントでは、連続したルートを作成し、正しいフィールドを設定して、車両に割り当てて実行する方法について説明します。このガイドでは、Fleet Engine をセットアップし、車両を作成して、動作するドライバー アプリと、必要に応じてコンシューマ アプリを作成していることを前提としています。また、オンデマンド ルートで利用できるさまざまなルート シナリオにも精通している必要があります。詳しくは、次の関連ガイドをご覧ください。
- Fleet Engine を設定する
- 車両を作成する
- オンデマンド ルートの概要のルート シナリオ
旅程作成の基本
このセクションでは、Fleet Engine でルートを作成するために必要なリクエストの詳細について説明します。作成リクエストは、gRPC または REST を使用して発行します。
ルート フィールド
Fleet Engine でルートを作成するには、次のフィールドを使用します。単一または複数の目的地、連続したルート、共有プール ルートなど、さまざまな種類のルートに異なるフィールドを使用できます。省略可能なフィールドは、ルートの作成時に指定することも、後でルートを更新するときに設定することもできます。
| 名前 | 必須 | 説明 |
|---|---|---|
| parent | はい | プロジェクト ID を含む文字列。この ID は、Fleet Engine の統合全体で使用される ID と同じで、同じサービス アカウントのロールを持ちます。 |
| trip_id | はい | このルートを一意に識別する文字列。参照に記載されているように、ルート ID には特定の制限があります。 |
| trip_type | はい | 作成するルートタイプに応じて、TripType を次の値に設定します。
|
| pickup_point | はい | ルートの出発地。 |
| 中間デスティネーション | はい | 複数の目的地があるルートのみ: ドライバーが乗車と降車の間に訪れる中間目的地のリスト。 |
| vehicle_waypoints | はい | 共有プーリングのルートのみ: このフィールドは、複数のルートのウェイポイントをインターリーブできます。
割り当てられた車両の残りのウェイポイントと、このルートの乗車と降車のウェイポイントがすべて含まれています。このフィールドを設定するには、 |
| 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 でルートの到着予定時刻を計算して追跡できるように、車両に割り当てる必要があります。この設定は、ルートの作成時または後でルートを更新するときに行えます。
ルートを車両に割り当てると、連続するルートに関連付けられたウェイポイントが車両のウェイポイント フィールドに自動的に追加されます。ルートの remainingWaypoints フィールドには、ルートの乗車降車前に訪れる他のルートのウェイポイントを含む、すべてのウェイポイントのリストが含まれます。
たとえば、ルート A と ルート B の 2 つの連続したルートについて考えてみましょう。車両がルート A の乗客を乗車させ、降車地に向かっている途中で、次のルート（ルート B）の別の乗客を乗車させるリクエストを運転手が受け取った。
getVehicle()を呼び出すと、remainingWaypointsが返されます。
A 配達 → B 集荷 → B 配達 が含まれます。getTrip()または ルート A のonTripRemainingWaypointsUpdatedコールバックは、次を含むremainingWaypointsを返します。
A の乗車地。getTrip()または ルート B のonTripRemainingWaypointsUpdatedコールバックは、
A 乗車地 → B 乗車地 → B 降車地 を含むremainingWaypointsを返します。