リスナーを設定する
Driver SDK を初期化し、GMTDDeliveryDriverAPI
を作成した後
たとえば、イベント リスナーをセットアップして、イベントの成功または失敗を
車両の最新情報が
Fleet Engine とバックエンドに送信されますこれらのリスナーは
ドライバー アプリ内のアクションをトリガーできます。たとえば、
通信に失敗します。
車両の更新イベントをリッスンする
ドライバーがドライバーアプリで位置情報の更新を有効にすると、Driver SDK は GMTDDeliveryVehicleReporter
クラスを介して Fleet Engine とお客様のバックエンドに定期的な車両の更新を送信します。更新に対するアプリの応答を設定できます
GMTDVehicleReporterListener
プロトコルを設定して、イベントをリッスンします。
GMTDVehicleReporterListener
では、次のイベントを処理できます。
vehicleReporter:didSucceedVehicleUpdate
バックエンド サービスが受信メッセージを正常に受信したことをドライバー アプリに通知します。 車両の位置情報と状態を更新します。
vehicleReporter:didFailVehicleUpdate:withError
車両の更新に失敗したことをリスナーに通知します。運転手が 位置情報の更新を有効にしても、
GMTDDeliveryVehicleReporter
クラスは引き続き Fleet Engine に最新データを送信します。
次の例は、GMTDVehicleReporterListener
を以下に設定する方法を示しています。
次のイベントを処理します。
Swift
import GoogleRidesharingDriver
private let providerID = "INSERT_YOUR_PROVIDER_ID"
class SampleViewController: UIViewController, GMTDVehicleReporterListener {
private let mapView: GMSMapView
override func viewDidLoad() {
// Assumes you have implemented the sample code up to this step.
deliveryDriverAPI.vehicleReporter.add(self)
}
func vehicleReporter(_ vehicleReporter: GMTDDeliveryVehicleReporter, didSucceed vehicleUpdate: GMTDVehicleUpdate) {
// Handle update succeeded.
}
func vehicleReporter(_ vehicleReporter: GMTDDeliveryVehicleReporter, didFail vehicleUpdate: GMTDVehicleUpdate, withError error: Error) {
// Handle update failed.
}
}
Objective-C
SampleViewController.h
@interface SampleViewController : UIViewController<GMTDVehicleReporterListener>
@end
SampleViewController.m
#import "SampleViewController.h"
#import "SampleAccessTokenProvider.h"
#import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";
@implementation SampleViewController {
GMSMapView *_mapView;
}
- (void)viewDidLoad {
// ASSUMES YOU IMPLEMENTED HAVE THE SAMPLE CODE UP TO THIS STEP.
[delivervehicleReporter addListener:self];
}
- (void)vehicleReporter:(GMTDDeliveryVehicleReporter *)vehicleReporter didSucceedVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate {
// Handle update succeeded.
}
- (void)vehicleReporter:(GMTDDeliveryVehicleReporter *)vehicleReporter didFailVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate withError:(NSError *)error {
// Handle update failed.
}
@end
位置情報の更新を有効にする
位置情報の更新を有効にするには、ドライバー アプリで
GMTDDeliveryVehicleReporter
、locationTrackingEnabled
を設定
YES
。その後、GMTDDeliveryVehicleReporter
クラスは位置情報の更新を Fleet Engine に自動的に送信します。また、GMSNavigator
がナビゲーション モードの場合、
デスティネーションが setDestinations
で設定されている場合、
GMTDDeliveryVehicleReporter
クラスがルートと ETA の更新を自動的に送信
Driver SDK は、ドライバーの現在のナビゲーション パスと一致するようにルートを設定します。正確な位置情報の更新を確実に行うには、-setDestinations:callback:
のウェイポイントを、Fleet Engine のリンク先と一致するように設定します。
次の例は、位置情報の更新を有効にする方法を示しています。
Swift
import GoogleRidesharingDriver
private let providerID = "INSERT_YOUR_PROVIDER_ID"
class SampleViewController: UIViewController, GMTDVehicleReporterListener {
private let mapView: GMSMapView
override func viewDidLoad() {
// Assumes you have implemented the sample code up to this step.
deliveryDriverAPI.vehicleReporter.locationTrackingEnabled = true
}
}
Objective-C
SampleViewController.m
#import "SampleViewController.h"
#import "SampleAccessTokenProvider.h"
#import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";
@implementation SampleViewController {
GMSMapView *_mapView;
}
- (void)viewDidLoad {
// ASSUMES YOU HAVE IMPLEMENTED THE SAMPLE CODE UP TO THIS STEP.
deliveryDriverAPI.vehicleReporter.locationTrackingEnabled = YES;
}
@end
(省略可)更新間隔を設定する
デフォルトでは、locationTrackingEnabled
を YES
に設定すると、Driver SDK が
Fleet Engine に 10 秒間隔で位置情報の更新データを送信します。変更可能
locationUpdateInterval
の更新間隔(最小の更新間隔)
5 秒~ 60 秒に設定しますより頻繁に更新を行うと、
低速になります