立即試用

整合 Navigation SDK for Android 後,應用程式不只可以連結, 進入外部地圖檢視透過 Google 地圖導航,您的應用程式可以提供 用來擷取使用者歷程的單層式報表。本指南 說明如何執行 Navigation SDK 試用版應用程式 GitHub 提供許多資源。

事前準備

如要開始使用 Navigation SDK,請務必 下列項目。

  • Google 地圖平台代表,可存取下列項目:

    • 佈建的 API 金鑰 Navigation SDK。您需要提供 請前往 Google Cloud 控制台主資訊主頁 。
    • SDK 構件。確認您的專案已設定 才能使用適用於 Navigation SDK 的 Maven
    • 適用於使用 4.99.0 以下版本的專案。如果無法使用 Maven 可以從共用 Google 雲端硬碟下載壓縮的成果。靜態資料庫檔案是 包含 Navigation SDK 的 libs/ 目錄 作為 AAR 套裝組合
    • 一或多個試用版應用程式
    • Android Studio:建議使用的開發環境來建立應用程式 搭配 Navigation SDK

本說明文件的適用對象為熟悉 Android 開發作業及 物件導向程式設計概念此外,您也應該熟悉 Google 從使用者的角度進入地圖。

取得試用版應用程式

Google 提供兩種應用程式 Navigation SDK 整合在 Google Maps API (視您的經驗等級而定)。 熟悉 Google Maps API 的開發人員 可以將重點放在 GoogleNavigation 示範上新加入這兩種類型的開發人員 Google Cloud 專案將可派上用場

從 Android 適用的 Navigation SDK 4.1 版開始,下列試用版應用程式 前往 GitHub 下載這些項目。

  • GoogleNavigation 示範:展示 API 行為的整合 這類檢視方式與使用者體驗相關 工作階段

  • Google 地圖示範:展示 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 外掛程式

執行中

  1. 將 Android 裝置連接至電腦或使用模擬器。

    • Android 裝置:請參閱 請參閱操作說明 在 Android 裝置上啟用開發人員選項並設定系統 ,藉此偵測裝置。
    • 模擬器mdash;使用 Android 虛擬裝置 (AVD) 管理員: 設定虛擬裝置選擇模擬器時 挑選包含 Google API 的映像檔
  2. 在「Android Studio」中,按一下「Run」選單選項 (或播放按鈕) icon);然後選擇部署目標

應用程式建構和啟動時,會顯示一個清單的到達網頁

剛開始採用 NavSDK 時,這兩個選項可能會 很實用

選項 1NavViewActivity 使用 NavigationView 顯示行為 配合 Navigator

選項 2:第二個選項,名稱為 NavFragmentActivity 和展示 定義 SupportNavigationFragment 旁邊的 Navigator

當您按下其中一個選項時,會看到下列選項:

  • 導覽 UI
  • 「設定目的地」應用程式選單中的按鈕
  • 可以與其互動,進而以動態方式叫用 API
  • 含有更多選項的溢位選單

首先,請按一下「設定目的地」並選擇地址。接著 模擬從目前位置到該地址的行程。使用控制項 面板會重疊顯示,方便您查看呼叫 API 時的結果。舉例來說,您可以 請按一下「View Methods」,嘗試強制讓 SDK 進入夜間模式,以便查看 就像這樣

SwappingMapAndNavActivity 選項

SwappingMapAndNavActivity 展示的常見模式如下:

Google 地圖示範

您可以在 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」選單選項 (或播放按鈕) icon);然後選擇部署目標

應用程式建構和啟動時,會顯示一個清單的到達網頁 示範

此呈現模式和原始碼的對應結構 應該對 Google Maps SDK 示範使用者熟悉這是因為 Google 地圖示範與 Maps API 示範十分類似 app。主要 差別在於 Navigation SDK 示範可讓使用者選擇 他們想要測試以下項目: NavigationViewMapView, 視情況而定。

Google 通常會鼓勵採用者 NavigationView。 這項示範可讓使用者靈活地在 選出最適合你的選擇舉例來說, 在使用第三方的情況下,需要使用 MapView 預期能與該類別互動的程式庫。