Consumer SDK 隨選行程總覽

允許消費者追蹤訂單、行程或您提供的其他服務，以便量身打造隨選行程的消費者體驗。

什麼是 Consumer SDK？

用戶 SDK 是 Fleet Engine 的一部分，用於處理隨選行程。它提供的介面可模擬行程資料，並追蹤 Fleet Engine 中的行程，此外，您還可以使用這些介面建立以地圖為基礎的豐富顯示畫面，與消費者使用者分享行程。您可以將 Consumer SDK 整合至應用程式，並在 Fleet Engine 中設定適當的角色設定檔，打造這種消費者體驗。

消費者 SDK 平台專屬 API 可讓您在應用程式中原生分享旅程。Consumer SDK 適用於下列平台：

• Android
• iOS
• JavaScript

為什麼要使用 Consumer SDK？

將 Consumer SDK 整合至隨選行程應用程式，即可提供完整的消費者體驗，包括近乎即時的位置更新和路線定位。消費者可以看到車輛路線疊加在地圖上，包括進度詳細資料，協助他們瞭解行程或訂購商品的位置。

消費者 SDK 有哪些功能？

您可以使用 Driver SDK 和 Fleet Engine 的資訊，打造客製化的消費者體驗，包括下列功能：

• 根據品牌需求自訂地圖 UI。

• 追蹤車輛目前的位置，並定期更新其位置，以便車輛沿著路線行駛。

• 顯示上車和下車地點的預估到達時間 (ETA)。

• 顯示剩餘距離。

• 顯示路線上的即時車流量。

Consumer SDK 的運作方式

大致來說，Consumer SDK 會依賴下列機制：

• 具備適當的 Fleet Engine 角色，讓已驗證的應用程式能夠追蹤與消費者訂單相關聯的行程。
• 消費者與行程之間的關聯，由後端系統提供。
• TripModel 和 JourneySharingSession SDK 類別，用於模擬行程資料，並在消費者應用程式中分享行程工作階段。

Consumer SDK 也提供其他介面和類別，讓您打造豐富的應用程式體驗，並提供詳細資料，例如交通狀況、地圖標記、預估到達時間和路線資料。

這張表格顯示乘客應用程式所追蹤的旅程流程。

1	消費者應用程式要求行程	後端伺服器會取得隨選行程要求，並執行下列操作： 在 Fleet Engine 中建立行程。 將行程指派給車輛。
2	駕駛接受行程	司機應用程式會取得行程 ID 和行程資訊，然後司機接受行程。
3	消費者應用程式要求追蹤行程的存取權	消費者應用程式會從後端取得行程 ID，並要求開始追蹤行程。
4	駕駛員開始行程	當駕駛員使用駕駛員應用程式表示行程已開始時，應用程式會透過 Driver SDK 通知後端伺服器。例如，司機即將離開餐廳或開往接送地點時。
5	Fleet Engine 開始傳送行程資訊	Fleet Engine 開始追蹤行程，並將進度分享給消費者應用程式。
6	消費者應用程式會顯示行程資訊	消費者應用程式會通知消費者，並開始向他們顯示行程資訊，並隨著行程進度更新。
7	行程已取消或完成	當駕駛員取消或完成行程時，駕駛員應用程式會停用定位追蹤功能，後端伺服器則會通知車隊引擎將行程標示為已取消或完成。
8	消費者應用程式停止追蹤行程	行程顯示為已取消或已完成。
9	在下次行程時重複執行這個程序	系統會建立新的行程，並重複這個程序。

如何使用 Consumer SDK

請選取所用平台，瞭解如何在消費者應用程式中開始追蹤行程。

元件

本節將概述追蹤行程所需的兩個必要元件：

• 驗證權杖擷取器。
• 地圖檢視畫面和行程追蹤器。

您也可以選擇使用下列元件，為消費者提供客製化體驗：

• 設定地圖樣式。
• 控管追蹤位置的顯示設定。

驗證權杖擷取工具

如要控管對儲存在 Fleet Engine 中的定位資料的存取權，您必須執行下列操作：

1. 在伺服器上為 Fleet Engine 實作 JSON Web Token (JWT) 建立服務。詳情請參閱「發出 JWT」。

2. 在網頁或行動應用程式中實作驗證權杖擷取器，以便驗證位置資料存取權。如要進一步瞭解如何設定權杖擷取器，請參閱 Android、iOS 或 JavaScript 的設定指南。

地圖檢視畫面和行程追蹤器

追蹤行程包含車輛和路線點的視覺化元件，以及駕駛員預估抵達時間或剩餘行駛距離的原始資料動態饋給。

下表說明這些元件：

元件	說明
消費者地圖檢視畫面	地圖檢視畫面會管理行程的生命週期，並在行程進行期間顯示車輛位置的路徑點。如果已知車輛的路線，地圖檢視畫面會更新車輛路線多邊形，以顯示車輛沿路線行駛的進度。
JavaScript 中的行程位置供應器	對於 JavaScript 網頁應用程式，行程位置供應器會將追蹤物件的位置資訊，提供至共用行程地圖。詳情請參閱「建立行程位置供應器的例項化」。您可以使用行程位置供應工具，追蹤行程的下列詳細資料： 行程的上車或下車地點。 指派給行程的車輛位置和路線。

追蹤位置物件

位置提供者會追蹤路徑點和車輛等物件的所在位置，詳情請參閱下表。

追蹤位置	說明
取車地點	上車地點是行程的起點。
目的地位置	目的地是行程結束的位置。用來標示下車地點。
路線控點位置	路標位置是指沿著追蹤行程路線的任何中途位置。雖然從技術層面來說，中途點可以包含上車和下車地點，但中途點通常是指沿途的中途停靠站。舉例來說，在運送路線上，從上車地點到目的地之間的停靠站就是路徑點位置。詳情請參閱 Fleet Engine 說明文件中的「行程路線點」。
車輛位置	車輛位置是車輛回報的位置。詳情請參閱 Fleet Engine 說明文件中的「車輛位置」一節。

設定地圖樣式

標記和折線樣式會決定地圖上追蹤位置物件的外觀和風格。您可以使用自訂樣式選項，配合網路應用程式的樣式。

控制追蹤位置的瀏覽權限

Fleet Engine 中預先定義的位置資訊供應器會遵循地圖上追蹤位置物件的這些顯示規則。如果您建立自訂或衍生位置供應器，可以變更瀏覽權限規則。

• 車輛只會在行程進行中顯示：行程車輛會從指派給行程到下車時間期間顯示。如果行程取消，車輛就不會再顯示。

• 所有其他地點標記一律顯示：起點、目的地和路線控點的所有其他地點標記一律會顯示在地圖上。舉例來說，無論行程或運送狀態為何，行程下車地點或運送地點一律會顯示在地圖上。

後續步驟

請參閱您要追蹤行程的平台說明文件：

• Android
• iOS
• JavaScript