体验演示版

通过集成 Navigation SDK for Android，您的应用可以不再局限于链接 外部地图视图借助 Google 地图导航，您的应用可以提供动态 检索用户转化历程的相关数据并生成一览式报告。本指南 介绍了如何运行 Navigation SDK 演示版应用，其中 均可在 GitHub 上找到。

注意 ：Navigation SDK 目前仅适用于部分客户， 必须启用 SDK 才能运行演示 API。如需更多信息 与销售人员联系。

准备工作

重要提示 ：从 Navigation SDK for Android v3.0 开始，您可以获取 最新版本的 Navigation SDK for Android。 现在，这是获取 SDK 的首选方法。如需了解详情，请参阅 设置您的 项目。

如需开始使用 Navigation SDK，请确保 以下项。

• 有权访问以下内容的 Google Maps Platform 代表：

  • 配置用于以下 API 的 API 密钥： Navigation SDK。您需要提供 projectID，您可以在 Google Cloud 控制台的主信息中心找到 （位于项目名称下方）。
  • SDK 工件。确保您的项目已配置 使用 Maven 作为 Navigation SDK。
  • 对于使用 v4.99.0 及更低版本的项目。如果您无法使用 Maven， 可以从共享的 Google 云端硬盘下载压缩的工件。静态库文件是 包含 Navigation SDK 的 libs/ 目录 以 AAR 软件包。
  • 一个或多个演示版应用。
  • Android Studio - 构建应用时推荐使用的开发环境 导航 SDK。

本文档面向熟悉 Android 开发和 面向对象的编程概念。您还应熟悉 Google 从用户角度使用地图。

注意 ：如果您的应用已在使用 Maps SDK， Navigation SDK 取代了用于地图图层和导航的 Maps SDK 功能。您不能在同一个应用中使用 Navigation SDK 和 Maps SDK。

下载演示版应用

Google 提供了两款应用来帮助您了解 Navigation SDK 提供了 Google Maps API，具体取决于您的经验水平。 熟悉 Google Maps API 的开发者 可以将注意力集中在 GoogleNavigation 演示上。刚开始接触这两种工具的开发者 会觉得这两款应用都很有用。

从 Navigation SDK for Android v4.1 开始，以下演示版应用 可在 GitHub 上下载。

• GoogleNavigation 演示：展示 API 行为和 与用户在引导式导航中获得的体验相关 会话。

• GoogleMap 演示：展示 GoogleMap 的各个行为 界面，用于自定义地图的风格和呈现方式。

关于使用 Maven 的注意事项

演示应用已配置为从远程 Maven 下载 SDK 工件 使用 Gradle 中的 Artifact Registry 插件。请务必遵循 项目配置说明 获得对 SDK 的访问权限

注意 ：对于 4.99.0 及更低版本，如果您仍想使用原始 AAR bundle，您可以在libs下的项目 目录。然后，您需要移除对 artifactregistry 的所有引用 插件和相应的远程仓库，并声明以下 AAR 依赖项，在您的应用级 build.gradle 中：api(name: 'google_navigation', ext: “aar”）

GoogleNavigation 演示

GitHub 上提供了最新的 GoogleNavigation 演示。

建筑物

1. 在 Android Studio 中，导入演示版应用并允许 Gradle 运行。

   注意 ：在您更新地图之前，应用无法加载地图 local.defaults.properties 替换为预配的 API 密钥。

2. 打开 local.defaults.properties 并更新 MAPS_API_KEY 的值 属性：

     MAPS_API_KEY=YOUR_API_KEY
   

3. 点击 build 并检查 SDK 实现详情。

   • 在 Java 类中，记下实现代码。

   • 在布局 XML 中，请注意布局设计和文本。

   • 在 build.gradle 文件中，记下依赖项中的 SDK。

请参阅 Secrets Gradle 插件 文档，详细了解如何将 API 密钥添加到清单中。

正在运行

1. 将 Android 设备连接到您的计算机或使用模拟器。

   • Android 设备：请参阅 说明 在您的 Android 设备上启用开发者选项并配置系统 来检测设备。
   • Emulatormdash;使用 Android 虚拟设备 (AVD) 经理 配置虚拟设备选择模拟器时，请确保 选择一个包含 Google API 的映像。

2. 在 Android Studio 中，点击 Run 菜单选项（或 Play 按钮 icon);然后选择部署目标

