通过集成 Navigation SDK for Android，您的应用不仅可以链接到外部地图视图，借助 Google 地图导航，您的应用可以提供关于驾驶员行程数据的动态检索和一次性报告。
本指南将向您展示一个 Android Studio 项目，向您展示如何集成 Navigation SDK，以及如何运行演示版应用。
Navigation SDK 是一个静态库，可让您控制应用中导航的外观和音频。如需详细了解该库，请在单独的窗口中打开 Navigation SDK 参考文档 (Javadoc)。
准备工作
如需开始使用 Navigation SDK，请务必具备以下各项。
Google Maps Platform 代表，申请以下服务：
- 已配置用于 Navigation SDK 的 API 密钥。您需要提供 projectID，您可以在 Google Cloud 控制台主信息中心内的项目名称下找到该 ID。
- SDK 工件。确保您的项目已配置为将 Maven 用于 Navigation SDK。
- 对于使用 v4.99.0 及更低版本的项目。如果您无法使用 Maven，可以从共享的 Google 云端硬盘下载压缩的工件。静态库文件是
libs/目录中包含 Navigation SDK 的 .aar 文件，作为 AAR 软件包。 - 一个或多个演示版应用。
Android Studio，它是使用 Navigation SDK 构建应用的推荐开发环境。
本文档面向熟悉 Android 开发和面向对象编程概念的人员。此外，您还应该从用户的角度熟悉 Google 地图。
获取演示版应用
除了 Google Maps API 之外，Google 还提供了两款应用来帮助您了解 Navigation SDK 的功能，具体取决于您的经验水平。熟悉 Google Maps API 的开发者可以将注意力集中在 GoogleNavigation 演示版上。刚接触这两个项目的开发者会发现这两个应用都很实用。
从 Navigation SDK for Android v4.1 开始，共享的 Google 云端硬盘中都可以下载以下演示版应用。
GoogleNavigation 演示：展示了 API 行为和视图的集成，因为它们与在引导式导航会话中的用户体验相关。
GoogleMap 演示：展示了
GoogleMap界面的各项行为，用于自定义地图的外观和呈现效果。
有关使用 Maven 的注意事项
演示版应用配置为使用 Gradle 中的 Artifact Registry 插件，从远程 Maven 制品库下载 SDK 工件。请务必按照项目配置说明获取对 SDK 的访问权限。
GoogleNavigation 演示
最新的 GoogleNavigation 演示可在共享 Google 云端硬盘的根目录下找到。应用的先前版本存在于“归档”中。对于 4.1 之前的版本，应用将与 AAR 捆绑在同一个 ZIP 文件中。
楼宇
在 Android Studio 中，导入演示版应用并允许 Gradle 运行。
打开
local.defaults.properties并更新MAPS_API_KEY属性的值：MAPS_API_KEY=YOUR_API_KEY点击 build 并检查 SDK 实现详情。
在 Java 类中，记下实现代码。
在布局 XML 中，请注意布局设计和文本。
在
build.gradle文件中，记下依赖项中的 SDK。
如需详细了解如何将 API 密钥添加到清单中，请参阅 Secrets Gradle 插件文档。
正在计时
将 Android 设备连接到计算机或使用模拟器。
- Android 设备 - 请参阅相关instructions，了解如何在 Android 设备上启用开发者选项，并配置您的系统，使之检测该设备。
- 模拟器：使用 Android 虚拟设备 (AVD) 管理器配置一个虚拟设备。选择模拟器时，请务必选择一个包含 Google API 的映像。
在 Android Studio 中，点击 Run 菜单选项（或 Play 按钮图标）；然后选择一个部署目标。
在构建和启动时，应用会向用户显示包含选项列表的着陆页。
NavViewActivity 和 NavFragmentActivity 选项
NavSDK 的新采用者可能会发现这两个选项最有用。
选项 1：NavViewActivity 展示了将 NavigationView 与 Navigator 结合使用的行为。
选项 2：第二个选项名为 NavFragmentActivity，展示了使用 SupportNavigationFragment 和 Navigator 的行为。
点击其中某个选项后，您会看到以下内容：
- 导航界面
- 应用菜单中的“Set Destination”按钮
- 您可以与之交互以动态调用 API 上的方法的叠加层
- 包含更多选项的菜单
首先，请点击设置目的地，然后选择一个地址。然后，该应用会模拟从您当前所在位置到相应地址的行程。您可以使用控制面板叠加层来查看调用 API 时会发生什么情况。例如，您可以点击 View Methods（查看方法），尝试强制 SDK 进入夜间模式以查看其外观。
SwappingMapAndNavActivity 选项
SwappingMapAndNavActivity 展示了以下常见模式：
- 显示
MapView - 在导航开始时切换到
NavigationView - 在导航结束时返回到
MapView
GoogleMap 演示
最新的 GoogleNavigation 演示可在共享 Google 云端硬盘的根目录下找到。应用的先前版本存在于“归档”中。
楼宇
在 Android Studio 中，导入演示版应用并允许 Gradle 运行。
打开
local.defaults.properties并更新MAPS_API_KEY属性的值：MAPS_API_KEY=YOUR_API_KEY点击 build 并检查 SDK 实现详情。
在 Java 类中，记下实现代码。
在布局 XML 中，请注意布局设计和文本。
在
build.gradle文件中，记下依赖项中的 SDK。
如需详细了解如何将 API 密钥添加到清单，请参阅 Secrets Gradle 插件。
正在计时
将 Android 设备连接到计算机或使用模拟器。
- Android 设备：请参阅相关instructions，了解如何在 Android 设备上启用开发者选项，并配置您的系统，使之检测该设备。
- 模拟器：使用 Android 虚拟设备 (AVD) 管理器配置一个虚拟设备。选择模拟器时，请务必选择一个包含 Google API 的映像。
在 Android Studio 中，点击 Run 菜单选项（或 Play 按钮图标），然后选择一个部署目标。
在构建和启动时，应用会向用户显示包含演示列表的着陆页。
使用 Google Maps SDK 演示的用户应熟悉这种演示模式和源代码的相应结构。这是因为 GoogleMap 演示的设计与 Maps API 演示应用类似。主要区别在于，导航 SDK 演示支持用户选择要在 NavigationView 或 MapView（如果适用）上测试和运行演示的视图类。
Google 通常建议采用者使用 NavigationView。通过该演示，您可以灵活地在我们的演示版应用中的两个版本上尝试这些行为，并选择适合您的方法。例如，如果您使用的是预期与该类交互的第三方库，可能仍然需要使用 MapView。