架構與元件

如要實作行程和訂單進度，必須使用數個隨選乘車和配送解決方案元件：Fleet Engine、Consumer SDK 和 Driver SDK：

  • Fleet Engine 是「隨選乘車與運送服務」解決方案後端服務，負責管理行程和車輛狀態。它會處理 Driver SDK、Consumer SDK 和您的後端服務之間的交易，後者可透過發出 REST 或 gRPC 呼叫與 Fleet Engine 通訊。

  • Consumer SDK 是可整合至消費者應用程式的用戶端程式庫，負責提供分享旅程體驗，包括追蹤駕駛路線、剩餘距離和預計到達時間。Consumer SDK 可用於行動裝置 (Android 或 iOS) 或網頁 (JavaScript)。

  • Driver SDK 是可整合至驅動程式應用程式的用戶端程式庫。該程式庫負責更新 Fleet Engine 的驅動程式位置、路線、剩餘距離和預計到達時間。這個版本也納入了 Navigation SDK，為驅動程式提供即時路線導航指示。詳情請參閱「Google 地圖導航」一文。

以下架構圖顯示這些元件之間的關係：

架構

行程、車輛和路線控點

建立行程和訂單進度應用程式涉及使用行程、車輛和路線控點。

行程

行程代表一段旅程，也就是將消費者 (或訂購的餐點) 從上車地點運送至下車地點的行程，包括沿途中間的路線控點。

透過程式輔助方式，Trip 物件會封裝上車地點、目的地、車輛目前位置、行駛路線、中繼路線控點和行程類型 (專屬或共用)。

交通工具

車輛是指車隊中的一輛車。透過程式輔助方式，Vehicle 物件會封裝車輛的位置、目前行程清單和目前路線控點清單。

路點

路線控點代表路線沿途的地點。可能是上車地點、下車地點，或僅供通過的里程碑。透過程式輔助方式，Waypoint 物件會以一組地理座標、路線控點和包含路線控點的行程 ID，納入路線控點的位置。

行程和車輛都包含路線控點：

  • 行程的一組路線控點包含與行程相關的所有路線控點。如果行程與其他行程共用，其中可能包含其他行程的路線控點。

  • 車輛的一組路線控點包含車輛的所有剩餘路線控點，包括多趟行程的路線控點。

流程範例

下圖顯示一般行程和訂單進度流程。詳情請參閱「建立及顯示單一目的地行程」。

序列圖表

下列步驟說明如何設定範例流程：

  1. 建立車輛、啟用位置資訊分享功能，然後將車輛狀態設為「線上」。您可以透過 Fleet Engine 打造車輛，您可以透過機群引擎或驅動程式 SDK，將車輛狀態設為「online」。

  2. 媒合客戶和你的車輛。您可以使用 SearchVehicles() 方法，從車隊中尋找可能的車輛。

  3. 在 Fleet Engine 中建立行程、將車輛指派給該行程、將該行程與消費者應用程式建立關聯，並為司機提供上車和下車地點。

  4. 驅動程式 SDK 會在行程期間自動更新預計到達時間、距離和路徑。你必須負責更新行程狀態。

如要開始導入行程和訂單進度，請參閱「建立及顯示單一目的地行程」。