常見問題

產品詳細資料

網路和連線

資料

UI 自訂

轉送

模擬工具

工作流程

車用機動力服務

產品詳細資料

您的應用程式必須實作對話方塊，並在其中顯示 Navigation SDK 服務條款通知，要求使用者接受該條款。這個對話方塊可讓使用者同意《服務條款》。Navigation SDK 會提供條款的文字檔案。使用 NavigationApi.showTermsAndConditionsDialog 方法顯示包含條款的對話方塊。
Google 地圖行動版支援的任何語言，都會自動提供 Navigation SDK 使用。裝置有預設的系統語言，應用程式無法變更這項設定；不過，應用程式可存取超過 70 種語言。

可以。啟動後，LocationListener 會繼續在背景執行。應用程式會繼續將道路對齊位置，並維持方位。

可以。建立或變更路線時，RouteChangeListener 會提供折線。

否，Navigation SDK 不需要在裝置上安裝 Google 地圖行動版。
否，Navigation SDK 目前不提供這項功能。
是的。系統預設會顯示交通路線。
Navigation SDK 支援哪些版本的 JDK？
Navigation SDK 支援 Oracle 積極支援的 Java SE LTS 版本。這些版本在 Oracle Java SE 支援路線圖中列為Premier 支援。

網路和連線

Navigation SDK 如何處理網路連線品質不佳的問題？
Navigation SDK 會為每趟行程預先快取路線。預先快取的資訊包括 15 到 20 分鐘的路線資訊，以及使用者偏離路線時的替代路線。Navigation SDK 會使用裝置 GPS 和感應器來推測位置。
Navigation SDK 如何處理 GPS 訊號不佳或中斷的情況？

導航開始後，Navigation SDK 至少會收到一次 GPS 訊號，並在下列情況下顯示「Searching for GPS...」訊息：

  • 如果自上次收到 GPS 訊號後，已過 10 秒以上。
  • 如果路線位置自上次收到 GPS 訊號後，移動超過 500 公尺。

如果 SDK 長時間未收到 GPS 訊號，沿路的進度 (在應用程式中以箭頭的位置表示) 可能會變慢，直到完全停止為止。在這種情況下，地圖上的箭頭會停留在最後一個 GPS 訊號所指示的位置。由於未收到 GPS 訊號，SDK 不會自動退出導航模式。不過，除非再次收到信號，否則可能無法提供指引。

是否有離線模式？
否，Navigation SDK 目前不提供離線模式；不過，SDK 會提供行程的預先快取資訊。

資料

在開始路線前，我可以擷取行程中的所有停靠站/目的地嗎？

可以。如要擷取路線的路線指南，請呼叫 Navigator.getRouteSegments()。

路線開始時是否提供即時路線指引？
是的。Navigation SDK 會提供路線區段清單。此外，使用者可以滑動標題中的方向資訊卡，查看每個轉彎動作。
如何向應用程式使用者傳達預估到達時間？

如要向應用程式使用者提供預估抵達時間資訊，請按照下列步驟操作：

  1. 使用 Navigator.getTimeAndDistanceList() 擷取所有路線控點的時間和距離。
  2. 將這項資訊轉送至用戶端應用程式，就像傳送駕駛員預估抵達時間一樣。
如果導航功能不在前景，是否可以使用 RoadSnappedLocationProvider 取得使用者目前的固定位置？

可以。RoadSnappedLocationProvider 預設會在背景執行。

Navigation SDK 是否支援地理圍欄？

否。在導航的情況下，remainingTimeOrdistanceChangeListener 比地理圍欄更有優勢。地理圍欄可能未考量道路幾何形狀，且可能不會以使用者導航的確切位置為中心。

您可以使用 remainingTimeOrdistanceChangeListener 模擬這項功能。

  1. 設定閾值，以決定回呼的頻率。
  2. 檢查到達目的地的剩餘距離。

舉例來說，如果您將閾值設為 100 公尺，當到達目的地的距離變動 100 公尺時，您就會收到回呼。隨著距離縮短，您可以將這個門檻更新為較小的值，並接收更頻繁的回呼。接著，請檢查剩餘的距離，判斷你是否已抵達上車/下車地點。

我可以在導航應用程式在背景執行時停用通知嗎？

可以。使用 Navigator.setHeadsUpNotificationEnabled 控制通知。這個方法有布林值引數。FALSE 會停用通知，TRUE 則會啟用通知。

交易記錄器會使用專屬 ID 追蹤接送和下車地點，並將這些資料記錄下來，以便 Google 進行產品分析。如果您是 Mobility Services 客戶，Google 建議您導入 NavigationTransactionRecorder 來記錄交易記錄。

UI 自訂

我可以為最佳路線選項加上顏色嗎？
否。目前不支援為特定路線選項編碼。
Navigation SDK 可以顯示最終目的地的預估到達時間嗎？

可以。請使用下列方法：

  1. 使用 Navigator.getTimeAndDistanceList() 擷取所有路線控點的時間和距離。
  2. 使用 NavigationFragment.setEtaCardEnabled(false) 隱藏目前路線點的預估到達時間。
  3. 算繪最終目的地預估抵達時間。
