更新日期： 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:00 之前送货，那么该停靠点的停靠时间就会提前。考虑到所有移动部件，引擎会找到最干净、最精简的路径。
- 输出
一旦完成处理，API 就会发回完整的计划：逐站顺序、每站的预计到达时间、总行程时间以及导航的直接链接。司机无需多想——他们只需点击、驾驶，然后跟随即可。所有这一切只需几秒钟即可完成，无需调度团队手动绘制任何地图。
Zeo 奖励：API 还更新了驾驶员资料。
Zeo 车队游览使用驾驶员信息自动分配停靠点并创建路线。
如何配置路由优化 API
部署 API 听起来很复杂，但清单却简洁明了。只需遵循以下四个步骤，您的路由解决方案即可上线，无需熬夜演习。
认证
从 Zeo 仪表板获取 API 密钥，将其存储在您的机密库中，并在每次调用的标头中传递它。每个环境一个密钥，可将测试数据和实时数据区分开。
端点设置
当路线锁定时，可选的 webhook 会将状态更新推送回您的系统。
- /司机 – 创建或更新驾驶员姓名、电话号码和车辆限制。
- /停止 – 发布带有坐标、包裹数量和服务时间的新订单。
- /优化 – 触发路线构建；接收停靠订单、预计到达时间和地图链接。
数据格式化
使用 JSON——坐标以十进制度为单位，时间以 ISO 8601以及以公斤或磅为单位的重量。如果引擎需要，可以添加自定义字段——“优先级”、“温度”，以实现更智能的路线优化。
测试与验证
首先将您的调用指向 Zeo 的沙盒。触发五个模拟停止，检查响应，调整约束条件，然后重复。如果满意，则将基础 URL 切换至生产环境，并安排夜间批量作业或实时触发器。
结语
路线优化 API 可以在人们悠闲地享用咖啡的同时，将原始订单数据转化为精准的路线。Zeo 的终端为快递员、杂货商、现场技术人员——所有追求更紧凑预计到达时间和更低油费的人们——承担了繁重的工作。
准备好将路线优化纳入您的堆栈了吗？
预订 Zeo 演示，看着订单进入购物车，快速通过 API，并出现在司机的手机上，整个过程比打印标签所需的时间还要短。
您是车队所有者吗？
想要轻松管理您的司机和送货吗？
使用 Zeo Routes Planner 轻松发展您的业务 - 优化路线并轻松管理多名司机。
