總覽

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) 通常可讓您停用或啟用穿戴式應用程式的微光模式。此外，MapView 和 MapFragment 中有 onEnterAmbient 和 onExitAmbient 方法，但呼叫時不會產生任何影響。如果是穿戴式裝置，請改用TBT 動態饋給。

其他 API

僅供 Mobility Services 客戶使用的 API

Navigation SDK 中有幾個 API 僅供車輛調度管理服務客戶使用，Google 會按交易次數向這些客戶收費。如果您不是 Mobility Services 客戶，下列方法不會執行任何操作：