連続したルートを作成して表示する

連続ルートとは、現在のルートを完了する前に次のユーザーを迎えに行くことを約束する、排他的で独立したルートです。

連続するルートと 1 つの目的地を経由するルートの主な違いは、連続するルートの場合、すでにルートが割り当てられている車両にルートを割り当てることができる点です。

このチュートリアルでは、連続するルートを作成するプロセスについて説明します。また、そのルートをコンシューマー アプリケーションと統合して、ユーザーがスマートフォンからルートの進捗状況を可視化する方法についても説明します。この統合には Consumer SDK を使用します。

関連情報: 単一の目的地のルートを作成して表示する。

前提条件

このチュートリアルを完了するには、次のことを完了してください。

1. Fleet Engine を設定する。詳細については、Fleet Engine: 初期設定をご覧ください。

2. アプリを Driver SDK と統合します。詳細については、Driver SDK の初期化（Android）と Driver SDK の統合ガイド（iOS）をご覧ください。

3. 消費者向けアプリを Consumer SDK と統合します。詳細については、Android の場合は Consumer SDK のスタートガイド、iOS の場合は Consumer SDK のスタートガイドをご覧ください。

4. 認証トークンを設定する。認証トークンの詳細については、Fleet Engine のスタートガイドの認可用の JSON ウェブトークンの作成と、Fleet Engine の Consumer SDK ドキュメントの認証と認可をご覧ください。

ステップ 1: Fleet Engine で車両を作成する

車両は、フリート内の車両を表すオブジェクトです。コンシューマ アプリで追跡できるようにするには、Fleet Engine で作成する必要があります。

車両を作成するには、次の 2 つの方法があります。

gRPC

CreateVehicleRequest リクエスト メッセージを指定して CreateVehicle() メソッドを呼び出します。CreateVehicle() を呼び出すには、Fleet Engine のスーパー ユーザー権限が必要です。

REST

https://fleetengine.googleapis.com/v1/providers.vehicles.create を呼び出します。

注意点

車両を作成する際は、次の点に注意してください。

• 車両の初期状態は必ず OFFLINE に設定してください。これにより、Fleet Engine はルート マッチングに使用する車両を検出できるようになります。

• 車両の provider_id は、Fleet Engine の呼び出しに使用されるサービス アカウントを含む Google Cloud プロジェクトのプロジェクト ID と同じである必要があります。複数のサービス アカウントが同じライドシェア プロバイダの Fleet Engine にアクセスできますが、Fleet Engine は現在、同じ車両にアクセスする異なる Google Cloud プロジェクトのサービス アカウントをサポートしていません。

• CreateVehicle() から返されるレスポンスには、Vehicle インスタンスが含まれます。UpdateVehicle() を使用して更新されていない場合、インスタンスは 7 日後に削除されます。車両がまだ存在しないことを確認するため、CreateVehicle() を呼び出す前に GetVehicle() を呼び出す必要があります。GetVehicle() から NOT_FOUND エラーが返された場合は、CreateVehicle() の呼び出しを続行する必要があります。詳しくは、車両とそのライフサイクルをご覧ください。

例

次のプロバイダ コードサンプルは、Fleet Engine で車両を作成する方法を示しています。

static final String PROJECT_ID = "my-rideshare-co-gcp-project";

VehicleServiceBlockingStub vehicleService = VehicleService.newBlockingStub(channel);

String parent = "providers/" + PROJECT_ID;

Vehicle vehicle = Vehicle.newBuilder()
    .setVehicleState(VehicleState.OFFLINE)  // Initial state
    .addSupportedTripTypes(TripType.EXCLUSIVE)
    .setMaximumCapacity(4)
    .setVehicleType(VehicleType.newBuilder().setCategory(VehicleType.Category.AUTO))
    .build();

CreateVehicleRequest createVehicleRequest = CreateVehicleRequest.newBuilder()
    .setParent(parent)
    .setVehicleId("8241890")  // Vehicle ID assigned by solution provider.
    .setVehicle(vehicle)      // Initial state.
    .build();