构建和启动后，应用会向用户显示一个列表的着陆页 选项。

NavViewActivity 和 NavFragmentActivity 选项

NavSDK 的新采用者很可能会发现这两个选项 实用。

选项 1：NavViewActivity 展示使用 NavigationView 的行为 与 Navigator。

选项 2：第二个选项的标题为“NavFragmentActivity”，展示 使用 SupportNavigationFragment 旁边 Navigator。

点击其中某个选项后，您将看到以下内容：

• 导航界面
• “设置目的地”应用菜单中的按钮
• 可以与之交互以动态调用 API
• 包含更多选项的菜单

首先，请点击设置目的地，然后选择一个地址。然后 模拟从您当前所在位置到该地址的行程。使用控件 面板叠加，看看调用 API 时会发生什么。例如，您可以 点击 View Methods，尝试将 SDK 强制进入夜间模式以查看它 看起来

SwappingMapAndNavActivity 选项

注意 ：此选项可帮助您从 v1 过渡到 v4。我们建议 尽可能完全使用 NavigationView，但应以 展示如何使用这两种工具。

SwappingMapAndNavActivity 展示了以下常见模式：

• 显示 MapView
• 切换到 NavigationView 导航开始时
• 返回到 MapView 导航结束时

GoogleMap 演示

注意 ：此应用不适用于 v4.1 之前的 SDK 版本。

GitHub 上提供了最新的 GoogleNavigation 演示。

建筑物

1. 在 Android Studio 中，导入演示版应用并允许 Gradle 运行。

   注意 ：在您更新地图之前，应用将无法加载地图 local.defaults.properties。

2. 打开 local.defaults.properties 并更新 MAPS_API_KEY 的值 属性：

     MAPS_API_KEY=YOUR_API_KEY
   

3. 点击 build 并检查 SDK 实现详情。

   • 在 Java 类中，记下实现代码。

   • 在布局 XML 中，请注意布局设计和文本。

   • 在 build.gradle 文件中，记下依赖项中的 SDK。

请参阅密钥 Gradle 插件 详细了解如何向清单添加 API 密钥。

正在运行

1. 将 Android 设备连接到您的计算机或使用模拟器。

   • Android 设备：请参阅 说明 在您的 Android 设备上启用开发者选项，并配置 来检测设备。
   • 模拟器 - 使用 Android 虚拟设备 (AVD) 经理 来配置虚拟设备选择模拟器时，请确保 选择一个包含 Google API 的映像

2. 在 Android Studio 中，点击 Run 菜单选项（或 Play 按钮 icon);然后选择部署目标

构建和启动后，应用会向用户显示一个列表的着陆页 演示。

此表示模式和相应的源代码结构 Google Maps SDK 演示的用户应该对此非常熟悉。这是因为 GoogleMap 演示的设计与 Maps API 演示类似 app。主 不同之处在于，Navigation SDK 演示可让用户选择 想要测试运行演示的对象： NavigationView 或 MapView, 。

Google 通常鼓励采用 NavigationView。 此演示可让您灵活地在 我们的演示版应用，选择适合您的方案。例如，它可能仍然是 在使用第三方服务的情况下使用 MapView 预期与该类进行交互的库。

重要提示 ： MapView, MapFragment 和 SupportMapFragment 类要求设备具有 Google Play 服务应用 已安装。如果您启动全新的模拟器，或将非常旧的设备恢复出厂设置， Android 映像可能预安装了非常陈旧的 Google Play 服务。 在这种情况下，您必须等待系统自动拉取更新的版本 或通过 Google Play 商店手动更新 Play 服务。