如何隱藏預估到達時間更新？

您可以呼叫 navigationView.setEtaCardEnabled(false) 停用預估到達時間資訊卡。

可為標題和頁尾資訊卡自訂哪些 UI？

使用 StylingOptions 設定背景顏色樣式。如要隱藏或顯示標頭和標尾，請使用 NavigationFragment 的 setHeaderEnabled 和 setFooterEnabled 成員函式。

轉送

我可以為使用者提供特定路線，或移除替代路線嗎？
否。系統預設會提供多個路線，並優先顯示最快的路線。您可以在要求中加入偏好設定 (例如「避免高速公路和收費站」)，以影響預設路線。新增路線點也會影響路線。
我可以為應用程式使用者顯示與預設目的地位置不同的目的地標籤嗎？

可以。建立 Marker，並為目的地和經緯度指定自訂標題。Navigation SDK 會在 NavigationMap 上顯示自訂標題和座標。

我可以使用 Navigation SDK 追蹤偏離定義路徑的情況嗎？

可以。使用 Navigator.setRouteChangedListener 接收通知，以便在路線變更或建議新路線時收到通知：

  1. 註冊事件監聽器，使用 Navigator.setRouteChangedListener 方法檢查沿路的裝置位置。
  2. 在回呼事件處理常式 onRouteChanged 中新增程式碼：
    • 傳送訊息給應用程式使用者，提供更新的預估到達時間和距離資訊。
    • 追蹤裝置的位置。
    • [選用] 新增應用程式需要的其他功能，以便處理使用者偏離指定路線的情況。
使用者是否可以在未完成路線的情況下退出導航？

可以。呼叫 Navigator.stopGuidance() 方法可停止導航。

模擬工具

模擬器是否支援路線變更？

可以。呼叫 simulateLocationsAlongNewRoute 來模擬包含路線變更的行程。simulateLocationsAlongExistingRoute 方法會忽略現有路徑的變更。

工作流程

如何在關閉含有導覽片段的活動後，關閉通知？

在導覽期間，當活動關閉時，導覽通知會持續顯示。車輛抵達目的地後，導航會停止，通知也會消失。

如要處理通知的點擊事件，請使用 Navigator.startGuidance(intent resumeIntent)。當應用程式使用者點選通知時，resume intent 就會觸發。通常，Navigator.startguidance(getIntent()) 會從主要活動中呼叫，在應用程式使用者點選通知時喚回活動。

車用機動力服務

對於 Mobility Services 客戶來說，使用 Navigation SDK 有何不同之處？

Google 地圖平台移動服務提供一系列 API 和 SDK，可滿足運輸和物流企業的企業需求。對於 Mobility Services 客戶而言，Navigation SDK 通常會與相關服務搭配使用，用於路線最佳化、派車、工作追蹤、車隊分析等。對於 Mobility Services 客戶，Navigation SDK 的收費方式也不同。詳情請參閱 Mobility Services 說明文件。

行動產品目前僅供特定客戶使用。如需瞭解詳情，請與業務代表聯絡。

如何判斷自己是否為 Mobility Services 客戶？
如果您不確定自己是否以 Mobility Services 客戶的身分導入 Navigation SDK，請在程式碼中尋找 ReportBillableEvent 呼叫。只有 Mobility Services 客戶應呼叫 ReportBillableEvent 方法。

如何向 Mobility Services 客戶收取 Navigation SDK 費用？
對於 Mobility Services 客戶，導航 SDK 的結帳和定價取決於您與 Google 地圖平台簽訂的服務協議。如要瞭解如何確保 Mobility Services 導入作業的收費正確無誤，請參閱「帳單驗證」一文。如要進一步瞭解 Mobility Services 的帳單資訊，請與業務代表聯絡。

哪些 Navigation SDK API 僅供 Mobility Services 客戶使用？

Navigation SDK 中有幾個 API 僅供Mobility Services 客戶使用，Google 會根據每筆交易向他們收費。如果您不是 Mobility Services 客戶，則下列方法不會執行：

如果我是 Mobility Services 客戶，是否也可以使用非 Mobility Services 實作的 Navigation SDK？

是的，車用機動力服務客戶可以同時使用 Navigation SDK 的車用機動力服務和非車用機動力服務實作項目。不過，應用程式一次只能使用一種實作類型。您也需要建立新的 Google Cloud 專案、帳單帳戶和 API 金鑰，這些項目必須與您在 Mobility Services 導入作業中使用的項目分開。詳情請參閱 Navigation SDK 設定總覽。

如要進一步瞭解如何使用非 Mobility Services 實作的 Navigation SDK，包括將應用程式從一種實作類型遷移至另一種，請與 Google 帳戶代表聯絡。

注意：如果您目前不是 Mobility Services 客戶，但有興趣進一步瞭解 Mobility Services 的 API 和 SDK 集合，請與 Google 地圖平台銷售團隊聯絡。