// The Vehicle is created in the OFFLINE state, and no initial position is
// provided.  When the driver app calls the rideshare provider, the state can be
// set to ONLINE, and the driver app updates the vehicle location.
try {
  Vehicle createdVehicle = vehicleService.createVehicle(createVehicleRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case ALREADY_EXISTS:
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

連続ルートをサポートする Vehicle を作成するには、CreateVehicleRequest に渡される Vehicle オブジェクトの backToBackEnabled フィールドを true として設定する必要があります。

Vehicle vehicle = Vehicle.newBuilder()
    .setVehicleState(VehicleState.OFFLINE)
    .addSupportedTripTypes(TripType.EXCLUSIVE)
    .setMaximumCapacity(4)
    .setVehicleType(VehicleType.newBuilder().setCategory(VehicleType.Category.AUTO))
    .setBackToBackEnabled(true) // Set as 'true' so vehicle can be assigned back-to-back trips.
    .build();

手順 2. 位置情報の記録を有効にする

位置情報の追跡とは、移動中の車両の位置を追跡することです。ドライバー アプリは、車両の現在地を含む Fleet Engine にテレメトリーを送信します。この常時更新される位置情報のストリームは、ルート上の車両の移動状況を伝えるために使用されます。位置情報の追跡を有効にすると、ドライバアプリはデフォルトの頻度（5 秒に 1 回）でこのテレメトリーの送信を開始します。

Android と iOS で位置情報の追跡を有効にする手順は次のとおりです。

• Driver SDK for Android メソッド enableLocationTracking() を呼び出します。

• Driver SDK for iOS のブール値プロパティ locationTrackingEnabled を true に設定します。

注: Driver SDK for Android API の呼び出しを認証するには、「Driver」ロールを使用する認証トークンが必要です。また、vehicle_id を含める必要があります。

例

次のコード例は、位置情報の追跡を有効にする方法を示しています。

Java

RidesharingVehicleReporter vehicleReporter = ...;

vehicleReporter.enableLocationTracking();

Kotlin

val vehicleReporter = ...

vehicleReporter.enableLocationTracking()

Swift

vehicleReporter.locationTrackingEnabled = true

Objective-C

_vehicleReporter.locationTrackingEnabled = YES;

ステップ 3: 車両の状態をオンラインに設定する

車両の状態を online に設定することで車両を運行（つまり使用可能にする）できますが、これは位置情報の追跡を有効にするまで実行できません。

Android と iOS の車両の状態をオンラインに設定する方法は次のとおりです。

• Driver SDK for Android メソッド setVehicleState(VehicleState.ONLINE) を呼び出します。

• Driver SDK for iOS のメソッド vehicleReporter.update(.online) を呼び出します。

例

次のコード例は、車両の状態を ONLINE に設定する方法を示しています。

Java

vehicleReporter.setVehicleState(VehicleState.ONLINE);

Kotlin

vehicleReporter.setVehicleState(VehicleState.ONLINE)

Swift

vehicleReporter.update(.online)

Objective-C

[_vehicleReporter updateVehicleState:GMTDVehicleStateOnline];

ステップ 4: Fleet Engine でルートを作成する

連続するルートを作成するには、1 つの目的地を結ぶルートの場合と同様に、Trip オブジェクトを作成します。

ルートとは、出発地、地点、降車地点などの地理的座標の点で、行程を表すオブジェクトです。ルート リクエストごとに 1 つの Trip オブジェクトを作成し、リクエストを車両と照合してトラッキングできるようにします。

• ルートを作成するには、CreateTripRequest リクエスト メッセージを指定して CreateTrip() メソッドを呼び出します。

必須属性を指定する

連続するルートを作成するには、次のフィールドを指定する必要があります。

parent

プロバイダ ID を含む文字列。これは、Fleet Engine の呼び出しに使用されるサービス アカウントを含む Google Cloud プロジェクトのプロジェクト ID と同じである必要があります。

trip_id

このルートを一意に識別する文字列。ご自身で作成します。

trip

作成する Trip オブジェクト。

CreateTripRequest に渡される Trip オブジェクトには、次のフィールドを設定する必要があります。

trip_type

TripType.EXCLUSIVE

pickup_point

ルートの出発地。

dropoff_point

ルートの降車場所。このフィールドはルートの作成時には必須ではなく、後で UpdateTrip を呼び出して設定できます。

注: CreateTrip() を使用するには、Fleet Engine: 初期設定で説明されている特権アカウントの認証情報が必要です。

例

次のバックエンド統合のサンプルは、ルートを作成して車両に割り当てる方法を示しています。

// A vehicle with ID 'my-vehicle' is already created and it is assigned to a trip with ID 'current-trip'.

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String VEHICLE_ID =" my-vehicle";
static final String TRIP_ID = "back-to-back-trip");

TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);

