目的地が 1 つのルートを作成する

このドキュメントでは、単一の目的地への乗車を作成し、正しいフィールドを設定して、車両に割り当てて完了する方法について説明します。このガイドでは、Fleet Engine を設定済みで、車両を作成済みで、ドライバー アプリが機能しており、必要に応じて消費者向けアプリも作成済みであることを前提としています。関連する次のガイドをご覧ください。

• Fleet Engine を設定する
• 車両を作成する

旅程作成の基本

このセクションでは、Fleet Engine で乗車を作成するために必要なリクエストの詳細について説明します。gRPC または REST を使用して作成リクエストを発行します。

• CreateTrip() メソッド: gRPC または REST
• CreateTripRequest メッセージ: gRPC のみ

Trip Fields

次のフィールドを使用して、Fleet Engine で乗車を作成します。単一または複数の目的地、連続した乗車、相乗りなど、さまざまな種類の乗車に異なるフィールドを使用できます。省略可能なフィールドは、乗車ルートの作成時に指定することも、乗車ルートの更新時に後で設定することもできます。

Trip フィールド

名前	必須	説明
parent	はい	プロジェクト ID を含む文字列。この ID は、フリート エンジン統合全体で使用される ID と同じで、同じサービス アカウントのロールが必要です。
trip_id	はい	この乗車を一意に識別するために作成する文字列。参照に示されているように、乗車 ID には特定の制限があります。
trip_type	はい	作成する乗車タイプに応じて、TripType を次の値に設定します。 単一の宛先: SHARED または EXCLUSIVE に設定します。 Multi-destination: EXCLUSIVE に設定します。 Back-to-back: EXCLUSIVE に設定します。 共有プーリング: SHARED に設定します。
pickup_point	はい	旅行の出発地。
経由地	はい	複数目的地ルートのみ: 乗車場所と降車場所の間で運転手が立ち寄る中間目的地のリスト。dropoff_point と同様に、このフィールドは UpdateTrip を呼び出すことで後から設定することもできますが、複数目的地ルートには定義上、中間目的地が含まれます。
vehicle_waypoints	はい	共有プールの乗車のみ: このフィールドは、複数の乗車からの経由地のインターリーブをサポートします。割り当てられた車両の残りのすべての経由地と、この乗車 / 降車地点が含まれます。このフィールドを設定するには、CreateTrip または UpdateTrip を呼び出します。UpdateVehicle の呼び出しで waypoints フィールドを使用して、車両の経由地を更新することもできます。プライバシー上の理由から、このサービスは GetTrip 呼び出しでこの情報を返しません。
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;
}

次のステップ

• ルートの状態を更新して管理する
• Driver SDK を設定する