<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
。駕駛人速度會根據設定的閾值,設為GMSNavigationSpeedAlertSeverityMinor
或GMSNavigationSpeedAlertSeverityMajor
。percentageAboveLimit 超過駕駛目前行駛速限的百分比。只有在 speedAlertSeverity 是輕微或重大時,才適用此值。
- (void) 導覽器: | (GMSNavigator *) | 導航裝置 | |
AndUpdateNavInfo: | (GMSNavigationNavInfo *) | navInfo | |
[optional] |