このドキュメントでは、目的地のルートを 1 つ作成し、正しいフィールドを設定し、車両に割り当てる方法について説明します。ここでは、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。 |
例: 単一の目的地への旅行
次の例は、グランド インドネシア イースト モールへのルートを作成する方法を示しています。このルートには 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;
}