このドキュメントでは、単一目的地のルートを作成し、正しいフィールドを設定して、車両に割り当てて実行する方法について説明します。このガイドは、Fleet Engine を設定済みで、車両を作成し、動作するドライバーアプリと、必要に応じてユーザーアプリを用意していることを前提としています。関連する次のガイドをご覧ください。
旅程の作成の基本
このセクションでは、Fleet Engine でルートを作成するために必要なリクエストの詳細について説明します。gRPC または REST を使用して作成リクエストを発行します。
ルート フィールド
Fleet Engine でルートを作成するには、次のフィールドを使用します。1 つまたは複数の目的地、連続した乗車、共有プールの乗車など、さまざまな種類の乗車に異なるフィールドを使用できます。オプション フィールドは、ルートの作成時に指定することも、ルートの更新時に設定することもできます。
| 名前 | 必須かどうか | 説明 |
|---|---|---|
| parent | ○ | プロジェクト ID を含む文字列。この ID は、Fleet Engine の統合全体で使用される ID と同じで、同じサービス アカウント ロールを持つ必要があります。 |
| trip_id | ○ | このルートを一意に識別する文字列。リファレンスに記載されているように、ルート ID には特定の制限があります。 |
| trip_type | ○ | 作成する旅行タイプに応じて、TripType を次の値に設定します。
|
| pickup_point | ○ | ルートの出発地。 |
| 経由地 | ○ | 複数の目的地があるルートのみ: ドライバーが乗車地と降車地の間に立ち寄る中間目的地のリスト。 |
| vehicle_waypoints | ○ | 共有プールのルートのみ: このフィールドは、複数のルートのウェイポイントのインターリーブをサポートしています。これには、割り当てられた車両の残りのすべてのウェイポイントと、このルートの集荷と配達のウェイポイントが含まれます。このフィールドを設定するには、 |
| number_of_passengers | いいえ | 乗車人数。 |
| dropoff_point | いいえ | 旅行の目的地。 |
| vehicle_id | いいえ | ルートに割り当てられた車両の ID。 |
例: 例: 目的地が 1 つの旅行
次の例は、グランド インドネシア イーストモールへのルートを作成する方法を示しています。このルートには 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;
}