本節的說明文件說明如何以 Google 地圖行動隨選行程服務。其假設您熟悉 包括:
- Fleet Engine:熟悉 Fleet Engine 實作方式 詳細資料、要求機制和安全性如需相關資訊,請參閱「什麼是艦隊? 引擎服務?」,以及設定 Fleet Engine 一文所述的安全性主題。
- 適用於隨選服務的車輛基本資訊。詳情請見 車輛簡介。
- 隨選服務的行程基本資訊。請參閱「隨選行程」。
您使用的 TripService
適用於 gRPC 和 REST。
為求簡單,欄位參照會遵循 gRPC 慣例。
在提供隨選服務的 Fleet Engine 中,行程是一種以模型建立模型的旅程
滿足消費者的餐點外送或叫車要求。旅行
隨著歷程演進,您要向 Fleet Engine 回報的狀態,例如
NEW
、ENROUTE_TO_PICKUP
,以及執行其他操作。行程狀態會對應至地理位置
而 Fleet Engine 將這類車輛修改為
每次更新行程時,只要路線控點即可查看機群中的「隨選行程」
引擎基本知識:進一步瞭解行程及與車輛的關係。
旅遊生活
如要追蹤 Fleet Engine 中的每趟行程,您必須先建立 Trip
實體。詳情請參閱 gRPC 或 REST。
下表說明在 並監控 Fleet Engine 中的系統和生命週期階段假設您已設定 這個 Fleet Engine 車輛和一輛車可指派給這趟行程,且提供位置更新通知 在驅動程式應用程式中啟用。請參閱「Driver SDK:隨選行程」。
1 | 接收預訂要求。 | Fleet Engine 行程開始前,預訂系統會先收到
要求消費者透過您的應用程式或其他
預訂系統接著,您的系統使用
CreateTrip ,此為必填欄位,例如取貨地點。
也可以在這個位置設定其他欄位,例如乘客和
或等待車輛指派車輛。詳情請見
建立單一目的地行程。 |
2 | 指派車輛。 | 你可以直接將車輛指派給系統中的行程 並向 Fleet Engine 回報作業,或使用 搜尋車輛 車輛搜尋服務,可同時依行程和車輛篩選資料 屬性找出最適合完成這趟旅程的車輛。任何線上活動 位於您搜尋半徑範圍內的車輛,透過其附近商家得知 Driver SDK 提供的位置更新通知。 當 |
3 | 更新行程。 | 等司機接受行程,並開始導航到
上車地點,系統會更新 NEW 的行程狀態。
至 ENROUTE_TO_PICKUP 。你繼續輪詢車輛
出現在路途中的不同位置
或輪詢 Fleet Engine
透過 Driver SDK 持續掌握車輛位置更新的資料。您的
然後向 Fleet Engine 回報每個歷程里程碑
系統提供的車輛路線控點清單
|
4 | 與消費者分享歷程。 | Fleet Engine 提供行程詳細資料和車輛位置資訊, Consumer SDK,用於接收及顯示行程更新 。Fleet Engine 將在剩餘時間內自動更新 ETA 距離、路線以及其餘車輛路線控點。詳情請見 分享隨選行程的旅程以瞭解更多資訊。 |
5 | 完整行程。 | 當車輛抵達行程的目的地路線點,
駕駛指出行程成功,系統則會
將 TripStatus 至 Fleet Engine 中的 COMPLETE 。保留
但就像車輛一樣,Fleet Engine 仍有效
7 天,之後就會移除。 |
行程序列流程
下圖顯示這個流程的詳細檢視畫面。