總覽

Navigation SDK for Android 可為 Maps SDK for Android 新增導航功能。如果您採用 Google 地圖的 Android 應用程式需要導航功能，則必須依附 Navigation SDK for Android。

不過，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

僅供 Mobility Services 客戶使用的 API

Navigation SDK 中有幾個 API 僅供Mobility Services 客戶使用，Google 會根據每筆交易向他們收費。如果您不是 Mobility Services 客戶，則下列方法不會執行：