整合 Navigation SDK for Android 後,應用程式就能做得更多,不只連結至外部地圖檢視畫面。透過 Google 地圖導航功能,應用程式可以動態擷取使用者行程的資料,並提供單一檢視報表。本指南說明如何執行 Navigation SDK 試用版應用程式,您可以在 GitHub 上取得這些應用程式。
事前準備
如要開始使用 Navigation SDK,請務必備妥下列項目。
- 用於 Navigation SDK 的 API 金鑰。如要進一步瞭解如何建立及限制金鑰,請參閱「使用 API 金鑰」一文。
- SDK 構件。請確認專案已設定,以便使用 Navigation SDK 的 Maven。
- 一或多個示範應用程式。
- Android Studio:使用 Navigation SDK 建構應用程式的建議開發環境。
本說明文件的適用對象為熟悉 Android 開發和物件導向程式設計概念的開發人員。此外,您也應該要從使用者的角度熟悉 Google 地圖。
取得試用版應用程式
Google 提供兩個應用程式,協助您瞭解 Navigation SDK 在 Google 地圖 API 之上提供的功能,具體取決於您的經驗程度。如果您熟悉 Google Maps API,可以專注於 GoogleNavigation 示範。對於這兩個專案的新手開發人員來說,這兩個應用程式都很實用。
自 Navigation SDK for Android 4.1 起,以下兩個示範應用程式皆可在 GitHub 上供下載。
GoogleNavigation 示範:展示 API 行為和檢視畫面整合方式,以便在導覽式導航工作階段中提供使用者體驗。
Google 地圖示範:展示
GoogleMap
介面的個別行為,以自訂地圖的呈現方式和感覺。
GoogleNavigation 示範
最新的 GoogleNavigation 示範可在 GitHub 上取得。
建築物
在 Android Studio 中匯入示範應用程式,並允許 Gradle 執行。
開啟
local.defaults.properties
,並更新MAPS_API_KEY
屬性的值:MAPS_API_KEY=YOUR_API_KEY
按一下「build」,然後檢查 SDK 實作詳細資料。
在 Java 類別中,請注意實作程式碼。
在版面配置 XML 中,請留意版面配置設計和文字。
在
build.gradle
檔案中,請注意依附元件中的 SDK。
如要進一步瞭解如何將 API 金鑰新增至資訊清單,請參閱 Secrets Gradle 外掛程式說明文件。
執行中
將 Android 裝置連接到電腦或使用模擬器。
- Android 裝置:請參閱操作說明,在 Android 裝置上啟用開發人員選項,並將系統設定為偵測裝置。
- Emulator:使用 Android 虛擬裝置管理工具 (AVD Manager) 設定虛擬裝置。選擇模擬器時,請務必挑選包含 Google API 的映像檔。
在 Android Studio 中,按一下「Run」選單選項 (或播放按鈕圖示),然後選擇部署目標。
建構並啟動應用程式後,應用程式會向使用者顯示含有選項清單的到達網頁。
NavViewActivity 和 NavFragmentActivity 選項
新採用 NavSDK 的使用者可能會發現這兩個選項最實用。
選項 1:NavViewActivity
使用 NavigationView
搭配 Navigator
展示行為。
選項 2:第二個選項名為 NavFragmentActivity
,會展示使用 SupportNavigationFragment
和 Navigator
的行為。
點選其中一個選項後,系統會顯示下列畫面:
- 導覽 UI
- 應用程式選單中的「Set Destination」按鈕
- 您可以透過疊加層與之互動,以動態方式在 API 上叫用方法
- 提供更多選項的溢位選單
如要開始使用,請按一下「設定目的地」,然後選擇地址。然後模擬從目前位置前往該地址的路線。使用控制面板重疊,查看呼叫 API 時會發生什麼事。舉例來說,您可以按一下「View Methods」,嘗試強制 SDK 進入夜間模式,看看畫面會變成什麼樣子。
使用 SwappingMapAndNavActivity 選項
SwappingMapAndNavActivity
會顯示下列常見模式:
- 顯示
MapView
- 在導航開始時切換至
NavigationView
- 在導覽結束時返回
MapView
GoogleMap 示範
您可以在 GitHub 上取得最新的 GoogleNavigation 示範。
建築物
在 Android Studio 中匯入示範應用程式,並允許 Gradle 執行。
開啟
local.defaults.properties
,並更新MAPS_API_KEY
屬性的值:MAPS_API_KEY=YOUR_API_KEY
按一下「build」,然後檢查 SDK 實作詳細資料。
在 Java 類別中,請注意實作程式碼。
在版面配置 XML 中,請留意版面配置設計和文字。
在
build.gradle
檔案中,記下依附元件中的 SDK。
如要進一步瞭解如何將 API 金鑰新增至資訊清單,請參閱「Secrets Gradle 外掛程式」。
執行中
將 Android 裝置連接到電腦或使用模擬器。
- Android 裝置:請參閱操作說明,在 Android 裝置上啟用開發人員選項,並設定系統以偵測裝置。
- Emulator 使用 Android 虛擬裝置管理工具 (AVD Manager) 設定虛擬裝置。選擇模擬器時,請務必挑選包含 Google API 的映像檔。
在 Android Studio 中,按一下「Run」選單選項 (或播放按鈕圖示),然後選擇部署目標。
建構並啟動應用程式後,應用程式會向使用者顯示含有一系列示範內容的到達網頁。
Google 地圖 SDK 示範的使用者應該熟悉這個呈現模式和相應的程式碼結構。這是因為 GoogleMap 示範專案的設計類似於 Maps API 示範應用程式。主要差異在於 Navigation SDK 示範專案可讓使用者選擇要用於測試執行示範的檢視類別:NavigationView
或 MapView
(如適用)。
Google 通常鼓勵採用者使用 NavigationView
。這個示範可讓您靈活地在示範應用程式的兩個版本中試用這些行為,並選擇適合自己的版本。舉例來說,如果您使用預期與該類別互動的第三方程式庫,可能仍需要使用 MapView
。