整合 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 上的方法
- 提供更多選項的溢位選單
如要開始使用，請按一下「Set Destination」(設定目的地)，然後選擇地址。接著，應用程式會模擬從您目前所在位置前往該地址的行程。使用控制面板重疊層，查看呼叫 API 時會發生什麼事。舉例來說，您可以按一下「View Methods」，嘗試強制 SDK 進入夜間模式，看看畫面會呈現什麼樣子。
使用 SwappingMapAndNavActivity 選項
SwappingMapAndNavActivity 會顯示下列常見模式：
- 顯示
MapView - 在導航開始時切換至
NavigationView - 在導航結束時返回
MapView
GoogleMap 示範
最新的 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。