允许用户跟踪预定送货或服务订单的进度,从而为预定任务量身打造用户体验。
什么是预定任务的 Consumer SDK?
Consumer SDK 是 Fleet Engine 中用于预定任务的一项功能,其中还包含用于打造用户体验的工具包。借助这些工具包,您可以创建基于地图的显示界面,以直观呈现司机的进度,并显示与预定停靠点关联的任务的状态。该 SDK 主要面向以下两类用户:
- 想要了解单个货运订单的送货状态的用户最终用户 。本文档介绍了如何使用 JavaScript 中的 Consumer SDK 实现该用户体验,该 SDK 提供了
FleetEngineShipmentLocationProvider类和关联的接口。 - 想要跟踪整个车队的送货和车辆状态的车队运营商 。如需了解如何跟踪车队,请参阅 车队跟踪指南。

为何使用预定任务的 Consumer SDK?
将 Consumer SDK 集成到预定任务用户应用中后,您可以提供全面的用户体验,包括近乎实时的位置信息更新和道路贴合位置。您的用户可以查看送货车辆的位置和进度详情,从而了解货件的所在位置。
您可以使用 Consumer SDK 做什么?
使用 Consumer SDK 与用户分享以下货件信息:
- 送货车辆在地图上的实时位置。
- 包裹预计送达时间,并根据交通状况等变化情况进行调整。
- 车辆行驶的路线。
- 在货件送达之前剩余的距离和停靠点数量。
您还可以根据 Driver SDK 中的位置信息,在消费者应用或网站内打造其他无缝的地理位置信息用户体验。如需详细了解 Driver SDK,请参阅 Driver SDK 预定任务概览。
Consumer SDK 组件
JavaScript Consumer SDK 包含以下组件:
- 一个 JavaScript 地图组件,可直接替换标准
google.maps.Map实体。 - 用于连接 Fleet Engine 的数据组件。
- 用于直观呈现车辆和路线的组件,以便用户了解车辆前往目的地的进度。
- 用于显示骑手预计送达时间或剩余行驶距离的原始数据 Feed。
下表介绍了这些组件。
| 组件 | 说明 |
|---|---|
| 地图视图 | 地图视图会直观呈现车辆的进度,并在车辆沿路线行驶时更新视图。 |
| 货件位置信息提供方 | 货件跟踪提供方提供位置信息 Feed,以便地图显示有关货件的实用信息,例如货件的取货或送货地点,以及送货车辆的位置和路线。 |
| 身份验证令牌提取器 | 身份验证令牌提取器从后端服务器获取 JSON Web 令牌 (JWT),以验证对 Fleet Engine 中存储的位置数据的访问权限。您可以使用 JavaScript 行程共享库将身份验证令牌提取器作为 Web 应用的一部分来实现。请注意,您还必须在后端服务器上为 Fleet Engine 实现 JSON Web 令牌 (JWT) 创建服务。 |
| 地图样式选项 | 您可以使用自定义样式选项更改地图的默认样式,使其与 Web 应用的样式相匹配。 |
如何使用 Consumer SDK
| 1 | 设置 JavaScript Consumer SDK | 如需了解详情,请参阅设置 JavaScript Consumer SDK。 |
| 2 | 跟踪货件 | 了解如何初始化地图、开始跟踪货件以及停止 跟踪并进行适当的清理。请参阅 跟踪货件。 |
| 3 | 自定义地图界面 | 您可以使用预定任务的 JavaScript Consumer SDK 自定义地图界面、提供标记自定义功能或设置 折线的样式。请参阅 设置地图样式、 自定义标记、 和自定义折线。 |