体验演示版

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

准备工作

如需开始使用 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 从用户角度使用地图。

下载演示版应用

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 的访问权限

GoogleNavigation 演示

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

建筑物

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

  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);然后选择部署目标

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

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

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

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

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

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

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

SwappingMapAndNavActivity 选项

SwappingMapAndNavActivity 展示了以下常见模式:

GoogleMap 演示

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

建筑物

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

  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 演示可让用户选择 想要测试运行演示的对象: NavigationViewMapView, 。

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