立即試用

整合 Android 適用的 Navigation SDK 後，應用程式不只可以連結至外部地圖檢視畫面，藉由使用 Google 地圖導航，應用程式可針對使用者旅程提供動態擷取和單樣資料報表。本指南說明如何執行 GitHub 提供的 Navigation SDK 試用版應用程式。

注意： Navigation SDK 目前僅供特定客戶使用，您必須啟用 SDK 才能執行示範 Aps。詳情請聯絡銷售人員。

事前準備

重要事項： 自 Android 適用的 Navigation SDK 3.0 版起，您可以從 Maven 存放區取得最新版 Navigation SDK for Android。現在，建議您使用這個方法取得 SDK。詳情請參閱「設定專案」一文。

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

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

  • 佈建搭配 Navigation SDK 使用的 API 金鑰。您必須提供專案 ID，可以在 Google Cloud 控制台主資訊主頁的專案名稱底下找到。
  • SDK 構件。確認您的專案已設為針對 Navigation SDK 使用 Maven。
  • 適用於使用 4.99.0 以下版本的專案。如果無法使用 Maven，則可從共用的 Google 雲端硬碟下載壓縮的成果。靜態資料庫檔案是 libs/ 目錄中的 .aar，其中包含 Navigation SDK 做為 AAR 套件。
  • 一或多個試用版應用程式。
  • Android Studio：建議使用 Navigation SDK 建構應用程式的建議開發環境。

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

注意： 如果您的應用程式已使用 Maps SDK，則 Navigation SDK 會取代地圖圖層和導航功能適用的 Maps SDK。您無法在同一應用程式中使用 Navigation SDK 和 Maps SDK。

取得試用版應用程式

Google 提供兩個應用程式，您可以根據自身經驗，提供 Google Maps API 頂層的 Navigation SDK 功能。熟悉 Google Maps API 的開發人員可以將重點放在 GoogleNavigation 示範上。剛開始接觸這兩種專案的開發人員會覺得這兩個應用程式都很實用。

從 Android 適用的 Navigation SDK 4.1 版開始，下列示範應用程式都可在 GitHub 下載。

• GoogleNavigation 示範：在引導式導覽工作階段中，展示與使用者體驗相關的 API 行為和檢視畫面整合。

• GoogleMap 示範：展示 GoogleMap 介面的個別行為，以自訂地圖的風格和呈現方式。

Maven 使用注意事項

示範應用程式已設為使用 Gradle 中的 Artifact Registry 外掛程式，從遠端 Maven 存放區下載 SDK 構件。請務必按照專案設定操作說明操作，取得 SDK 的存取權。

注意： 如果是 4.99.0 以下版本，若您仍要在專案中使用原始 AAR 套件，可將其新增至 libs 目錄下的專案。接著，您必須移除對 artifactregistry 外掛程式和個別遠端存放區的所有參照，並在應用程式層級的 build.gradle 中宣告下列 AAR 依附元件：api(name: 'google_navigation', ext: 'aar')

GoogleNavigation 示範

您可以在 GitHub 上取得最新的 GoogleNavigation 示範。

建立中

1. 在 Android Studio 中匯入試用版應用程式，並允許 Gradle 執行。

   注意： 您必須先使用佈建的 API 金鑰更新 local.defaults.properties，應用程式才能載入地圖。

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 裝置：請參閱instructions，在 Android 裝置上啟用開發人員選項，並設定系統來偵測裝置。
   • 「Emulator」mdash；請使用 Android 虛擬裝置管理工具 (AVD Manager) 來設定虛擬裝置。選擇模擬器時，請務必挑選包含 Google API 的映像檔。

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

建構和啟動時，應用程式向使用者顯示的到達網頁會列出選項。

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 執行。

   注意： 您必須先使用佈建的 API 金鑰更新 local.defaults.properties，應用程式才能載入地圖。

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 裝置請參閱instructions，在 Android 裝置上啟用開發人員選項，並設定系統來偵測裝置。
   • 模擬器：使用 Android 虛擬裝置管理工具 (AVD Manager) 來設定虛擬裝置。選擇模擬器時，請務必挑選包含 Google API 的映像檔。

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

建構和啟動應用程式後，應用程式向使用者顯示示範清單的到達網頁。

Google Maps SDK 示範的使用者應熟悉這種呈現模式和原始碼對應的結構。這是因為 GoogleMap 示範與 Maps API 試用版應用程式類似，主要差別在於 Navigation SDK 示範可讓使用者選擇要測試哪個檢視類別 (如適用)：NavigationView 或 MapView (如適用)。

Google 通常會鼓勵採用者使用 NavigationView。這項示範讓您可以靈活地在兩個版本的試用版應用程式中嘗試這些行為，並選擇最適合您的方式。舉例來說，如果您使用的第三方程式庫會預期與該類別互動，則可能仍須使用 MapView。

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