开始

通过集成 Navigation SDK for Android，您的应用不仅可以链接到外部地图视图，还可以实现更多功能。借助 Google 地图导航功能，您的应用可以提供关于驾驶员行程数据的动态检索和单一视图报告。

本指南将介绍 Android Studio 项目、如何集成 Navigation SDK 以及如何运行 SDK 随附的演示版应用。

Navigation SDK 是一个静态库 (.aar)，可让您控制应用中导航的外观和音频。如需详细了解该库，请在单独的窗口中打开 Navigation SDK 参考文档 (Javadoc)。

准备工作

如需开始使用 Navigation SDK for Android，请确保具备以下各项：

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

    • 为与 Navigation SDK 搭配使用而预配的 API 密钥。 您需要提供 projectID，您可以在 Google Cloud Console 主信息中心的项目名称下找到该 ID。

    • ZIP 文件，其中包含：

      • libs/ 目录中的静态库文件 .aar，其中包含以 aar 软件包形式提供的 Navigation SDK。
      • 用于许可的文本文件以及指向使用条款和协议的链接。
      • 一个要在 Android Studio 中作为新项目导入的演示版应用。应用的文件，用于在 Android Studio 中使用 Gradle 和 Maven 构建演示版应用。

  • Android Studio：使用 Navigation SDK 构建应用的推荐开发环境。本文档面向熟悉 Android 开发和面向对象编程概念的人员。您还应该从用户的角度熟悉 Google 地图。

获取 SDK、演示版应用和文档

下载并解压缩 SDK 文件后，您可以检查并运行演示版应用。

该演示版应用提供了一个实现 NavigationFragment 类的 build 和一个实现 NavigationView 类的变体。NavigationFragment 变体默认运行，并显示导航路径，如下图所示。

  1. 使用您喜爱的文件管理器转到 SDK 文件所在的目录。

  2. 将 Navigation SDK 库复制到 demo 项目的 app/libs 目录中：

    例如，您可以在 Linux 终端中运行 cp libs/*.aar demo/app/libs。

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

  4. 打开应用的 AndroidManifest.xml 并更新 API_KEY 属性的值：

    <?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.navigationapidemo" >

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/_AppTheme" >

        <meta-data
            android:name="com.google.android.geo.API_KEY"
            android:value="YOUR_API_KEY"/>
    </application>
</manifest>

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

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

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

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

运行应用

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

    • Android 设备：请参阅相关instructions，在您的 Android 设备上启用开发者选项，并配置您的系统，使之检测该设备。
    • 模拟器：使用 Android 虚拟设备 (AVD) 管理器配置虚拟设备。选择模拟器时，请务必选择一个包含 Google API 的映像。

  2. 在 Android Studio 中，点击 Run 菜单选项（或 Play 按钮图标）；然后选择一个部署目标。

  3. 在 Navigation Demo 应用中，选择 Set Destination，然后按照提示选择一个位置并启动模拟导航。

构建 View 变体

演示版应用包含 View 变体。

  1. 在 Android Studio 中，打开演示版应用，然后点击“Build”窗口的“Build Variants”标签页。

  2. 在 Build Variants 窗口中，选择 viewDebug，文件列表随即发生变化。

  3. 查看 NavigationView 类的 SDK 实现详情。

    • 在 NavViewActivity.java 中，记下实现代码。

    • 在 Activity_Nav_View.xml 中，请注意布局设计和文本。

  4. 构建并运行应用。应用名称会发生变化，以指示构建的是哪个版本。否则，只有渲染对象有所不同。

下一步

将 Navigation SDK for Android 集成到您自己的应用中。