自訂導覽體驗

Navigation SDK 提供多種方式，可將導航體驗整合至應用程式。本頁面將說明什麼是自訂導航體驗，以及這與 Navigation SDK 中其他導航體驗有何不同。

什麼是自訂導航體驗？

導入 Navigation SDK 的主要方式是使用 Google 導航體驗，嵌入使用 Google 提供 UI 元素和視覺效果的即時路況導航體驗，類似於 Google 地圖應用程式中的導航體驗。如果需要比 Google 導覽體驗更靈活的功能，您可以實作自訂導覽體驗。自訂導航體驗的範圍很廣，從完全不提供轉彎指引、只在背景程序執行導航，到將高度自訂的指引體驗投射到與執行導航的裝置不同的螢幕上，都屬於自訂導航體驗。在自訂導航體驗中，應用程式會呼叫 Navigation SDK，要求即時路況導航動態饋給，然後由您提供及管理使用者在導航體驗中看到的 UI 元素和視覺效果。雖然使用 Google 導航體驗通常較容易實作，但自行建構自訂導航體驗可提供更多自訂選項。

建立自訂導航體驗時，應用程式會呼叫 Navigation SDK，按照下列流程啟動、執行及停止導航：

  1. 開始導航。如要開始自訂導航體驗，請建立導航例項並設定目的地。使用 GMSNavigationService.createNavigationSession 建立導航工作階段。這個非 UI 物件會保留狀態，無論是否有檢視控制器，都能運作。

    詳情請參閱「即時路線資料動態饋給詳細資料」。

    查看試用版：下載 Navigation SDK 時，會一併取得試用版。您可以執行試用版，查看導航體驗範例，瞭解如何從標準導航的即時路線指引，切換至僅顯示裝置位置沿著道路折線移動的導航體驗。

  2. 主動導覽。這是 Google 提供的導航體驗與自訂導航體驗之間的另一個主要差異。您不必將導引交給 Navigation SDK 的內建事件管理工具，而是實作 GMSNavigatorListener 通訊協定，為詳細的即時路線導引設定事件監聽器，然後實作事件處理常式。這樣一來，您的體驗就能回應「監聽導航事件」中所述的事件。

  3. 結束導航。與 Google 導航體驗一樣，自訂導航也需要您以最適合應用程式體驗的方式終止導航。

何時適合使用自訂導航體驗？

下表說明一些自訂導航情境。

情境示例

概要步驟

您必須為小型裝置 (例如 2 輪車輛) 提供純文字駕駛指引。

建立導航器，並將即時路線指引設為資料動態饋給，傳送至小型螢幕裝置，同時在駕駛人的手機上執行導航器，但不在駕駛人的直接視線範圍內。

您想為使用 Apple CarPlay 的駕駛人提供車輛服務。
  1. 設定車輛服務。
  2. 設定 Navigation SDK 專案。
  3. 如果尚未建立導覽器，請先建立。
  4. 設定即時路線指引的事件監聽器。
  5. 在車用應用程式介面上繪製地圖，並根據您設定的資料動態饋給填入欄位。

詳情請參閱「啟用 CarPlay 導航功能」。

使用應用程式的駕駛人希望在大部分行程中查看總覽圖，只有在市區街道上才需要即時路線指引。

應用程式應允許駕駛人視需要進入及退出 Google 導航體驗，而不必變更導航器的目的地和行程模式設定。