Navigation Connect API 可使用獨立的 Google 地圖和 Waze 應用程式進行路線規劃，因此是 Navigation SDK 的輕量替代方案，您不必在應用程式中建構及嵌入自訂導航介面。這項 API 會安全地將駕駛人的工作階段連結回後端。駕駛人開始行程時，會看到熟悉的導航介面，但多了兩項功能：行程資料共用同意聲明提示 (每 12 個月須顯示一次)，以及可返回應用程式的品牌返回按鈕。
為什麼要使用 Navigation Connect API
透過 Navigation Connect API，您可以將 Google 地圖或 Waze 的即時行程位置和預計抵達時間更新，直接整合到後端程序。這有助於您做出重要的業務決策，並與顧客分享準確的最新資訊，同時讓駕駛人使用偏好的導航應用程式 (Google 地圖或 Waze)。
用途範例如下：
- 提高叫車服務透明度：為叫車服務顧客和乘客提供司機位置和預估抵達時間的即時更新資訊。
- 強化運送追蹤功能：根據即時路況和路線資料，向顧客提供準確的貨物或餐點送達時間。
- 提升車隊管理和調度效率：追蹤駕駛人的即時位置，針對提供隨選服務的車隊或行動工作人員 (例如故障排除、維修或運輸) 做出明智的調度決策。
Navigation Connect API 的用途
Navigation Connect API 可讓您直接在後端，接收 Google 地圖或 Waze 的即時位置和預計到達時間更新。
- 以不干擾的方式追蹤行程：追蹤行程時，不必變更駕駛人使用 Google 地圖或 Waze 的選擇，也不會影響他們的使用體驗。
- 存取即時位置資料：在行程期間持續取得司機的即時位置、剩餘距離和經過時間。
- 監控行程生命週期：設定行程資料的更新頻率，即可追蹤行程的確切狀態，並在駕駛員出發、抵達或暫停行程時立即收到通知。
- 使用及分享預計到達時間：Google 的即時路線演算法可提供高度準確的預計到達時間更新資訊。
- 追蹤剩餘路線和路況：
接收從司機目前位置到最終目的地的剩餘路線折線和即時路況，與 Google 地圖或 Waze 顯示的內容完全相同。這項功能會觸發 Navigation Connect Enterprise SKU。
- 動態修剪：車輛移動時，Navigation Connect 會自動修剪駕駛員的有效路線折線 (應用程式中導航的完整路線)，確保您只會收到剩餘路線 (從駕駛員目前位置到目的地的路段)。
- 更新頻率：路線和路況會在重新計算路線、主動重新規劃用戶端路線或路況變更時自動更新。
- 追蹤路線偏離情形 (僅限 Waze)：偵測駕駛人何時偏離路線、精確指出偏離地點和時間，並判斷偏離是駕駛人主動造成 (例如轉錯彎)，還是系統主動造成 (例如為了避開車流而重新規劃路線)。這項功能會觸發導覽連結 Enterprise SKU。
- 靈活擷取資料：直接呼叫 REST API 擷取即時行程資料，或使用 Google Cloud Pub/Sub 訂閱項目有效率地串流更新。
Navigation Connect API 的運作方式
Navigation Connect API 會接受 CreateTrip 要求，其中包含行動應用程式 ID 和工作階段設定。服務會產生專屬的行程執行個體，並傳回行程權杖。接著，這個權杖會附加至 Google 地圖或 Waze 深層連結。駕駛人啟動導航並授予同意後，這項服務會處理即時導航資料，並傳回遙測更新，包括位置、預計抵達時間和剩餘距離。
資源
下表彙整了 Navigation Connect API 提供的資源，以及傳回的資料。詳情請參閱 Navigation Connect API 參考資料。
| 資料資源 | 傳回的資料 |
|---|---|
|
JSON 格式的驗證和行動應用程式 ID。 請參閱「建立行程」。 |
用於在 Google 地圖或 Waze 中初始化連線的專屬行程權杖。 請參閱「啟動 Google 地圖或 Waze」。 |
|
JSON 格式的專屬行程 ID 和提取或推送方法。 請參閱「擷取行程資料」。 |
即時行程遙測資料，包括：
請參閱「處理行程資料」。 |
如何使用 Navigation Connect API
| 1 | 做好準備 | 請先設定 Google Cloud 專案，然後按照後續操作說明完成設定。 |
| 2 | 建立行程 | 傳送 Navigation Connect API 呼叫，建立行程並提供專屬 ID，然後儲存權杖。 |
| 3 | 啟動 Google 地圖或 Waze | 傳遞行程權杖並啟動 Google 地圖或 Waze，即可啟用行程資料共用功能。 |
| 4 | 擷取行程資料 | 傳送 Navigation Connect API 呼叫來擷取行程資料。您也可以選擇使用 Google Cloud Pub/Sub 訂閱最新消息。 |
| 5 | 處理行程資料 | 瞭解如何處理行程狀態和其他行程資料。 |