隨選行程的分享歷程總覽

隨選行程分享 Fleet Engine 歷程時, 追蹤訂單、行程或您提供的其他服務進度。

消費者應用程式

什麼是旅程分享?

分享旅程是 Fleet Engine 的一項功能,可讓使用者隨選乘車, Consumer SDK。提供可模擬行程資料及追蹤行程的介面 進而產生豐富的課程 對消費者使用者顯示行程資訊的地圖式顯示。您將 安裝到應用程式中,並在 Fleet Engine 中設定適當的角色設定檔 供應商可以使用歷程分享

歷程共用功能提供平台專屬 API,方便您建構歷程 直接分享到應用程式中Consumer SDK 適用於 下列平台:

使用歷程分享的好處

將分享歷程資訊整合至隨選行程應用程式後, 以近乎即時的方式提供全面的車輛監控體驗 位置更新和道路封閉位置。您的 消費者可在地圖上方看到這些資料重疊的路線,包括 進度詳細資料,協助他們瞭解乘車或外送服務的所在位置。

您可以透過分享歷程進行哪些操作?

您可以運用驅動程式 SDK 和 Fleet Engine 中的資訊, 提供下列功能的 Mobile SDK 檢視畫面和網路服務回應:

  • 提供符合品牌需求的地圖 UI 自訂項目。

  • 車輛沿著路線行駛的目前位置, 這個模型的位置會定期更新

  • 上車和下車地點的預計抵達時間 (ETA)。

  • 剩餘的距離。

  • 沿途的即時路況。

旅程共用的運作方式

大致來說,分享歷程必須採用以下機制:

  • 適當的 Fleet Engine 使用者角色,讓通過驗證的應用程式使用者可以 擷取與訂單相關聯的行程。
  • 消費者與行程之間的關聯,由 後端系統
  • Consumer SDK TripModelJourneySharingSession,以及會 模型行程資料,以及在消費者應用程式中分享行程時段。

旅程分享

Consumer SDK 也提供其他介面和類別, 為應用程式建立地圖使用者介面,這樣消費者 豐富的應用程式體驗,包括路況、地圖標記、預計到達時間及 路線資料。

此表格顯示共用歷程的流程。

1 消費者應用程式要求行程。 您的後端伺服器會收到隨選行程要求,且 包括:
  • 在 Fleet Engine 中建立行程。
  • 為 Fleet Engine 中的車輛指派行程。
2 司機接受行程 駕駛應用程式取得行程 ID 和行程資訊,以及司機 接受行程。
3 消費者應用程式要求取得歷程的存取權 消費者應用程式會從後端取得行程 ID, 即可開始分享行程資訊。
4 駕駛員展開行程 當司機使用駕駛應用程式表示行程已 啟動後,應用程式會透過驅動程式 SDK 通知後端伺服器。 舉例來說,假設驅動程式為 即將出發餐廳或開車前往上車地點
5 Fleet Engine 開始分享歷程 Fleet Engine 開始追蹤歷程並分享 處理在消費者應用程式的進展
6 消費者應用程式會顯示歷程 消費者應用程式通知消費者,並開始顯示 旅程,並隨著進步而更新整個旅程
7 行程已完成或取消 當駕駛取消或完成行程時, 驅動程式應用程式會停用位置追蹤功能,您的後端伺服器 會指示 Fleet Engine 將行程標示為已取消或已完成。
8 消費者應用程式停止分享歷程 旅程會顯示為已取消或已完成。
9 下一趟行程會重複這個流程 系統會建立新的行程,並重複相關程序。

如何使用歷程分享功能

請選取您的平台,瞭解如何開始分享歷程。

Android

1 在 Android 中設定 Consumer SDK 如要在應用程式中分享隨選行程的歷程,請設定 Consumer SDK。詳情請參閱取得 Android Consumer SDK
2 設定歷程共用介面 定義地圖並新增向量地圖支援,可設定旅程介面。詳情請參閱「設定地圖」一文。
3 分享旅程 依照行程將適當車輛的位置分享給消費者。詳情請參閱追蹤行程一文。
5 更新旅程進度及處理行程錯誤 更新行程的詳細資料 (例如移動距離和預估抵達時間),並處理該行程期間的任何錯誤。若需更多資訊,請參閲 更新行程進度處理行程錯誤
5 旅程完成後即可停止分享 停止追蹤行程,即可停止與消費者分享車輛位置資訊。詳情請參閱停止追蹤行程

iOS

