Navigation SDK for Android 可為 Maps SDK for Android 新增導航功能。如果採用 Google 地圖技術的 Android 應用程式需要導航功能,則必須使用 Android 版 Navigation SDK。
不過,Maps SDK for Android 中的大多數函式在 Navigation SDK for Android 中也會有相同的行為。無論您使用哪個 SDK 依附元件,都可以使用相同的 com.google.android.gms.maps
套件存取這些元件。也就是說,如果您的應用程式先前依附於 Maps SDK for Android,您可以將其依附元件變更為 Navigation SDK for Android,而不會影響應用程式現有的功能,但有兩個例外狀況:
- 擲回例外狀況的 API。
- 在 NavSDK 中無法運作的 API,且在呼叫時不會產生任何影響。
這些例外狀況的說明如下。
擲回例外狀況的 API
如果應用程式啟用下列函式,則會擲回例外狀況:
在 Navigation SDK 中沒有任何功能的 API
下列 API 在 Navigation SDK 中不含功能,但如果程式碼呼叫了這些 API,也不會受到影響。這些類別包括:
- 穿戴式裝置活動的 API。
- 如果您想在 Navigation SDK for Android 中使用這項功能,請改為啟用 TBT 動態饋給。
- 其他 API。
穿戴式裝置適用的 API
GoogleMapOptions.ambientEnabled(boolean enabled) 通常可讓您針對穿戴式應用程式停用或啟用微光模式。此外,onEnterAmbient 和 onExitAmbient 方法會出現在 MapView 和 MapFragment 中,但在呼叫時不會產生任何影響。如果你使用的是穿戴式裝置,請改用 TBT 動態饋給。
其他 API
- 設定自訂 LocationSource 不會在 NavSDK 中執行任何操作。
- 所有 MapsInitializer API。
- RuntimeRemoteException。
僅供行動性服務客戶使用的 API
Navigation SDK 中有幾個 API 僅供Mobility Services 客戶使用,Google 會根據每筆交易向他們收費。如果您不是行動管理服務的客戶,則以下為免人工管理的方法: