隨選行程分享 Fleet Engine 歷程時， 追蹤訂單、行程或您提供的其他服務進度。
什麼是旅程分享？
分享旅程是 Fleet Engine 的一項功能，可讓使用者隨選乘車， Consumer SDK。提供可模擬行程資料及追蹤行程的介面 進而產生豐富的課程 對消費者使用者顯示行程資訊的地圖式顯示。您將 安裝到應用程式中，並在 Fleet Engine 中設定適當的角色設定檔 供應商可以使用歷程分享
歷程共用功能提供平台專屬 API，方便您建構歷程 直接分享到您的應用程式Consumer SDK 適用於 下列平台：
使用歷程分享的好處
將分享歷程資訊整合至隨選行程應用程式後， 以近乎即時的方式提供全面的車輛監控體驗 位置更新和道路封閉位置。您的 消費者可在地圖上方看到街景車的路線，包括 進度詳細資料，協助他們瞭解乘車或外送服務的所在位置。
您可以透過分享歷程進行哪些操作？
您可以運用驅動程式 SDK 和 Fleet Engine 中的資訊， 提供下列功能的 Mobile SDK 檢視畫面和網路服務回應：
提供符合品牌需求的地圖 UI 自訂項目。
車輛沿著路線行駛的目前位置， 這個模型的位置會定期更新
上車和下車地點的預計抵達時間 (ETA)。
剩餘的距離。
沿途的即時路況。
旅程共用的運作方式
大致來說，分享歷程必須採用以下機制：
- 適當的 Fleet Engine 使用者角色，讓通過驗證的應用程式使用者可以 擷取與訂單相關聯的行程。
- 消費者與行程之間的關聯，由 後端系統
- Consumer SDK
TripModel和JourneySharingSession，以及會 模型行程資料，以及在消費者應用程式中分享行程時段。
Consumer SDK 也提供其他介面和類別， 為應用程式建立地圖使用者介面，這樣消費者 豐富的應用程式體驗，包括路況、地圖標記、預計到達時間及 路線資料。
此表格顯示共用歷程的流程。
| 1 | 消費者應用程式要求行程。 | 您的後端伺服器會收到隨選行程要求，且
包括：
|
| 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 中的位置資料存取權，請務必執行 包括：
實作 Fleet Engine 適用的 JSON Web Token (JWT) 建立服務 。
在網頁或行動應用程式中導入驗證權杖擷取工具 來驗證位置資料的存取權。
適用對象 詳情請參閱 Android 設定指南。 iOS 或 JavaScript。
地圖檢視和行程追蹤工具
歷程分享包含視覺化的元件 車輛和路線控點，以及司機預計到達時間的原始資料動態饋給 或是剩餘的行駛距離
下表說明這些元件：
| 元件 | 說明 |
|---|---|
| 分享地圖檢視的旅程 | 地圖檢視畫面會管理旅程的生命週期，並顯示路線控點 指出車輛所在位置 如果已知車輛路線，地圖檢視畫面會更新車輛路線 折線，指出車輛沿途的進度。 |
| JavaScript 中的行程地點提供者 | 如果是 JavaScript 網頁應用程式，行程地點提供者會提供位置資訊
將已追蹤物件的資訊放進共用旅程地圖。如要
資訊，請參閱
將行程地點提供者執行個體化。
您可以使用行程地點提供者，追蹤以下各項詳細資訊：
行程：
|
已追蹤的位置物件
位置提供者可追蹤各種物件的位置，例如路點和 。
| 追蹤的位置 | 說明 |
|---|---|
| 取車地點 | 上車地點是指旅程起點。標記 取貨地點。 |
| 目的地位置 | 目的地位置是指旅程終點， 標示下車地點。 |
| 路線控點位置 | 路點位置是指 追蹤歷程雖然技術面來說，路線控點可能包括 上車和下車地點，路線控點通常是指中階 沿途停靠站。例如上車和目的地之間的停靠站 送貨路線上的地點是途經點位置若需更多資訊，請參閲 行程路線控點 。 |
| 車輛位置 | 車輛位置是指系統回報的車輛位置，如要 資訊，請參閱車輛位置 。 |
設定地圖樣式
標記和折線樣式會決定 地圖上追蹤的位置物件。別擔心！您可以使用 自訂樣式選項，根據樣式變更預設樣式 做為網頁應用程式
控管追蹤位置的瀏覽權限
Fleet Engine 的預先定義位置提供者會遵循這些顯示規則 用於地圖上追蹤的位置物件如果您建立的是 位置提供者，就能變更瀏覽權限規則。
只有在行程進行中時，才會顯示車輛：旅程 設為共用車輛後，即可看到 出發時間。如果行程取消，車輛會繼續顯示。
一律顯示所有其他位置標記：所有其他位置標記 一律在地圖上顯示起點、目的地和路線控點適用對象 例如旅程分享下車地點或貨物交付 不論 。
後續步驟
請參閱要分享旅程的平台說明文件：