1 在 iOS 中設定 Consumer SDK 如要在應用程式中分享隨選行程的歷程,請設定 Consumer SDK。詳情請參閱「取得 iOS Consumer SDK」一文。
2 設定歷程共用介面 初始化地圖檢視並處理地圖事件,以設定旅程的介面。詳情請參閱「設定地圖」一文。
3 分享旅程 依照行程將適當車輛的位置分享給消費者。詳情請參閱追蹤行程一文。
5 更新旅程進度及處理行程錯誤 更新行程的詳細資料 (例如移動距離和預估抵達時間),並處理該行程期間的任何錯誤。若需更多資訊,請參閲 更新行程進度處理行程錯誤
5 旅程完成後即可停止分享 停止追蹤行程,即可停止與消費者分享車輛位置資訊。詳情請參閱「停止追蹤行程」。

JavaScript

1 在 JavaScript 中設定歷程共用功能 如要在應用程式中分享隨選行程的歷程,請設定 Consumer SDK。詳情請參閱「設定 JavaScript Consumer SDK」一文。
2 載入及自訂旅程共用地圖 啟用 Maps JavaScript API 並設定授權,以設定旅程介面。詳情請參閱「設定地圖」一文。
3 分享旅程 依照行程將適當車輛的位置分享給消費者。詳情請參閱追蹤行程一文。
5 更新旅程進度及處理行程錯誤 更新行程的詳細資料 (例如移動距離和預估抵達時間),並處理該行程期間的任何錯誤。若需更多資訊,請參閲 更新及追蹤行程進度處理行程錯誤
5 旅程完成後即可停止分享 停止追蹤行程,即可停止與消費者分享車輛位置資訊。詳情請參閱「停止分享歷程」。

元件

本節總結共用歷程的兩個必要要素:

你也可以視情況自訂分享歷程: 元件:

驗證權杖擷取工具

如要控管儲存在 Fleet Engine 中的位置資料存取權,請務必執行 包括:

  1. 實作 Fleet Engine 適用的 JSON Web Token (JWT) 建立服務 。

  2. 在網頁或行動應用程式中導入驗證權杖擷取工具 來驗證位置資料的存取權。

適用對象 詳情請參閱 Android 設定指南。 iOSJavaScript

地圖檢視和行程追蹤工具

歷程分享包含視覺化的元件 車輛和路線控點,以及司機預計到達時間的原始資料動態饋給 或是剩餘的行駛距離

下表說明這些元件:

元件 說明
分享地圖檢視的旅程 地圖檢視畫面會管理旅程的生命週期,並顯示路線控點 指出車輛所在位置 如果已知車輛路線,地圖檢視畫面會更新車輛路線 折線,指出車輛沿途的進度。
JavaScript 中的行程地點提供者 如果是 JavaScript 網頁應用程式,行程地點提供者會提供位置資訊 將已追蹤物件的資訊放進共用旅程地圖。如要 資訊,請參閱 將行程地點提供者執行個體化。 您可以使用行程地點提供者,追蹤以下各項詳細資訊: 行程:
  • 行程中的上車或下車地點。
  • 指派給行程的車輛位置和路線。

已追蹤的位置物件

位置提供者可追蹤各種物件的位置,例如路點和 。

追蹤的位置 說明
取車地點 上車地點是指旅程起點。標記 取貨地點。
目的地位置 目的地位置是指旅程的終點。 標示下車地點。
路線控點位置 路點位置是指 追蹤歷程雖然技術面來說,路線控點可能包括 上車和下車地點,路線控點通常是指中階 沿途停靠站。例如上車和目的地之間的停靠站 送貨路線上的地點是途經點位置若需更多資訊,請參閲 行程路線控點
車輛位置 車輛位置是指系統回報的車輛位置,如要 資訊,請參閱車輛位置

設定地圖樣式

標記和折線樣式會決定 地圖上追蹤的位置物件。別擔心!您可以使用 自訂樣式選項,根據樣式變更預設樣式 做為網頁應用程式

控管追蹤位置的瀏覽權限

Fleet Engine 的預先定義位置提供者會遵循這些顯示規則 用於地圖上追蹤的位置物件如果您建立的是 位置提供者,就能變更瀏覽權限規則。

  • 只有在行程進行中時,才會顯示車輛:旅程 設為共用車輛後,即可看到 出發時間。如果行程取消,車輛會繼續顯示。

  • 一律顯示所有其他位置標記:所有其他位置標記 一律在地圖上顯示起點、目的地和路線控點適用對象 例如旅程分享下車地點或貨物交付 不論 。

後續步驟

請參閱要分享旅程的平台說明文件: