<GMSNavigatorListener> 协议参考

<GMSNavigatorListener> 协议参考

概览

GMSNavigator 上的事件的监听器。

公开成员函数

(void) - navigator:didArriveAtWaypoint
 在驾驶员到达 GMSNavigationWaypoint 时调用。
(void) - navigatorDidChangeRoute:
 在当前路线更改或被清除时调用。
(void) - navigator:didUpdateRemainingTime
 在到达目的地的预计时间更新时调用。
(void) - navigator:didUpdateRemainingDistance
 在与目的地的预估距离更新时调用。
(void) - navigator:didUpdateDelayCategory
 在目的地的延迟类别更新时调用。
(void) - navigator:didChangeSuggestedLightingMode:
 在估算的照明条件更新时调用,例如当夜晚位于设备的当前位置时。
(void) - navigator:didUpdateSpeedingPercentage:
 通知驾驶员超出了规定速度限制的百分比。
(void) - navigator:didUpdateSpeedAlertSeverity:speedingPercentage:
 向您发送通知,告知您设备检测到车辆超出速度限制指定的百分比,同时显示当前速度警报的严重程度。
(void) - navigator:didUpdateNavInfo:
 在当前 GMSNavigationNavInfo 更新时调用。

成员函数文档

- (void) 导航器: (GMSNavigator *) 导航器
dorriveAtWaypoint: (GMSNavigationWaypoint *) 航点
[optional]

在驾驶员到达 GMSNavigationWaypoint 时调用。

参数:
途经点到达的航点。
- (void) navigatorDidChangeRoute: (GMSNavigator *) 导航器 [optional]

在当前路线更改或被清除时调用。

请注意,此监听器有多种触发器类型,包括但不限于:

  • 进行中的行程已更新
  • 司机偏离当前路线
  • 司机从界面中选择了备选路线
  • 已提供或要求司机使用更好的路线
  • 司机开始导航到目的地(通过调用 setDestinations)
  • 驾驶员在抵达前一个航点后开始导航到新的航点
  • 路线已被清除(通过调用 clearDestinations)
- (void) 导航器: (GMSNavigator *) 导航器
dodUpdateRemainingTime: (NSTimeInterval) time
[optional]

在到达目的地的预计时间更新时调用。

参数:
时间到达下一个目的地所需的时间。
- (void) 导航器: (GMSNavigator *) 导航器
dodUpdateRemainingDistance: (CLLocationDistance) distance
[optional]

在与目的地的预估距离更新时调用。

参数:
距离与下一个目的地的距离。
- (void) 导航器: (GMSNavigator *) 导航器
dodUpdateDelayCategory: (GMSNavigationDelayCategory) delayCategory
[optional]

在目的地的延迟类别更新时调用。

参数:
delayCategory下一个目的地的延迟类别。
- (void) 导航器: (GMSNavigator *) 导航器
dodChangeSuggestedLightingMode: (GMSNavigationLightingMode) lightingMode
[optional]

在估算的照明条件更新时调用,例如当夜晚位于设备的当前位置时。

参数:
lightingMode建议用于匹配当前光照条件的颜色模式。
- (void) 导航器: (GMSNavigator *) 导航器
dodUpdateSpeedingPercentage: (CGFloat) percentageAboveLimit
[optional]

通知驾驶员超出了规定速度限制的百分比。

参数:
导航器用于报告超速情况的 GMSNavigator
percentageAboveLimit驾驶员目前的驾驶速度超过限速的百分比。如果驾驶员没有超速,则设为 0。如果速度限制或当前速度无效,则设置为 -1。
- (void) 导航器: (GMSNavigator *) 导航器
dodUpdateSpeedAlertSeverity: (GMSNavigationSpeedAlertSeverity) speedAlertSeverity
speedingPercentage: (CGFloat) percentageAboveLimit
[optional]

向您发送通知,告知您设备检测到车辆超出速度限制指定的百分比,同时显示当前速度警报的严重程度。

只要有有效的速度或速度限制更新,系统就会定期调用此方法。这通常会导致在主动导航期间,当驾驶员正在行驶中时频繁呼叫。

参数:
导航器用于报告超速情况的 GMSNavigator
speedAlertSeverity当前速度警报的严重程度。当速度限制未知或速度无效时,设置为 GMSNavigationSpeedAlertSeverityUnknown。如果驾驶员未按 GMSNavigationSpeedAlertOptions 中配置的阈值超速,则设为 GMSNavigationSpeedAlertSeverityNotSpeeding。当驾驶员超速时,系统会根据配置的阈值将此值设为 GMSNavigationSpeedAlertSeverityMinorGMSNavigationSpeedAlertSeverityMajor
percentageAboveLimit驾驶员目前的驾驶速度超过限速的百分比。仅在 speedAlertSeverity 为 Minor 或 Major 时有效。
- (void) 导航器: (GMSNavigator *) 导航器
dodUpdateNavInfo: (GMSNavigationNavInfo *) navInfo
[optional]

在当前 GMSNavigationNavInfo 更新时调用。

在有效导航期间,系统会定期调用此方法。

参数:
navInfo更新后的 GMSNavigationNavInfo