このドキュメントでは、単一の目的地ルートを作成し、正しいルートを設定する方法について説明します。 車両に割り当てることができます。フリートがセットアップ済みであることを前提としています。 車両を作成済みで、動作中のドライバー用アプリがあることを確認し、 コンシューマアプリでも実行できます詳細については、次の関連ガイドをご覧ください。
旅行の作成の基本
このセクションでは、 Fleet EnginegRPC と REST のいずれかを使用して作成リクエストを発行します。
ルートのフィールド
Fleet Engine でルートを作成するには、次のフィールドを使用します。別の方法を使用して、 フィールドを使用して、1 つの目的地、複数の目的地、 連続してプールを行ったり、プール旅行をシェアしたりできます。マイページ ルートの作成時にオプション フィールドを指定することも、自分で ルートを更新したときに 自動的に設定されます
| 名前 | 必須 | 説明 |
|---|---|---|
| 親 | ○ | プロジェクト ID を含む文字列。この ID は、使用されている ID と同じである必要があります Fleet Engine インテグレーション全体にわたり、同じサービス アカウントで できます。 |
| trip_id | ○ | このルートを一意に識別する文字列。ルート ID の属性 特定の制限が適用されます。 |
| trip_type | ○ | 作成するルートのタイプに応じて、TripType に次の値を設定します。
<ph type="x-smartling-placeholder">
|
| pickup_point | ○ | ルートの出発地。 |
| 中間デスティネーション | ○ | 複数の目的地を含むルートのみ: ドライバーがルート間を通る中間の目的地のリスト
ピックアップとドロップオフです |
| vehicle_waypoints | ○ | 共有プールのルートのみ: このフィールドでは、複数のルートのウェイポイントをインターリーブできます。
これには、割り当てられた車両の残りのウェイポイントもすべて含まれます。
このルートの乗り降り地点として設定しますこのフィールドは
|
| number_of_passengers | いいえ | 旅行の乗客数。 |
| dropoff_point | いいえ | ルートの目的地。 |
| vehicle_id | いいえ | ルートに割り当てられている車両の ID。 |
例: 1 つの目的地を含むルート
次の例は、グランド インドネシアへの旅行を作成する方法を示しています
イースト モール。このルートには 2 人の乗客が伴い、独占的なステータスです。
NEW。ルートの provider_id は、Google Cloud と同じである必要があります。
プロジェクト ID です。この例は、プロジェクト ID が割り当てられた Google Cloud プロジェクトを示しています。
my-rideshare-co-gcp-project。このプロジェクトにはサービス アカウントも必要です
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;
}