このドキュメントでは、単一目的地のトリップを作成し、正しいフィールドを設定して、車両に割り当ててフルフィルメントする方法について説明します。このガイドは、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。 |
例: 目的地が 1 つのルート
次の例は、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;
}