相乗りプールルートとは、同時に車両をシェアする、複数の利用者による相乗りルートです。つまり、これらのルートは独立ではなく、同時に発生しています。 この仕組みは空港シャトルと同様ですが、運転手がルート上で消費者を降ろせる点が異なります。
共有プールと目的地が 1 つのルートの主な違いは、共有プールのルートでは、複数の乗客を同時に輸送できるという点です。
このチュートリアルでは、共有プールでの移動手段を作成するプロセスについて説明します。また、そのルートをコンシューマー アプリケーションと統合して、ユーザーがスマートフォンからルートの進捗状況を可視化する方法についても説明します。この統合には 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
オブジェクトで、サポートされているルートタイプのリストに TripType.SHARED
を追加する必要があります。
Vehicle vehicle = Vehicle.newBuilder()
.setVehicleState(VehicleState.OFFLINE)
.addSupportedTripTypes(TripType.SHARED)
.setMaximumCapacity(4)
.setVehicleType(VehicleType.newBuilder().setCategory(VehicleType.Category.AUTO))
.build();
手順 2. 位置情報の記録を有効にする
位置情報の追跡とは、移動中の車両の位置を追跡することです。ドライバー アプリは、車両の現在地を含む Fleet Engine にテレメトリーを送信します。この常時更新される位置情報のストリームは、ルート上の車両の移動状況を伝えるために使用されます。位置情報の追跡を有効にすると、ドライバアプリはデフォルトの頻度(5 秒に 1 回)でこのテレメトリーの送信を開始します。
Android と iOS で位置情報の追跡を有効にする手順は次のとおりです。
Driver SDK for Android メソッド
enableLocationTracking()
を呼び出します。Driver SDK for iOS のブール値プロパティ
locationTrackingEnabled
をtrue
に設定します。
例
次のコード例は、位置情報の追跡を有効にする方法を示しています。
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.SHARED
pickup_point
- ルートの出発地。
dropoff_point
- ルートの降車場所。このフィールドはルートの作成時には必須ではなく、後で
UpdateTrip
を呼び出して設定できます。
例
次のバックエンド統合のサンプルは、ルートを作成し、共有プールとして車両に自動的に割り当てる方法を示しています。
// Vehicle with VEHICLE_ID ID is already created and it is assigned Trip A.
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "shared-trip-A";
static final String VEHICLE_ID = "your-vehicle-id";
static final String TRIP_A_ID = "trip-a-id";
static final String TRIP_B_ID = "trip-b-id";
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
String parent = "providers/" + PROJECT_ID;
LatLng tripBPickup =
LatLng.newBuilder().setLatitude(-12.12314).setLongitude(88.142123).build();
LatLng tripBDropoff =
LatLng.newBuilder().setLatitude(-14.12314).setLongitude(90.142123).build();
TerminalLocation tripBPickupTerminalLocation =
TerminalLocation.newBuilder().setPoint(tripBPickup).build();
TerminalLocation tripBDropoffTerminalLocation =
TerminalLocation.newBuilder().setPoint(tripBDropoff).build();
// TripA already exists and it's assigned to a vehicle with VEHICLE_ID ID.
Trip tripB = Trip.newBuilder()
.setTripType(TripType.SHARED)
.setVehicleId(VEHICLE_ID)
.setPickupPoint(tripBPickupTerminalLocation)
.setDropoffPoint(tripBDropoffTerminalLocation)
.addAllVehicleWaypoints(
// This is where you define the arrival order for unvisited waypoints.
// If you don’t specify an order, then the Fleet Engine adds Trip B’s
// waypoints to the end of Trip A’s.
ImmutableList.of(
// Trip B’s pickup point.
TripWaypoint.newBuilder()
.setLocation(tripBPickupTerminalLocation)
.setTripId(TRIP_B_ID)
.setWaypointType(WaypointType.PICKUP_WAYPOINT_TYPE)
.build(),
// Trip A’s drop-off point.
TripWaypoint.newBuilder()
.setLocation(tripA.getDropoffPoint())
.setTripId(TRIP_A_ID)
.setWaypointType(WaypointType.DROP_OFF_WAYPOINT_TYPE)
.build(),
// Trip B’s drop-off point.
TripWaypoint.newBuilder()
.setLocation(tripBDropoffTerminalLocation)
.setTripId(TRIP_B_ID)
.setWaypointType(WaypointType.DROP_OFF_WAYPOINT_TYPE)
.build()))
.build();
// Create Trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
.setParent(parent)
.setTripId(TRIP_B_ID)
.setTrip(tripB)
.build();
try {
// createdTrip.remainingWaypoints will contain shared-pool waypoints.
// [tripB.pickup, tripA.dropoff, tripB.dropoff]
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 を設定する必要があります。
- 車両 ID でルートを更新するには、
UpdateTripRequest
を使用してUpdateTrip
エンドポイントを呼び出します。update_mask
フィールドを使用して、車両 ID を更新することを指定します。
ルートに含まれる車両の地点のコレクション(Trip.vehicle_waypoints
)には、訪問しなかった地点への順序を指定する必要があります。Fleet Engine はこのリストを使用して、共有プール内のすべてのルートのルートの地点を自動的に更新します。
たとえば、共有プールで Trip A と Trip B という 2 つのルートがあるとします。ルート A は、降車場所に向かう途中です。次に、「ルート B」が同じ車両に追加されます。ルート B の 1 つの UpdateTripRequest
で、vehicleId
を設定し、Trip.vehicle_waypoints
を最適な地点の順序(B 乗車 → A 降車 → B 降車)に設定します。
getVehicle()
を呼び出すと、
B Pickup → A Drop-off → B Drop-off を含む残りの地点(remainingWaypoints
)のリストが返されます。getTrip()
または ルート A のonTripRemainingWaypointsUpdated
コールバックは、B 乗車 → 降車を含む残りの地点(remainingWaypoints
)のリストを返します。getTrip()
または Trip B のonTripRemainingWaypointsUpdated
コールバックは、B 乗車 → 降車 → B 降車を含む残りの地点(remainingWaypoints
)のリストを返します。
例
次のバックエンド統合のサンプルは、共有プール内の 2 つのルートについて、車両 ID とウェイポイントでルートを更新する方法を示しています。
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_A_ID = "share-trip-A";
static final String TRIP_B_ID = "share-trip-B";
static final String VEHICLE_ID = "Vehicle";
String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_B_ID;
// Get Trip A and Trip B objects from either the Fleet Engine or storage.
Trip tripA = …;
Trip tripB = …;
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
// The trip settings to update.
Trip trip = Trip.newBuilder()
.setVehicleId(VEHICLE_ID)
.addAllVehicleWaypoints(
// This is where you define the arrival order for unvisited waypoints.
// If you don’t specify an order, then the Fleet Engine adds Trip B’s
// waypoints to the end of Trip A’s.
ImmutableList.of(
// Trip B’s pickup point.
TripWaypoint.newBuilder()
.setLocation(tripB.getPickupPoint())
.setTripId(TRIP_B_ID)
.setWaypointType(WaypointType.PICKUP_WAYPOINT_TYPE)
.build(),
// Trip A’s drop-off point.
TripWaypoint.newBuilder()
.setLocation(tripA.getDropoffPoint())
.setTripId(TRIP_A_ID)
.setWaypointType(WaypointType.DROP_OFF_WAYPOINT_TYPE)
.build(),
// Trip B’s drop-off point.
TripWaypoint.newBuilder()
.setLocation(tripB.getDropoffPoint())
.setTripId(TRIP_B_ID)
.setWaypointType(WaypointType.DROP_OFF_WAYPOINT_TYPE)
.build()))
.build();
// The trip update request.
UpdateTripRequest updateTripRequest = UpdateTripRequest.newBuilder()
.setName(tripName)
.setTrip(trip)
.setUpdateMask(FieldMask.newBuilder()
.addPaths("vehicle_id")
.addPaths("vehicle_waypoints"))
.build();
// Error handling. If Fleet Engine has both a trip and vehicle with the IDs,
// and if the credentials validate, and if the given vehicle_waypoints list
// is valid, then the service updates the trip.
try {
Trip updatedTrip = tripService.updateTrip(updateTripRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND: // Either the trip or vehicle does not exist.
break;
case PERMISSION_DENIED:
break;
case INVALID_REQUEST: // vehicle_waypoints is invalid.
break;
}
return;
}
ステップ 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];
デフォルトでは、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;
}