本頁說明要求及管理背景位置資訊使用權限的最佳做法。
要求「一律允許」位置存取權
自 Android 14 起,應用程式必須具備 ACCESS_BACKGROUND_LOCATION 權限,才能存取使用者位置資訊。Navigation SDK 的資訊清單檔案包含這項權限,因此您不需要明確要求 (除非有其他用途),因為 Gradle 資訊清單合併工具會確保這項權限與應用程式的資訊清單合併。
不過,只有 ACCESS_BACKGROUND_LOCATION 權限並不足以在背景存取位置資訊,因此建議您向使用者要求「一律允許」位置存取權。這可確保應用程式能在背景執行並顯示通知,在導航期間盡可能提高定位精確度。
提示應向使用者說明,授予權限後,應用程式在背景執行時,定位精確度和導航體驗會有所提升。
如要進一步瞭解如何提示使用者授予位置存取權,請參閱 Android 開發人員說明文件中的「要求位置存取權 | 感應器和位置 | Android 開發人員」。
確實清除導航通知
為確保應用程式不會在通知不再需要時仍保留通知,請務必執行下列清除步驟:
- 叫用
startGuidance()後,請務必叫用stopGuidance()或clearDestination()。 - 註冊
ArrivalListener後,請務必取消註冊。 - 註冊
RoadSnappedLocationProvider後,請務必取消註冊。
完成這些步驟後,系統就不會在不需要時保留通知,避免電池耗電和記憶體流失。
重新叫用 NavigationApi#initForegroundServiceManager 方法時,請先叫用 NavigationApi#clearForegroundServiceManager
如果應用程式使用 ForegroundServiceManager,請先叫用 NavigationApi#clearForegroundServiceManager,再叫用 NavigationApi#initForegroundServiceManagerProvider。如果已初始化 ForegroundServiceManager,請叫用 NavigationApi#initForegroundServiceManagerMessageAndIntent。初始化前景服務管理工具後,您可以執行這項操作,更新通知 ID 或通知內容。
Android 14 導入的新限制
Android 14 (Android U) 對應用程式在背景存取使用者位置資訊,導入了新的限制。為因應這些異動,Navigation SDK 已在 5.4.0 版更新,以便更妥善管理背景位置資訊存取權。我們也建議您更新實作方式,確保應用程式能繼續存取最精確的位置資料。
Android 14 異動對 Navigation SDK 的影響
在應用程式中叫用 startGuidance() 時,前景服務會開始顯示即時路況導航的使用者通知。即時路況導航必須能夠存取使用者位置,才能更新路線並顯示正確的視覺和語音導引。自 Android 14 起,在背景存取使用者的精確位置資訊,必須取得使用者權限。根據預設,如果應用程式沒有使用者授予的背景位置資訊存取權,卻嘗試啟動前景服務來更新位置資訊,系統會擲回 SecurityException,導致應用程式停止運作。
Navigation SDK 如何緩解這個問題
從 5.4.0 版開始,Navigation SDK 會處理 SecurityException,不會影響應用程式,導航功能也能繼續在背景執行。此外,Navigation SDK 的 AndroidManifest 包含 ACCESS_BACKGROUND_LOCATION 權限。這樣一來,應用程式就不需要自行宣告權限,因為 Gradle 合併會處理這項作業。不過,如果應用程式進入背景前未向使用者顯示通知,Navigation SDK 會依賴系統提供位置更新。這些系統更新可能不頻繁或不精確,導致導航體驗不佳。因此,建議您也提示使用者授予背景位置資訊存取權。
應用程式開發人員如何提高導航定位精確度
您可以更新應用程式,提示使用者授予背景位置資訊存取權,提高 Navigation SDK 使用的位置訊號準確度。詳情請參閱「要求『一律允許』位置存取權」。