GMTDVehicleReporter 类参考

GMTDVehicleReporter 类参考

概览

用于将信息发送到 Fleet Engine 后端的对象。

仅从主线程使用此类。

公开成员函数

(void) - updateVehicleState
 更新车辆状态。
(void) - addListener:
 添加监听器。
(void) - removeListener
 移除监听器。

受保护的属性

 __pad0__:NSObject <GMSNavigatorListener

属性

GMSRoadSnappedLocationProviderListener
BOOL
locationTrackingEnabled
 此类没有公共初始化程序;请从 GMTDDeliveryDriverAPIGMTDRidesharingDriverAPI 对象的 vehicleReporter 属性中获取此对象。
NSTimeInterval locationReportingInterval
 指明将营业地点报告发送到 Fleet Engine 的最小时间间隔。

成员函数文档

- (void) updateVehicleState (GMTDVehicleState) vehicleState

更新车辆状态。

仅用于拼车。

如果 locationTrackingEnabled 设置为 NO,则将状态设置为 GMTDVehicleStateOnline 会失败。

设置其他状态会向 Fleet Engine 后端发送一次性请求。

此方法会更新服务器端状态,客户端应用应监控 fleetEngine:didSucceedVehicleUpdate:fleetEngine:didFailVehicleUpdate:withError: 以确认是成功还是失败。如果 locationTrackingEnabled 设置为“是”,系统会自动重试失败。

参数:
vehicleState所需的车辆状态。
- (void) addListener: (id< GMTDVehicleReporterListener >) 监听器

添加监听器。

监听器由弱引用保存。

参数:
监听器一个符合 GMTDVehicleReporterListener 协议的对象。
- (void) removeListener: (id< GMTDVehicleReporterListener >) 监听器

移除监听器。

参数:
监听器一个符合 GMTDVehicleReporterListener 协议的对象。

成员数据文档

- GMTDVehicleReporter:

属性说明

- (GMSRoadSnappedLocationProviderListener BOOL) locationTrackingEnabled [read, write, assign]

此类没有公共初始化程序;请从 GMTDDeliveryDriverAPIGMTDRidesharingDriverAPI 对象的 vehicleReporter 属性中获取此对象。

指明是否已启用位置跟踪。

如果此政策设为“是”,系统会根据为 locationUpdateInterval 设置的值定期将行程和车辆更新发送到 Fleet Engine 后端。

如果设为“否”,更新将停止,并且会向 Fleet Engine 后端发送一次性车辆更新请求,以将车辆状态设置为 GMTDVehicleStateOffline。如需了解在 locationTrackingEnabled 设置为 NO 时处理失败情况的特殊注意事项,请参阅 updateVehicleState

- (NSTimeInterval) locationReportingInterval [read, write, assign]

指明将营业地点报告发送到 Fleet Engine 的最小时间间隔。

注意:
默认报告间隔为 10 秒。支持的最大值为 60 秒,支持的最小值为 5 秒。如果使用了此范围之外的值,则请求的值将限制为该范围。