更新日期： 2025 年 6 月 18 日
每個包裹、服務電話或雜貨訂單都以數據開始——一個地址、一個時間窗口和一輛足夠載貨的車輛。
路線優化 API 將這些部分組合在一起，並制定一條消耗更少燃料且按時到達客戶家門口的路線。
沒有儀表板，沒有滑鼠拖曳，也沒有程式碼對話。
將您的 ERP、電子商務購物車或預訂工具插入端點，API 將在幾秒鐘內返回逐站計劃。
Zeo Route Planner 就位於這個管道中：它的 API 可以與 Shopify、WooCommerce、Zapier 和許多其他 第三方整合。該工具可確保新訂單在包裝膠帶冷卻之前到達正確的司機。
什麼是路線優化 API？
路線最佳化 API 是一種網路服務，它接受交付資料並傳回最省油、最省時的停靠順序。
它在背景運行，讓任何應用程式無需打開其他工具即可觸發路線規劃。
為何重要
使用路線優化 API，您可以解鎖以下內容：
大量地址攝取
在一個 JSON 負載中提供數百甚至數千個網站。非常適合快遞員、雜貨商以及需要快速到達指定地點的現場服務團隊。
智慧排序
在鎖定路線之前，引擎會權衡距離、交通狀況和法律限制（例如重量或高度）。加急包裹會浮到最上面；低優先包裹則會落到最後。
適合大型船隊
無論五輛貨車或五百輛貨車，API 都能靈活擴充。只需一次調用，即可將工作分配到多個倉庫，平衡行駛里程和駕駛員工作時間。
Zeo 的路線優化 API
使用 Zeo 的路線優化 API，您可以獲得以下效果：
一次通話即可完成訂單到路線的流程
付費訂單觸發 ➜ 您的中間件抓取位址 ➜ POST /stops 將其直接放入 Zeo。
無需電子表格，無需剪下貼上。後續呼叫 POST /optimize 會傳回最佳止損訂單以及預計到達時間 (ETA)。
按需提供駕駛員和車輛資料
使用 POST /drivers 在人力資源部將新快遞員加入薪資單後，立即啟動。標記貨車容量、冷藏或升降門需求，優化器會自動遵循所有限制。
優先權處理和時間窗口
每個站點接受以下字段 priority, service_time以及 time_window。高價值包裹或「中午前送達」的請求會排在最前面，無需調度員接聽電話。
無需打開儀表板即可即時更改路線
下午 2 點訂單取消了？
擊中 刪除 /stops/{id} 並打電話 POST /最佳化 再次。車輪繼續轉動的同時，駕駛在手機上接收更新的路線。
預計抵達時間和送達證明的 Webhook 更新
訂閱 /webhooks/route_completed and /webhooks/pod_uploaded.
您的商店會向客戶發送即時狀態電子郵件，並且支援人員可以在捕獲簽名時立即看到它們。
先沙盒，後生產
每個密鑰都附帶一個臨時基礎 URL。觸發測試有效負載，檢查 JSON 回應，進行調整，然後在數值正確後立即上線。
路線優化 API 如何運作？
讓我們來剖析幕後究竟發生了什麼事。路線優化 API 不僅僅是重新安排站點，它還是一個能夠即時監聽、運算和回應的智慧引擎。
一旦收到訂單，系統就會立即啟動，幾乎不需要人工幹預，建立最合理的路線。
真實世界的流程
購物車向 API 發送訂單；引擎處理資料並傳回有序清單和預計到達時間。倉庫團隊仍在裝貨時，司機可以在手機上查看計劃。
- 輸入
起始點是一個簡單的 JSON 負載，但其內容至關重要。每個站點都包含精確的經緯度、地址、配送時間（例如上午 9 點至 11 點）、卸貨時間以及可用的車輛。您還可以添加諸如“僅限冷藏車”或“易碎包裹”之類的限制條件。這種靈活性使得 API 真正實用——它採用現實世界的條件並將其打包成引擎可以理解的資料。
- 處理中
現在到了最關鍵的時刻。 Zeo 的最佳化引擎會解析這些數據，並開始理解它的意義。
它會檢查當前交通狀況、單行道規則和車輛容量。如果你的貨車限重 100 公斤，而你卻有 120 公斤的包裹，該怎麼辦？
它會將停靠點分配給兩輛車。它還會遵守服務等級協議——如果客戶需要在上午 10 點之前送貨，那麼該停靠點的停靠時間就會提前。考慮到所有移動部件，引擎會找到最乾淨、最精簡的路徑。
- 輸出
一旦完成處理，API 就會發回完整的計畫：逐站順序、每站的預計到達時間、總行程時間以及導航的直接連結。司機無需多想——他們只需點擊、駕駛，然後跟隨即可。所有這些只需幾秒鐘即可完成，無需調度團隊手動繪製任何地圖。
Zeo 獎勵：API 也更新了駕駛員資料。
Zeo 車隊遊覽使用駕駛員資訊自動分配停靠點並建立路線。
如何設定路由優化 API
部署 API 聽起來很複雜，但清單卻簡潔明了。只需遵循以下四個步驟，您的路由解決方案即可上線，無需熬夜演習。
認證
從 Zeo 儀表板取得 API 金鑰，將其儲存在您的機密庫中，並在每次呼叫的標頭中傳遞它。每個環境一個密鑰，可將測試資料和即時資料區分開。
端點設定
當路線鎖定時，可選的 webhook 會將狀態更新推回您的系統。
- /司機 – 建立或更新駕駛員姓名、電話號碼和車輛限制。
- /停止 – 發布帶有座標、包裹數量和服務時間的新訂單。
- /最佳化 – 觸發路線建構；接收停靠訂單、預計到達時間和地圖連結。
數據格式化
使用 JSON－座標以十進制度為單位，時間以 ISO 8601以及以公斤或磅為單位的重量。如果引擎需要，可以添加自訂欄位——“優先級”、“溫度”，以實現更智慧的路線最佳化。
測試XXXXXXX
首先將您的呼叫指向 Zeo 的沙盒。觸發五個模擬停止，檢查反應，調整約束條件，然後重複。如果滿意，則將基礎 URL 切換至生產環境，並安排夜間批量作業或即時觸發器。
結語
路線優化 API 可以在人們悠閒地享用咖啡的同時，將原始訂單數據轉化為精準的路線。 Zeo 的終端機為快遞員、雜貨商、現場技術人員——所有追求更緊湊預計到達時間和更低油費的人——承擔了繁重的工作。
準備好將路線優化納入您的堆疊了嗎？
預訂 Zeo 演示，看著訂單進入購物車，快速通過 API，並出現在司機的手機上，整個過程比列印標籤所需的時間還要短。
您是車隊車主嗎？
想要輕鬆管理您的司機和送貨嗎？
使用 Zeo Routes Planner 輕鬆發展您的業務 - 優化路線並輕鬆管理多名司機。
