使用方 SDK 计划任务概览

允许用户跟踪预定送货或服务订单的进度,从而为预定任务量身打造用户体验。

什么是预定任务的 Consumer SDK?

Consumer SDK 是 Fleet Engine 中用于预定任务的一项功能,其中还包含用于打造用户体验的工具包。借助这些工具包,您可以创建基于地图的显示界面,以直观呈现司机的进度,并显示与预定停靠点关联的任务的状态。该 SDK 主要面向以下两类用户:

  • 想要了解单个货运订单的送货状态的用户最终用户 。本文档介绍了如何使用 JavaScript 中的 Consumer SDK 实现该用户体验,该 SDK 提供了 FleetEngineShipmentLocationProvider 类和关联的接口。
  • 想要跟踪整个车队的送货和车辆状态的车队运营商 。如需了解如何跟踪车队,请参阅 车队跟踪指南

跟踪预定货件任务的示例 Web 应用

为何使用预定任务的 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 自定义地图界面、提供标记自定义功能或设置 折线的样式。请参阅 设置地图样式自定义标记、 和自定义折线

后续步骤