整合 Android 版的 Navigation SDK 後,應用程式不只可以連結至外部地圖檢視,您的應用程式可利用 Google 地圖導航,提供動態擷取與單一介面的駕駛行程資料報表。本指南說明如何執行 GitHub 提供的 Navigation SDK 試用版應用程式。
事前準備
如要開始使用 Navigation SDK,請務必確認下列項目。
Google 地圖平台代表可存取下列項目:
- 佈建可與 Navigation SDK 搭配使用的 API 金鑰。您必須提供專案 ID,您可以在 Google Cloud 控制台主資訊主頁的專案名稱底下找到該 ID。
- SDK 構件。確認您的專案已設為使用 Maven 做為 Navigation SDK。
- 適用於使用 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 4.1 版的 Navigation SDK 開始,GitHub 提供下列範例應用程式,供使用者下載。
GoogleNavigation 示範:在「引導式導覽工作階段」中,展示 API 行為和檢視畫面與使用者體驗的整合。
GoogleMapDemo:展示
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。
如要進一步瞭解如何在資訊清單中新增 API 金鑰,請參閱 Secrets Gradle 外掛程式說明文件。
執行中
將 Android 裝置連接至電腦,或使用模擬器。
- Android 裝置:請參閱instructions,在 Android 裝置上啟用開發人員選項,並設定系統以偵測裝置。
- Emulatormdash;使用 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
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 裝置請參閱instructions,瞭解如何在 Android 裝置上啟用開發人員選項,並設定系統以偵測裝置。
- 模擬器:使用 Android 虛擬裝置管理工具 (AVD Manager) 來設定虛擬裝置。選擇模擬器時,請務必挑選包含 Google API 的映像檔。
在 Android Studio 中,按一下「Run」(執行) 選單選項 (或播放按鈕圖示),然後選擇部署目標。
建構並啟動時,應用程式會向使用者顯示內含示範頁面的到達網頁。
Google Maps SDK 示範的使用者應該已經熟悉此呈現模式和原始碼的對應結構。這是因為 GoogleMap 試用版的設計與 Maps API 試用版應用程式類似,主要差別在於 Navigation SDK 示範可讓使用者選擇要在適用情況下,用於測試執行示範的檢視類別:NavigationView
或 MapView
。
Google 通常會鼓勵採用者使用 NavigationView
。此示範可讓您靈活地在試用版應用程式中嘗試對兩個版本執行這些行為,然後選擇適合您的選擇。舉例來說,如果您使用的第三方程式庫會預期會與類別互動,就可能需要使用 MapView
。