整合 Android 版的 Navigation SDK 後，應用程式不只可以連結至外部地圖檢視，透過 Google 地圖導航，您的應用程式可提供動態擷取與單一介面的駕駛行程資料報告。
本指南向您介紹 Android Studio 專案，說明如何整合 Navigation SDK，並說明如何執行試用版應用程式。
Navigation SDK 是靜態程式庫，可讓您控制應用程式內導覽的外觀和音訊。如要進一步瞭解程式庫，請在另一個視窗中開啟 Navigation SDK 參考資料 (Javadoc)。
事前準備
如要開始使用 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 起，下列試用版應用程式均可在共用 Google 雲端硬碟中下載。
GoogleNavigation 示範：展示 API 行為和檢視畫面在引導式導覽工作階段中與使用者體驗相關的整合。
GoogleMap demo：展示
GoogleMap介面的個別行為，方便您自訂地圖的外觀和風格。
Maven 使用說明
示範應用程式已設為使用 Gradle 中的 Artifact Registry 外掛程式，從遠端 Maven 存放區下載 SDK 構件。請務必按照專案設定操作說明取得 SDK 存取權。
GoogleNavigation 示範
您可以在共用 Google 雲端硬碟的根目錄中找到最新的 GoogleNavigation 示範。舊版應用程式 位於「封存」中如果是 4.1 之前的版本，應用程式會和 AAR 一起封裝在相同的 ZIP 檔案中。
建築物
在 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 示範
您可以在 Google 雲端硬碟的根目錄中找到最新的 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。