整合 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 提供兩個應用程式,您可以根據自身經驗,提供 Google Maps API 頂層的 Navigation SDK 功能。熟悉 Google Maps API 的開發人員可以將重點放在 GoogleNavigation 示範上。對於不熟悉這兩個專案的開發人員來說,這兩個應用程式都很實用。
從 Android 適用的 Navigation SDK 4.1 版開始,下列示範應用程式都可在 GitHub 下載。
GoogleNavigation 示範:在引導式導覽工作階段中,展示與使用者體驗相關的 API 行為和檢視畫面整合。
GoogleMap 示範:展示
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。
請參閱「Secrets Gradle 外掛程式」說明文件,進一步瞭解如何將 API 金鑰新增至資訊清單。
執行中
將 Android 裝置連接至電腦或使用模擬器。
- Android 裝置:請參閱操作說明,在 Android 裝置上啟用開發人員選項,並將系統設定為偵測裝置。
- Emulator:使用 Android 虛擬裝置管理工具 (AVD Manager) 設定虛擬裝置。選擇模擬器時,請務必挑選包含 Google API 的映像檔。
在 Android Studio 中,按一下「Run」選單選項 (或播放按鈕圖示),然後選擇部署目標。
建構和啟動時,應用程式向使用者顯示的到達網頁會列出選項。
NavViewActivity 和 NavFragmentActivity 選項
新採用 NavSDK 的使用者可能會發現這兩個選項最實用。
選項 1:NavViewActivity
使用 NavigationView
搭配 Navigator
展示行為。
選項 2:第二個選項名為 NavFragmentActivity
,會在 Navigator
旁邊顯示使用 SupportNavigationFragment
的行為。
當您按下其中一個選項時,會看到下列選項:
- 導覽 UI
- 應用程式功能表中的「設定目的地」按鈕
- 可供您互動,以動態方式在 API 上叫用方法的疊加層
- 含有更多選項的溢位選單
如要開始使用,請按一下「Set Destination」(設定目的地),然後選擇地址。然後,應用程式會模擬從目前位置到該地址的行程。您可以利用控制台疊加功能,瞭解呼叫 API 時會發生的情況。舉例來說,您可以按一下「View Methods」,嘗試強制讓 SDK 進入夜間模式,看看會是什麼樣子。
使用 SwappingMapAndNavActivity 選項
SwappingMapAndNavActivity
會顯示下列常見模式:
- 顯示
MapView
- 導航開始時切換至
NavigationView
- 在導航結束時返回
MapView
Google 地圖示範
最新的 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」選單選項 (或播放按鈕圖示),然後選擇部署目標。
建構並啟動後,應用程式會向使用者顯示到達網頁,列出一系列的示範內容。
Google 地圖 SDK 示範的使用者應該熟悉這個呈現模式和相應的程式碼結構。這是因為 GoogleMap 示範與 Maps API 試用版應用程式類似,主要差別在於 Navigation SDK 示範可讓使用者選擇要測試哪個檢視類別 (如適用):NavigationView
或 MapView
(如適用)。
Google 通常鼓勵採用者使用 NavigationView
。這個示範可讓您靈活地在示範應用程式的兩個版本中試用這些行為,並選擇最適合您的版本。舉例來說,如果您使用的第三方程式庫會預期與該類別互動,則可能仍須使用 MapView
。