概览

Navigation SDK for Android 可为 Maps SDK for Android 添加导航功能。如果您的 Android 应用依托 Google 地图，并且需要导航功能，则必须依赖于 Navigation SDK for Android。

不过，Maps SDK for Android 中的大多数函数在 Navigation SDK for Android 中也会以相同的方式运行。无论您使用哪个 SDK 依赖项，都可以使用相同的 com.google.android.gms.maps 软件包访问它们。这意味着，如果您的应用之前依赖于 Android 版 Google 地图 SDK，您可以将其依赖项更改为 Android 版 Navigation SDK，而不会影响应用的现有功能，但有两个值得注意的例外情况：

  • 会抛出异常的 API。
  • 在 NavSDK 中不起作用且调用时没有影响的 API。

这些例外情况如下所述。

抛出异常的 API

如果您的应用启用该功能，以下函数会抛出异常：

导航 SDK 中没有任何功能的 API

以下 API 在 Navigation SDK 中没有任何功能，但如果您的代码调用它们，也不会产生任何影响。它们分为以下几类：

  • 适用于穿戴式活动的 API。
    • 如果您希望在 Navigation SDK for Android 中使用此功能，请改为启用 TBT Feed。
  • 其他 API。

适用于穿戴式设备的 API

通常，您可以使用 GoogleMapOptions.ambientEnabled(boolean enabled) 为穿戴式应用停用或启用氛围模式。此外，MapView 和 MapFragment 中存在 onEnterAmbient 和 onExitAmbient 方法，但调用时没有任何影响。对于穿戴式设备，请改用回忆 Feed。

其他 API

仅供 Mobility Services 客户使用的 API

Navigation SDK 中有一些 API 仅供移动出行服务客户使用，Google 会按交易向这些客户收费。如果您不是移动流量服务客户，则以下方法无效：