このドキュメントでは、単一の目的地のルートを作成し、正しいフィールドを設定して、車両に割り当てて実行する方法について説明します。このガイドでは、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。 |
例: 単一の目的地への旅行
次の例は、Grand Indonesia East Mall へのルートを作成する方法を示しています。このルートには 2 人の乗客が含まれ、限定公開で、ステータスは NEW です。ルートの provider_id は、Google Cloud プロジェクト ID と同じにする必要があります。例では、プロジェクト ID が my-rideshare-co-gcp-project の Google Cloud プロジェクトを示しています。Fleet Engine を呼び出すには、このプロジェクトにサービス アカウントも含める必要があります。詳細については、サービス アカウントのロールをご覧ください。
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
// Trip initial settings.
String parent = "providers/" + PROJECT_ID;
Trip trip = Trip.newBuilder()
.setTripType(TripType.EXCLUSIVE) // Use TripType.SHARED for carpooling.
.setPickupPoint( // Grand Indonesia East Mall.
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.195139).setLongitude(106.820826)))
.setNumberOfPassengers(2)
// Provide the drop-off point if available.
.setDropoffPoint(
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.1275).setLongitude(106.6537)))
.build();
// Create trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
.setParent(parent)
.setTripId("trip-8241890") // Trip ID assigned by the provider.
.setTrip(trip) // The initial state is NEW.
.build();
// Error handling.
try {
Trip createdTrip = tripService.createTrip(createTripRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case ALREADY_EXISTS:
break;
case PERMISSION_DENIED:
break;
}
return;
}