Navigation SDK for Android 將導航功能新增至 Maps SDK for Android。如果採用 Google 地圖技術的 Android 應用程式需要導航功能,則必須依附於 Android 版 Navigation SDK。
也就是說,Maps SDK for Android 中大多數函式的行為在 Android 版 Navigation SDK 中的運作方式相同。無論使用何種 SDK 依附元件,您都可以使用相同的 com.google.android.gms.maps
套件存取這些 SDK。也就是說,如果您的應用程式先前依附於 Maps SDK for Android,您可以將依附元件變更為 Navigation SDK for Android,而不影響應用程式的現有功能,但有以下兩個值得注意的例外狀況:
- 擲回例外狀況的 API。
- API 不在 NavSDK 中運作,呼叫時也沒有任何影響。
以下將說明這些例外狀況。
擲回例外狀況的 API
若應用程式啟用,下列函式會擲回例外狀況:
Navigation SDK 中沒有功能的 API
下列 API 在 Navigation SDK 中沒有功能,但如果程式碼呼叫這些 API,則不會產生任何影響。這些參數分為以下幾類:
- 穿戴式裝置活動的 API。
- 若想在 Android 版 Navigation SDK 中使用這項功能,請啟用 TBT 動態饋給。
- 其他 API。
穿戴式裝置適用的 API
GoogleMapOptions.ambientEnabled(boolean enabled) 通常會允許您針對穿戴式應用程式停用或啟用微光模式。此外,MapView 和 MapFragment 中已有 onEnterAmbient 和 onExitAmbient 方法,但呼叫時不會影響。如果是穿戴式裝置,請改用 TBT 動態消息。
其他 API
- 設定自訂 LocationSource 在 NavSDK 中不會執行任何動作。
- 所有 MapsInitializer API。
- RuntimeRemoteException。