立即試用

整合 Navigation SDK for Android 後，應用程式就能連結至外部地圖檢視畫面，透過 Google 地圖導航功能，您的應用程式就能針對使用者的行程提供動態擷取和單一檢視的資料回報。本指南說明如何執行 Navigation SDK 試用版應用程式，您可以在 GitHub 上找到這些應用程式。

事前準備

如要開始使用 Navigation SDK，請務必取得下列項目。

• 用於 Navigation SDK 的 API 金鑰。如要進一步瞭解如何建立及限制金鑰，請參閱「使用 API 金鑰」一文。
• SDK 構件。請確認專案已設定，以便使用 Navigation SDK 的 Maven。
• 一或多個示範應用程式。
• Android Studio：使用 Navigation SDK 建構應用程式時，建議選擇此開發環境。

本說明文件的適用對象為熟悉 Android 開發和物件導向程式設計概念的開發人員。此外，您也應該要從使用者的角度熟悉 Google 地圖。

注意： 如果您的應用程式已使用 Maps SDK，Navigation SDK 會取代 Maps SDK 的地圖圖層和導航功能。您無法在同一個應用程式中使用 Navigation SDK 和 Maps SDK。

取得試用版應用程式

Google 提供兩個應用程式，協助您瞭解 Navigation SDK 在 Google 地圖 API 之上提供的功能，具體取決於您的經驗程度。如果您熟悉 Google Maps API，可以專注於 GoogleNavigation 示範。對於不熟悉這兩個專案的開發人員來說，這兩個應用程式都很實用。

自 Navigation SDK for Android 4.1 起，您可以在 GitHub 下載下列示範應用程式。

• GoogleNavigation 示範：展示 API 行為和檢視畫面整合方式，以便在導覽式導航工作階段中提供使用者體驗。

• Google 地圖示範：展示 GoogleMap 介面的個別行為，以自訂地圖的呈現方式和感受。

GoogleNavigation 示範

最新的 GoogleNavigation 示範可在 GitHub 上取得。

建築物

1. 在 Android Studio 中匯入示範應用程式，並允許 Gradle 執行。

   注意： 您必須使用已佈建的 API 金鑰更新 local.defaults.properties，應用程式才能載入地圖。

2. 開啟 local.defaults.properties 並更新 MAPS_API_KEY 屬性的值：

     MAPS_API_KEY=YOUR_API_KEY
   

3. 按一下「build」，然後查看 SDK 實作詳細資料。

   • 在 Java 類別中，請注意實作程式碼。

   • 在版面配置 XML 中，請留意版面配置設計和文字。

   • 在 build.gradle 檔案中，請注意依附元件中的 SDK。

如要進一步瞭解如何將 API 金鑰新增至資訊清單，請參閱 Secrets Gradle 外掛程式說明文件。

執行中

1. 將 Android 裝置連接到電腦或使用模擬器。

   • Android 裝置：請參閱操作說明，在 Android 裝置上啟用開發人員選項，並將系統設定為偵測裝置。
   • Emulator：使用 Android 虛擬裝置管理工具 (AVD Manager) 設定虛擬裝置。選擇模擬器時，請務必挑選包含 Google API 的映像檔。

2. 在 Android Studio 中，按一下「Run」選單選項 (或播放按鈕圖示)，然後選擇部署目標。

建構並啟動應用程式後，應用程式會向使用者顯示含有選項清單的到達網頁。

NavViewActivity 和 NavFragmentActivity 選項

新採用 NavSDK 的使用者可能會發現這兩個選項最實用。

選項 1：NavViewActivity 使用 NavigationView 搭配 Navigator 展示行為。

選項 2：第二個選項名為 NavFragmentActivity，會顯示使用 SupportNavigationFragment 和 Navigator 的行為。

注意： 在大多數情況下，建議您使用 SupportNavigationFragment，這是 NavigationView 的包裝函式，而非直接與 NavigationView 互動。詳情請參閱「導覽地圖互動最佳做法 」。

點選其中一個選項後，系統會顯示以下畫面：

• 導覽 UI
• 應用程式選單中的「Set Destination」(設定目的地) 按鈕
• 可供您互動，以便動態叫用 API 上的方法
• 提供更多選項的溢位選單

如要開始使用，請按一下「Set Destination」(設定目的地)，然後選擇地址。接著，應用程式會模擬從您目前所在位置前往該地址的行程。使用控制面板重疊層，查看呼叫 API 時會發生什麼事。舉例來說，您可以按一下「View Methods」，嘗試強制 SDK 進入夜間模式，看看畫面會呈現什麼樣子。

使用 SwappingMapAndNavActivity 選項

注意： 這個選項可協助您從 v1 遷移至 v4。我們建議您盡可能只使用 NavigationView，但這只是提供做法示例，說明如何同時使用這兩種方法。

SwappingMapAndNavActivity 會顯示下列常見模式：

• 顯示 MapView
• 在導航開始時切換至 NavigationView
• 在導航結束時返回 MapView

GoogleMap 示範

最新的 GoogleNavigation 示範可在 GitHub 上取得。

注意： 如要進一步瞭解如何與應用程式中的 GoogleMap 物件互動，請參閱 GoogleMap 互動最佳做法。

建築物

1. 在 Android Studio 中匯入示範應用程式，並允許 Gradle 執行。

   注意： 您必須使用已佈建的 API 金鑰更新 local.defaults.properties，應用程式才能載入地圖。

2. 開啟 local.defaults.properties 並更新 MAPS_API_KEY 屬性的值：

     MAPS_API_KEY=YOUR_API_KEY
   

3. 按一下「build」，然後查看 SDK 實作詳細資料。

   • 在 Java 類別中，請注意實作程式碼。

   • 在版面配置 XML 中，請留意版面配置設計和文字。

   • 在 build.gradle 檔案中，請注意依附元件中的 SDK。

如要進一步瞭解如何將 API 金鑰新增至資訊清單，請參閱「Secrets Gradle 外掛程式」。

執行中

1. 將 Android 裝置連接到電腦或使用模擬器。

   • Android 裝置請參閱操作說明，在 Android 裝置上啟用開發人員選項，並設定系統來偵測裝置。
   • Emulator 使用 Android 虛擬裝置管理工具 (AVD Manager) 設定虛擬裝置。選擇模擬器時，請務必挑選包含 Google API 的映像檔。

2. 在 Android Studio 中，按一下「Run」選單選項 (或播放按鈕圖示)，然後選擇部署目標。

建構並啟動後，應用程式會向使用者顯示到達網頁，列出一系列的示範內容。

Google 地圖 SDK 示範的使用者應該熟悉這個呈現模式和相應的程式碼結構。這是因為 GoogleMap 示範專案的設計類似於 Maps API 示範應用程式。主要差異在於 Navigation SDK 示範專案可讓使用者選擇要用於測試執行示範的檢視畫面類別：NavigationView 或 MapView (如適用)。

Google 通常鼓勵採用者使用 NavigationView。這個示範可讓您靈活地在示範應用程式的兩個版本中試用這些行為，並選擇最適合您的版本。舉例來說，如果您使用第三方程式庫，且該程式庫預期要與該類別互動，則可能仍需要使用 MapView。

重要事項： MapView、MapFragment 和 SupportMapFragment 類別需要裝置安裝 Google Play 服務應用程式。如果您啟動全新的模擬器，或將非常舊的裝置恢復原廠設定，Android 映像檔可能會預先安裝過時的 Google Play 服務。在這種情況下，您必須等待系統自動下載新版本，或透過 Google Play 商店手動更新 Play 服務。