概览

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 中没有任何功能，但如果您的代码调用它们，也不会产生任何影响。它们分为以下几类：

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

适用于穿戴式设备的 API

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

其他 API

仅供 Mobility Services 客户使用的 API

Navigation SDK 中有多个 API 仅供出行服务客户使用，Google 会按交易向这些客户收费。如果您不是 Mobility Services 客户，则以下方法不执行任何操作：