<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 *) 導航裝置
doArriveAtWaypoint: (GMSNavigationWaypoint *) waypoint
[optional]

司機抵達時呼叫GMSNavigationWaypoint

參數:
途經點抵達的路線點。
- (void) navigatorDidChangeRoute: (GMSNavigator *) 導航裝置 [optional]

當目前的路線變更或清除時,會呼叫此方法。

請注意,這個事件監聽器提供多種觸發條件,包括但不限於:

  • 更新進行中的行程
  • 駕駛與目前路線無關
  • 驅動程式從 UI 中選取替代路徑
  • 獲得或需要採用更佳路線的駕駛員
  • 司機已開始導航到目的地 (透過呼叫 setDestinations)
  • 駕駛人抵達上一個路線點後,已開始導航到新的路線控點
  • 路線已清除 (透過呼叫 clearDestinations)
- (void) 導覽器: (GMSNavigator *) 導航裝置
doUpdateRemainingTime: (NSTimeInterval) time
[optional]

在預計抵達目的地的時間更新時呼叫。

參數:
時間到下一個目的地的時間。
- (void) 導覽器: (GMSNavigator *) 導航裝置
doUpdateRemainingDistance: (CLLocationDistance) distance
[optional]

在預估前往目的地的距離更新時呼叫。

參數:
距離到下一個目的地的距離。
- (void) 導覽器: (GMSNavigator *) 導航裝置
doUpdateDelayCategory: (GMSNavigationDelayCategory) delayCategory
[optional]

在更新目的地的延遲時間類別時,會呼叫此方法。

參數:
delayCategory到下一個目的地的誤點類別。
- (void) 導覽器: (GMSNavigator *) 導航裝置
hasChangeSuggestedLightingMode: (GMSNavigationLightingMode) lightingMode
[optional]

在預估亮度條件更新時呼叫,例如夜晚落在裝置目前的位置。

參數:
lightingMode符合目前亮度條件的建議色彩模式。
- (void) 導覽器: (GMSNavigator *) 導航裝置
doUpdateSpeedingPercentage: (CGFloat) percentageAboveLimit
[optional]

通知您駕駛人員超出指定百分比的速限。

參數:
導航工具GMSNavigator - 回報速度過快的方法。
percentageAboveLimit超過駕駛目前行駛速限的百分比。駕駛人沒有加速時,請設為 0。當速限或目前速度無效時,請設為 -1。
- (void) 導覽器: (GMSNavigator *) 導航裝置
doUpdateSpeedAlertSeverity: (GMSNavigationSpeedAlertSeverity) speedAlertSeverity
減速百分比: (CGFloat) percentageAboveLimit
[optional]

通知您裝置偵測到車輛超出指定百分比的速限,以及目前的速限快訊嚴重程度。

只要有有效的速度或速限更新,系統就會定期呼叫此方法。駕駛人移動時,在導航期間經常通話。

參數:
導航工具GMSNavigator - 回報速度過快的方法。
speedAlertSeverity目前速度快訊的嚴重性。如果速限不明或速度無效,請設為 GMSNavigationSpeedAlertSeverityUnknown。當駕駛人未依據 GMSNavigationSpeedAlertOptions 中設定的門檻時,設為 GMSNavigationSpeedAlertSeverityNotSpeeding。駕駛人速度會根據設定的閾值,設為 GMSNavigationSpeedAlertSeverityMinorGMSNavigationSpeedAlertSeverityMajor
percentageAboveLimit超過駕駛目前行駛速限的百分比。只有在 speedAlertSeverity 是輕微或重大時,才適用此值。
- (void) 導覽器: (GMSNavigator *) 導航裝置
AndUpdateNavInfo: (GMSNavigationNavInfo *) navInfo
[optional]

在目前的 GMSNavigationNavInfo 更新時呼叫。

在導航期間,系統會定期呼叫這個方法。

參數:
navInfo更新後的 GMSNavigationNavInfo