開始使用

整合 Android Navigation SDK 後，應用程式不只可以連結至外部地圖檢視畫面，有了 Google 地圖導航，您的應用程式就能提供駕駛旅程的動態擷取和單一報表資料。

本指南會提供 Android Studio 專案、如何整合 Navigation SDK，以及執行透過 SDK 提供的試用版應用程式。

Navigation SDK 是靜態程式庫 (.aar)，可讓您控制應用程式導覽的外觀和音訊。如要進一步瞭解程式庫，請在另一個視窗中開啟 Navigation SDK 參考資料 (Javadoc)。

事前準備

如要開始使用 Android 版 Navigation SDK，請務必備妥以下項目：

  • Google 地圖平台代表，可存取下列項目：

    • 佈建搭配 Navigation SDK 使用的 API 金鑰。您必須提供專案 ID，可以在 Google Cloud 控制台主資訊主頁的專案名稱底下找到。

    • ZIP 檔案，內含以下項目：

      • libs/ 目錄中的靜態資料庫檔案 .aar，內含 Navigation SDK 做為套裝組合。
      • 授權使用文字檔案，以及《使用條款》及協議的連結。
      • 可在 Android Studio 中匯入為新專案的試用版應用程式。這是應用程式的檔案，用於使用 Gradle 和 Maven 在 Android Studio 中建構試用版應用程式。

  • Android Studio：建議使用 Navigation SDK 建構應用程式的建議開發環境。本說明文件的適用對象為熟悉 Android 開發作業和物件導向程式設計概念的開發人員。此外，您也應該要從使用者的角度熟悉 Google 地圖。

取得 SDK、試用版應用程式和說明文件

下載 SDK 檔案並解壓縮後，即可檢查並執行試用版應用程式。

試用版應用程式提供實作 NavigationFragment 類別的版本，以及實作 NavigationView 類別的變化版本。根據預設，NavigationFragment 變數會執行，並顯示導覽路徑，如下圖所示。

  1. 使用您最愛的檔案管理工具前往含有 SDK 檔案的目錄。

  2. 將 Navigation SDK 程式庫複製到 demo 專案的 app/libs 目錄：

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

  3. 在「Android Studio」中，匯入「demo」應用程式，然後允許 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 裝置連接至電腦或使用模擬器。

  2. 在「Android Studio」中，按一下「Run」選單選項 (或播放按鈕圖示)，然後選擇部署目標。

  3. 在「Navigation Demo」應用程式中選擇「Set Destination」，然後按照提示選取位置並開始模擬導航。

建構檢視畫面變化版本

試用版應用程式包含 View 變化版本。

  1. 在 Android Studio 中開啟試用版應用程式，然後按一下「Build」視窗中的「Build Variants」分頁標籤。

  2. 在「Build Variants」視窗中選取「viewDebug」viewDebug，檔案清單變更。

  3. 檢查 NavigationView 類別的 SDK 實作詳細資料。

    • 在 NavViewActivity.java 中，記下實作程式碼。

    • 在 Activity_Nav_View.xml 中，請注意版面配置設計和文字。

  4. 建構並執行應用程式。應用程式名稱會變更為指出建構的版本。否則，只有轉譯物件會有所不同。

後續步驟

將 Android 版 Navigation SDK 整合到您的應用程式中。