整合 Android 適用的 Navigation SDK 後,應用程式不只可以連結至外部地圖檢視畫面,藉由使用 Google 地圖導航,應用程式可針對使用者旅程提供動態擷取和單樣資料報表。本指南說明如何執行 GitHub 提供的 Navigation 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 地圖。
取得試用版應用程式
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 的存取權。
GoogleNavigation 示範
您可以在 GitHub 上取得最新的 GoogleNavigation 示範。
建立中
在 Android Studio 中匯入試用版應用程式,並允許 Gradle 執行。
開啟
local.defaults.properties
並更新MAPS_API_KEY
屬性的值:MAPS_API_KEY=YOUR_API_KEY
按一下「build」,然後檢查 SDK 實作詳細資料。
在 Java 類別中,記下實作程式碼。
在版面配置 XML 中,留意版面配置設計和文字。
在
build.gradle
檔案中,記下依附元件中的 SDK。
請參閱「Secrets Gradle 外掛程式」說明文件,進一步瞭解如何將 API 金鑰新增至資訊清單。
執行中
將 Android 裝置連接至電腦或使用模擬器。
- Android 裝置:請參閱instructions,在 Android 裝置上啟用開發人員選項,並設定系統來偵測裝置。
- 「Emulator」mdash;請使用 Android 虛擬裝置管理工具 (AVD Manager) 來設定虛擬裝置。選擇模擬器時,請務必挑選包含 Google API 的映像檔。
在「Android Studio」中,按一下「Run」選單選項 (或播放按鈕圖示),然後選擇部署目標。
建構和啟動時,應用程式向使用者顯示的到達網頁會列出選項。
NavViewActivity 和 NavFragmentActivity 選項
剛開始採用 NavSDK 時,這兩個選項可能會最實用。
選項 1:NavViewActivity
顯示使用 NavigationView
搭配 Navigator
的行為。
選項 2:第二個選項是 NavFragmentActivity
,標題是顯示使用 SupportNavigationFragment
和 Navigator
的行為。
當您按下其中一個選項時,會看到下列選項:
- 導覽 UI
- 應用程式功能表中的「設定目的地」按鈕
- 與疊加層互動,以動態方式叫用 API 的方法
- 含有更多選項的溢位選單
首先,請按一下「設定目的地」並選擇地址。然後,應用程式會模擬從目前位置到該地址的行程。您可以利用控制台疊加功能,瞭解呼叫 API 時會發生的情況。舉例來說,您可以按一下「View Methods」,嘗試強制讓 SDK 進入夜間模式,看看會是什麼樣子。
SwappingMapAndNavActivity 選項
SwappingMapAndNavActivity
展示的常見模式如下:
- 顯示
MapView
- 導航開始時切換至
NavigationView
- 導航結束時,返回
MapView
Google 地圖示範
您可以在 GitHub 上取得最新的 GoogleNavigation 示範。
建立中
在 Android Studio 中匯入試用版應用程式,並允許 Gradle 執行。
開啟
local.defaults.properties
並更新MAPS_API_KEY
屬性的值:MAPS_API_KEY=YOUR_API_KEY
按一下「build」,然後檢查 SDK 實作詳細資料。
在 Java 類別中,記下實作程式碼。
在版面配置 XML 中,留意版面配置設計和文字。
在
build.gradle
檔案中,記下依附元件中的 SDK。
請參閱密鑰 Gradle 外掛程式,進一步瞭解如何將 API 金鑰新增至資訊清單。
執行中
將 Android 裝置連接至電腦或使用模擬器。
- Android 裝置請參閱instructions,在 Android 裝置上啟用開發人員選項,並設定系統來偵測裝置。
- 模擬器:使用 Android 虛擬裝置管理工具 (AVD Manager) 來設定虛擬裝置。選擇模擬器時,請務必挑選包含 Google API 的映像檔。
在「Android Studio」中,按一下「Run」選單選項 (或播放按鈕圖示),然後選擇部署目標。
建構和啟動應用程式後,應用程式向使用者顯示示範清單的到達網頁。
Google Maps SDK 示範的使用者應熟悉這種呈現模式和原始碼對應的結構。這是因為 GoogleMap 示範與 Maps API 試用版應用程式類似,主要差別在於 Navigation SDK 示範可讓使用者選擇要測試哪個檢視類別 (如適用):NavigationView
或 MapView
(如適用)。
Google 通常會鼓勵採用者使用 NavigationView
。這項示範讓您可以靈活地在兩個版本的試用版應用程式中嘗試這些行為,並選擇最適合您的方式。舉例來說,如果您使用的第三方程式庫會預期與該類別互動,則可能仍須使用 MapView
。