本部分介绍了如何准备好车辆以便出行。您必须完成 以下每个步骤,您的后端才能将车辆与行程匹配。
设置监听器
初始化驱动程序 SDK 并创建 GMTDRidesharingDriverAPI
之后
例如,您可以设置事件监听器来监控
将车辆更新发送到 Fleet Engine 和您的后端。这些监听器
触发操作,例如,在以下情况发生时通知驾驶员:
与后端的通信失败。
监听车辆更新事件
当驾驶员在驾驶应用中启用位置信息更新时,驱动程序 SDK
定期向 Fleet Engine 和客户发送车辆更新信息
通过 GMTDVehicleReporter
类在后端运行。您可以让应用做出响应
通过设置 GMTDVehicleReporterListener
协议来更新事件。
借助 GMTDVehicleReporterListener
,您可以处理以下事件:
vehicleReporter:didSucceedVehicleUpdate
通知驱动程序应用后端服务已成功收到 车辆位置和状态更新。
vehicleReporter:didFailVehicleUpdate:withError
通知监听器车辆更新失败。只要驾驶员有 启用位置信息更新后,
GMTDVehicleReporter
类会继续发送 将最新数据传输到 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.
ridesharingDriverAPI.vehicleReporter.add(self)
}
func vehicleReporter(_ vehicleReporter: GMTDVehicleReporter, didSucceed vehicleUpdate: GMTDVehicleUpdate) {
// Handle update succeeded.
}
func vehicleReporter(_ vehicleReporter: GMTDVehicleReporter, 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 have implemented the sample code up to this step.
[ridesharingDriverAPI.vehicleReporter addListener:self];
}
- (void)vehicleReporter:(GMTDVehicleReporter *)vehicleReporter didSucceedVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate {
// Handle update succeeded.
}
- (void)vehicleReporter:(GMTDVehicleReporter *)vehicleReporter didFailVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate withError:(NSError *)error {
// Handle update failed.
}
@end
监听车辆位置信息更新
Navigation SDK 通过
GMSRoadSnappedLocationProvider
类。要接收这些更新,您必须将
向上调用 GMTDVehicleReporter
作为监听器。
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.
if let roadSnappedLocationProvider = mapView.roadSnappedLocationProvider {
roadSnappedLocationProvider.add(ridesharingDriverAPI.vehicleReporter)
roadSnappedLocationProvider.startUpdatingLocation()
}
}
}
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 have implemented the sample code up to this step.
[_mapView.roadSnappedLocationProvider addListener:ridesharingDriverAPI.vehicleReporter];
[_mapView.roadSnappedLocationProvider startUpdatingLocation];
}
@end
启用位置信息更新
要启用位置信息更新,请将以下日期的locationTrackingEnabled
设为true
:
GMTDVehicleReporter
。然后是 GMTDVehicleReporter
类
自动将位置更新发送到 Fleet Engine。部署了 Fleet Engine
客户后端服务匹配并将车辆分配给行程,
GMTDVehicleReporter
类会在发生以下情况时自动发送路线更新:
GMSNavigator
处于导航模式,即通过
setDestinations
。
驱动程序 SDK 会设置与驾驶员的当前导航路径匹配的路线。接收者
确保位置信息更新准确无误,请在 setDestinations
中设置匹配的航点
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.
ridesharingDriverAPI.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.
ridesharingDriverAPI.vehicleReporter.locationTrackingEnabled = YES;
}
@end
设置更新间隔
默认情况下,当您将 locationTrackingEnabled
设置为 true
时,驱动程序 SDK 会
每隔 10 秒向 Fleet Engine 发送行程和车辆更新。您可以
将 locationUpdateInterval
的更新间隔更改为最短更新时间
为 5 秒或最长 60 秒。更新频率可能会更高
会导致请求速度变慢和错误
将车辆状态设为在线
启用位置信息更新后,将车辆状态设置为 ONLINE
,
Fleet Engine 中的搜索查询。
以下示例展示了如何将车辆状态设置为 ONLINE
。对于
详情,请参阅 updateVehicleState
。
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.
ridesharingDriverAPI.vehicleReporter.update(.online)
}
}
Objective-C
#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.
[ridesharingDriverAPI.vehicleReporter
updateVehicleState:GMTDVehicleStateOnline];
}
@end