立即試用

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

注意： Navigation SDK 目前僅供特定客戶使用 必須先啟用 SDK 才能執行試用版 Aps。如需更多資訊 聯絡銷售人員。

事前準備

重要事項： 自 Android 版 Navigation SDK 3.0 起，您可以取得 從 Maven 存放區取得最新版的 Navigation SDK for Android。 現在，建議您使用這個方法取得 SDK。若需更多資訊，請參閲 設定您的 專案

。

如要開始使用 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 從使用者的角度進入地圖。

注意： 如果您的應用程式已使用 Maps SDK， Navigation SDK 取代了 Maps SDK for 地圖圖層和導航 接著介紹網際網路通訊層 包括兩項主要的安全防護功能您無法在同一應用程式中使用 Navigation SDK 和 Maps SDK。

取得試用版應用程式

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 存取權

注意： 如果是 4.99.0 以下版本，仍需使用原始 AAR 您可以在專案中新增軟體包，以新增至專案的 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 外掛程式 。

執行中

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

   • Android 裝置：請參閱 請參閱操作說明 在 Android 裝置上啟用開發人員選項並設定系統 ，藉此偵測裝置。
   • 模擬器mdash；使用 Android 虛擬裝置 (AVD) 管理員： 設定虛擬裝置選擇模擬器時 挑選包含 Google API 的映像檔

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

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

NavViewActivity 和 NavFragmentActivity 選項

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

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

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

當您按下其中一個選項時，會看到下列選項：

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

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

SwappingMapAndNavActivity 選項

注意： 這個選項可協助您從 v1 轉換為 v4。建議你 盡可能使用 NavigationView，但依此提供 瞭解如何同時使用這兩種工具

SwappingMapAndNavActivity 展示的常見模式如下：

• 顯示MapView
• 切換至 NavigationView 導航開始時
• 返回 MapView 導航結束時

Google 地圖示範

注意： 這個應用程式不適用於 4.1 版之前的 SDK。

您可以在 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。

請參閱密鑰 Gradle 外掛程式 ，進一步瞭解 API 金鑰新增至資訊清單的方式。

執行中

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

   • Android 裝置請參閱 操作說明 即可在 Android 裝置上啟用開發人員選項並設定 系統才能偵測裝置
   • 模擬器：使用 Android 虛擬裝置 (AVD) 管理員 設定虛擬裝置選擇模擬器時 挑選包含 Google API 的映像檔

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

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

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

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

重要事項： MapView, MapFragment 和 SupportMapFragment 需要在裝置上使用 Google Play 服務應用程式才能加入 類別 已安裝。若您啟動新的模擬器，或將舊裝置恢復原廠設定， Android 映像檔可能預先安裝了過時的 Google Play 服務。 在這種情況下，您必須等待版本自動提取較新的版本 或透過 Google Play 商店手動更新 Play 服務。