Navigation Connect API 是 Navigation SDK 的輕量替代方案，可使用獨立的 Google 地圖和 Waze 應用程式進行路線規劃，不必在應用程式中建構及嵌入自訂導航介面。這項 API 會將駕駛人的工作階段安全地連結回後端。當駕駛人開始行程時，他們會看到熟悉的導航介面，但多了兩項功能：行程資料共用同意提示 (每 12 個月必須同意一次)，以及返回你應用程式的品牌返回按鈕。
使用 Navigation Connect API 的原因
透過 Navigation Connect API，您可以將 Google 地圖或 Waze 的即時行程位置和預計抵達時間更新，直接整合到後端程序。這有助於您制定重要業務決策，並與顧客分享準確的最新資訊，同時讓駕駛人使用偏好的導航應用程式 (Google 地圖或 Waze)。
使用範例如下：
- 提升共乘服務透明度：為共乘服務顧客和乘客提供司機位置和預估抵達時間的即時更新資訊。
- 提升運送追蹤功能：根據即時路況和路線資料，向顧客提供準確的貨物或餐點送達時間。
- 提升車隊管理和調度效率：追蹤即時駕駛員位置，為提供隨選服務 (例如故障排除、維修或運輸) 的車隊或行動工作人員做出明智的調度決策。
Navigation Connect API 的用途
透過 Navigation Connect API，您可以在後端直接接收 Google 地圖或 Waze 的即時位置和預計抵達時間更新。
- 不干擾地追蹤行程：追蹤行程時，不必變更駕駛人使用 Google 地圖或 Waze 的選擇，也不會影響他們的使用體驗。
- 存取即時位置資料：在行程期間持續取得司機的即時位置、剩餘距離和經過時間。
- 監控行程生命週期：設定行程資料的更新頻率，追蹤行程的確切狀態，並在駕駛員出發、抵達或暫停行程時立即收到通知。
- 查看及分享預計抵達時間：透過 Google 的即時路線規劃演算法，取得準確的預計抵達時間更新。
- 追蹤剩餘路線和車流量 (僅限 Waze)：從駕駛人目前的位置到最終目的地，接收有效路線的折線和即時車流量狀況，與 Waze 中顯示的內容完全相同。
- 動態修剪：車輛移動時，導航連線會自動修剪有效路線的折線，確保你只收到行程的剩餘部分。
- 更新頻率：路線和路況會在重新計算路線、主動式用戶端重新規劃路線或路況變更時自動更新。
- 彈性擷取資料：使用直接 REST API 呼叫來取用即時行程資料，或使用 Google Cloud Pub/Sub 訂閱項目有效率地串流更新。
Navigation Connect API 的運作方式
Navigation Connect API 會接受包含行動應用程式 ID 和工作階段設定的 CreateTrip 要求。這項服務會產生專屬的行程執行個體，並傳回行程權杖。這個權杖隨後會附加至 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 | 處理行程資料 | 瞭解如何處理行程狀態和其他行程資料。 |