String parent = "providers/" + PROJECT_ID;

Trip trip = Trip.newBuilder()
    .setTripType(TripType.EXCLUSIVE)
    .setPickupPoint(
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder()
                .setLatitude(-6.195139).setLongitude(106.820826)))
    .setDropoffPoint(
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder()
                .setLatitude(-6.1275).setLongitude(106.6537)))
    .setVehicleId(VEHICLE_ID)
    .build();

// Create trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
    .setParent(parent)
    .setTripId(TRIP_ID)
    .setTrip(trip)
    .build();

// Error handling.
try {
  // Fleet Engine automatically assigns a 'waypoints' list to the trip containing
  // the vehicle's current trip waypoints.
  Trip createdTrip =
      tripService.createTrip(createTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case ALREADY_EXISTS:
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

ステップ 5. 車両 ID とウェイポイントでルートを更新する

Fleet Engine が経路に沿って車両を追跡できるように、ルートに車両 ID を設定する必要があります。連続したルートでは、車両がすでに割り当てられている場合でも、ルートは車両に割り当てられます。

注: バックエンド統合で SearchVehicles を呼び出す場合は、SearchVehiclesRequest の「includeBackToBack」フィールドを true に設定して、車両がすでにルートに割り当てられている場合はその車両が返されるようにする必要があります。

• 車両 ID でルートを更新するには、UpdateTripRequest を使用して UpdateTrip エンドポイントを呼び出します。update_mask フィールドを使用して、車両 ID を更新することを指定します。

ルートを車両に割り当てると、Fleet Engine は、連続するルートに関連付けられたウェイポイントを車両のウェイポイント フィールドに自動的に追加します。ルートの remainingWaypoints フィールドには、ルートの降車前に訪問するすべてのウェイポイント（同時ルートの地点を含む）のリストを指定します。

たとえば、ルート A とルート B の 2 つのルートが連続しているとします。車両は Trip A の顧客を迎え、降車場所に向かう途中で、ドライバーは次のルート（Trip B）の別の顧客を迎えに行くリクエストを受け取ります。

• getVehicle() を呼び出すと、
  A _降車 → B _乗車 → B _降車を含む残りの地点（remainingWaypoints）のリストが返されます。
• getTrip() または ルート A の onTripRemainingWaypointsUpdated コールバックは、降車を含む残りの地点（remainingWaypoints）のリストを返します。
• getTrip() または Trip B の onTripRemainingWaypointsUpdated コールバックは、A _Drop-off → B _Pickup → B _Drop-off を含む残りのウェイポイント（remainingWaypoints）のリストを返します。

ステップ 6. ユーザーアプリでルートの更新情報をリッスンする

• Android では、TripModelManager から TripModel オブジェクトを取得して TripModelCallback リスナーを登録することで、ルートからのデータ更新をリッスンできます。

• iOS の場合、GMTCTripService から GMTCTripModel オブジェクトを取得して GMTCTripModelSubscriber サブスクライバーを登録することで、ルートからのデータ更新をリッスンできます。

TripModelCallback リスナーと GMTCTripModelSubscriber サブスクライバーにより、アプリは自動更新間隔に基づいて更新のたびに移動状況の更新を定期的に受信できます。変化した値のみがコールバックをトリガーできます。それ以外の場合、コールバックは通知されません。

TripModelCallback.onTripUpdated() メソッドと tripModel(_:didUpdate:updatedPropertyFields:) メソッドは、データが変更されたかどうかに関係なく常に呼び出されます。

例 1

次のコードサンプルは、TripModelManager/GMTCTripService から TripModel を取得してリスナーを設定する方法を示しています。

Java

// Start journey sharing after a trip has been created via Fleet Engine.
TripModelManager tripModelManager = consumerApi.getTripModelManager();

// Get a TripModel object.
TripModel tripModel = tripModelManager.getTripModel(tripName);

// Register a listener on the trip.
TripModelCallback tripCallback = new TripModelCallback() {
  ...
};
tripModel.registerTripCallback(tripCallback);

// Set the refresh interval.
TripModelOptions tripModelOptions = TripModelOptions.builder()
    .setRefreshInterval(5000) // interval in milliseconds, so 5 seconds
    .build();
tripModel.setTripModelOptions(tripModelOptions);

// The trip stops auto-refreshing when all listeners are unregistered.
tripModel.unregisterTripCallback(tripCallback);

Kotlin

// Start journey sharing after a trip has been created via Fleet Engine.
val tripModelManager = consumerApi.getTripModelManager()

// Get a TripModel object.
val tripModel = tripModelManager.getTripModel(tripName)

// Register a listener on the trip.
val tripCallback = TripModelCallback() {
  ...
}

tripModel.registerTripCallback(tripCallback)

// Set the refresh interval.
val tripModelOptions =
  TripModelOptions.builder()
    .setRefreshInterval(5000) // interval in milliseconds, so 5 seconds
    .build()

tripModel.setTripModelOptions(tripModelOptions)

// The trip stops auto-refreshing when all listeners are unregistered.
tripModel.unregisterTripCallback(tripCallback)

Swift

let tripService = GMTCServices.shared().tripService

// Create a tripModel instance for listening for updates from the trip
// specified by the trip name.
let tripModel = tripService.tripModel(forTripName: tripName)

// Register for the trip update events.
tripModel.register(self)

// Set the refresh interval (in seconds).
tripModel.options.autoRefreshTimeInterval = 5

// Unregister for the trip update events.
tripModel.unregisterSubscriber(self)

Objective-C

GMTCTripService *tripService = [GMTCServices sharedServices].tripService;

// Create a tripModel instance for listening for updates from the trip
// specified by the trip name.
GMTCTripModel *tripModel = [tripService tripModelForTripName:tripName];

// Register for the trip update events.
[tripModel registerSubscriber:self];

// Set the refresh interval (in seconds).
tripModel.options.autoRefreshTimeInterval = 5;

// Unregister for the trip update events.
[tripModel unregisterSubscriber:self];

例 2

次のコードサンプルは、TripModelCallback リスナーと GMTCTripModelSubscriber サブスクライバーの設定方法を示しています。

Java

// Implements a callback for the trip model so your app can listen for trip
// updates from Fleet Engine.
TripModelCallback subscriber =
  new TripModelCallback() {

    @Override
    public void onTripStatusUpdated(TripInfo tripInfo, @TripStatus int status) {
      // ...
    }

    @Override
    public void onTripActiveRouteUpdated(TripInfo tripInfo, List<LatLng> route) {
      // ...
    }

    @Override
    public void onTripVehicleLocationUpdated(
        TripInfo tripInfo, @Nullable VehicleLocation vehicleLocation) {
      // ...
    }

    @Override
    public void onTripPickupLocationUpdated(
        TripInfo tripInfo, @Nullable TerminalLocation pickup) {
      // ...
    }

    @Override
    public void onTripPickupTimeUpdated(TripInfo tripInfo, @Nullable Long timestampMillis) {
      // ...
    }

    @Override
    public void onTripDropoffLocationUpdated(
        TripInfo tripInfo, @Nullable TerminalLocation dropoff) {
      // ...
    }

    @Override
    public void onTripDropoffTimeUpdated(TripInfo tripInfo, @Nullable Long timestampMillis) {
      // ...
    }

    @Override
    public void onTripETAToNextWaypointUpdated(
        TripInfo tripInfo, @Nullable Long timestampMillis) {
      // ...
    }

    @Override
    public void onTripActiveRouteRemainingDistanceUpdated(
        TripInfo tripInfo, @Nullable Integer distanceMeters) {
      // ...
    }

    @Override
    public void onTripUpdateError(TripInfo tripInfo, TripUpdateError error) {
      // ...
    }

    @Override
    public void onTripUpdated(TripInfo tripInfo) {
      // ...
    }

    @Override
    public void onTripRemainingWaypointsUpdated(
        TripInfo tripInfo, List<TripWaypoint> waypointList) {
      // ...
    }

    @Override
    public void onTripIntermediateDestinationsUpdated(
        TripInfo tripInfo, List<TerminalLocation> intermediateDestinations) {
      // ...
    }

    @Override
    public void onTripRemainingRouteDistanceUpdated(
        TripInfo tripInfo, @Nullable Integer distanceMeters) {
      // ...
    }

    @Override
    public void onTripRemainingRouteUpdated(TripInfo tripInfo, List<LatLng> route) {
      // ...
    }
  };

Kotlin

// Implements a callback for the trip model so your app can listen for trip
// updates from Fleet Engine.
val subscriber =
  object : TripModelCallback() {
    override fun onTripStatusUpdated(tripInfo: TripInfo, status: @TripStatus Int) {
      // ...
    }

    override fun onTripActiveRouteUpdated(tripInfo: TripInfo, route: List<LatLng>) {
      // ...
    }

    override fun onTripVehicleLocationUpdated(
      tripInfo: TripInfo,
      vehicleLocation: VehicleLocation?
    ) {
      // ...
    }

    override fun onTripPickupLocationUpdated(tripInfo: TripInfo, pickup: TerminalLocation?) {
      // ...
    }

    override fun onTripPickupTimeUpdated(tripInfo: TripInfo, timestampMillis: Long?) {
      // ...
    }

    override fun onTripDropoffLocationUpdated(tripInfo: TripInfo, dropoff: TerminalLocation?) {
      // ...
    }

    override fun onTripDropoffTimeUpdated(tripInfo: TripInfo, timestampMillis: Long?) {
      // ...
    }

    override fun onTripETAToNextWaypointUpdated(tripInfo: TripInfo, timestampMillis: Long?) {
      // ...
    }

    override fun onTripActiveRouteRemainingDistanceUpdated(
      tripInfo: TripInfo,
      distanceMeters: Int?
    ) {
      // ...
    }

    override fun onTripUpdateError(tripInfo: TripInfo, error: TripUpdateError) {
      // ...
    }

    override fun onTripUpdated(tripInfo: TripInfo) {
      // ...
    }

    override fun onTripRemainingWaypointsUpdated(
      tripInfo: TripInfo,
      waypointList: List<TripWaypoint>
    ) {
      // ...
    }

    override fun onTripIntermediateDestinationsUpdated(
      tripInfo: TripInfo,
      intermediateDestinations: List<TerminalLocation>
    ) {
      // ...
    }

    override fun onTripRemainingRouteDistanceUpdated(tripInfo: TripInfo, distanceMeters: Int?) {
      // ...
    }

    override fun onTripRemainingRouteUpdated(tripInfo: TripInfo, route: List<LatLng>) {
      // ...
    }
  }

Swift

class TripModelSubscriber: NSObject, GMTCTripModelSubscriber {

  func tripModel(_: GMTCTripModel, didUpdate trip: GMTSTrip?, updatedPropertyFields: GMTSTripPropertyFields) {
    // Update the UI with the new `trip` data.
    updateUI(with: trip)
    ...
  }

  func tripModel(_: GMTCTripModel, didUpdate tripStatus: GMTSTripStatus) {
    // Handle trip status did change.
  }

  func tripModel(_: GMTCTripModel, didUpdateActiveRoute activeRoute: [GMTSLatLng]?) {
    // Handle trip active route did update.
  }

  func tripModel(_: GMTCTripModel, didUpdate vehicleLocation: GMTSVehicleLocation?) {
    // Handle vehicle location did update.
  }

  func tripModel(_: GMTCTripModel, didUpdatePickupLocation pickupLocation: GMTSTerminalLocation?) {
    // Handle pickup location did update.
  }

  func tripModel(_: GMTCTripModel, didUpdateDropoffLocation dropoffLocation: GMTSTerminalLocation?) {
    // Handle drop off location did update.
  }

  func tripModel(_: GMTCTripModel, didUpdatePickupETA pickupETA: TimeInterval) {
    // Handle the pickup ETA did update.
  }

  func tripModel(_: GMTCTripModel, didUpdateDropoffETA dropoffETA: TimeInterval) {
    // Handle the drop off ETA did update.
  }

  func tripModel(_: GMTCTripModel, didUpdateRemaining remainingWaypoints: [GMTSTripWaypoint]?) {
    // Handle updates to the pickup, dropoff or intermediate destinations of the trip.
  }

  func tripModel(_: GMTCTripModel, didFailUpdateTripWithError error: Error?) {
    // Handle the error.
  }

  func tripModel(_: GMTCTripModel, didUpdateIntermediateDestinations intermediateDestinations: [GMTSTerminalLocation]?) {
    // Handle the intermediate destinations being updated.
  }

  ...
}

Objective-C

@interface TripModelSubscriber : NSObject <GMTCTripModelSubscriber>
@end

@implementation TripModelSubscriber

- (void)tripModel:(GMTCTripModel *)tripModel
            didUpdateTrip:(nullable GMTSTrip *)trip
    updatedPropertyFields:(GMTSTripPropertyFields)updatedPropertyFields {
  // Update the UI with the new `trip` data.
  [self updateUIWithTrip:trip];
  ...
}

- (void)tripModel:(GMTCTripModel *)tripModel didUpdateTripStatus:(enum GMTSTripStatus)tripStatus {
  // Handle trip status did change.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdateActiveRoute:(nullable NSArray<GMTSLatLng *> *)activeRoute {
  // Handle trip route did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdateVehicleLocation:(nullable GMTSVehicleLocation *)vehicleLocation {
  // Handle vehicle location did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdatePickupLocation:(nullable GMTSTerminalLocation *)pickupLocation {
  // Handle pickup location did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdateDropoffLocation:(nullable GMTSTerminalLocation *)dropoffLocation {
  // Handle drop off location did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel didUpdatePickupETA:(NSTimeInterval)pickupETA {
  // Handle the pickup ETA did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdateRemainingWaypoints:(nullable NSArray<GMTSTripWaypoint *> *)remainingWaypoints {
  // Handle updates to the pickup, dropoff or intermediate destinations of the trip.
}

- (void)tripModel:(GMTCTripModel *)tripModel didUpdateDropoffETA:(NSTimeInterval)dropoffETA {
  // Handle the drop off ETA did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel didFailUpdateTripWithError:(nullable NSError *)error {
  // Handle the error.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdateIntermediateDestinations:
        (nullable NSArray<GMTSTerminalLocation *> *)intermediateDestinations {
  // Handle the intermediate destinations being updated.
}
…
@end

ルートの情報には、いつでも次の方法でアクセスできます。

• Consumer SDK for Android メソッド TripModel.getTripInfo() を呼び出します。このメソッドを呼び出してもデータの更新は強制されませんが、データは更新頻度で更新され続けます。

• Consumer SDK for iOS のプロパティ GMTCTripModel.currentTrip を取得します。

ステップ 7. ユーザー アプリにジャーニーを表示する

配車と配達のユーザー インターフェース エレメントの API には、次の方法でアクセスできます。

• Consumer SDK for Android の ConsumerController オブジェクトを取得します。詳しくは、User Interface Element API の使用をご覧ください。

• Consumer SDK for iOS の GMTCMapView オブジェクトを取得します。詳しくは、User Interface Element API の使用をご覧ください。

例

次のコード例は、ジャーニー共有のユーザー インターフェースを開始する方法を示しています。

Java

JourneySharingSession session = JourneySharingSession.createInstance(tripModel);
consumerController.showSession(session);

Kotlin

val session = JourneySharingSession.createInstance(tripModel)
consumerController.showSession(session)

Swift

let journeySharingSession = GMTCJourneySharingSession(tripModel: tripModel)
mapView.show(journeySharingSession)

Objective-C

GMTCJourneySharingSession *journeySharingSession =
    [[GMTCJourneySharingSession alloc] initWithTripModel:tripModel];
[self.mapView showMapViewSession:journeySharingSession];

状況の例

車両が最初のルートですでに乗車している状態の連続移動について考えてみましょう。車両は、降車ポイントに向かう途中であり、ドライバーは、現在のルートの完了時に別の消費者の乗車を依頼するリクエストを受信します。

この時点で、最初のルートのユーザーには次のように表示されます。

同時に、2 回目のルートのユーザーには次のように表示されます。

デフォルトでは、Consumer SDK はルート内のアクティブな区間だけを表示しますが、目的地を含む残りの区間を表示することもできます。

他のルートの地点に関する情報を表示する場合は、次のように、ルートに関連するすべての地点にアクセスできます。

• Consumer SDK for Android メソッド TripModel.getTripInfo() を呼び出します。次に、TripInfo.getRemainingWaypoints() を呼び出して TripWaypoint を取得します。各 TripWaypoint オブジェクトには、ルート ID、地点の位置、地点のタイプが含まれます。

• Consumer SDK for iOS のプロパティ GMTCTripModel.currentTrip を取得します。次に、GMTSTrip.remainingWaypoints 配列を取得して GMTSTripWaypoint にアクセスします。各 GMTSTripWaypoint オブジェクトには、ルート ID、地点の位置、地点のタイプが含まれます。

ステップ 8. Fleet Engine でルート ステータスを管理する

ルートの状態は、TripStatus 列挙値のいずれかを使用して指定します。ルートのステータスが変化した場合（ENROUTE_TO_PICKUP から ARRIVED_AT_PICKUP に変更した場合など）、Fleet Engine を使用してルートのステータスを更新する必要があります。ルート状態は常に NEW の値で始まり、COMPLETE または CANCELED の値で終わります。詳細については、trip_status をご覧ください。

例

次のバックエンド統合のサンプルは、Fleet Engine でルート ステータスを更新する方法を示しています。

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "trip-8241890";

String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_ID;

TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);

// Trip settings to be updated.
Trip trip = Trip.newBuilder()
    .setTripStatus(TripStatus.ARRIVED_AT_PICKUP)
    .build();

// Trip update request
UpdateTripRequest updateTripRequest = UpdateTripRequest.newBuilder()
    .setName(tripName)
    .setTrip(trip)
    .setUpdateMask(FieldMask.newBuilder().addPaths("trip_status"))
    .build();

// Error handling.
try {
  Trip updatedTrip = tripService.updateTrip(updateTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case NOT_FOUND:            // The trip doesn't exist.
      break;
    case FAILED_PRECONDITION:  // The given trip status is invalid.
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}