使用方 SDK 计划任务概览

允许消费者跟踪其预定配送或服务订单的进度,从而为预定任务量身定制消费者体验。

什么是适用于预定任务的 Consumer SDK?

Consumer SDK 是 Fleet Engine 的一项功能,用于执行预定任务,其中还包含用于打造消费者体验的工具包。借助这些工具包,您可以创建基于地图的显示画面,以直观呈现司机的进度,并显示与预定经停点关联的任务的状态。它专为两类主要受众群体而设计:

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

跟踪预定配送任务的示例 Web 应用

为何要使用 Consumer SDK 执行预定任务?

通过将 Consumer SDK 集成到您的预约任务消费者应用中,您可以提供全面的消费者体验,包括近乎实时的位置信息更新和贴合道路的位置。您的消费者可以查看配送车辆的位置和进度详情,从而了解其配送货物的位置。

您可以使用 Consumer SDK 做些什么?

使用 Consumer SDK 与消费者分享以下配送信息:

  • 地图上配送车辆的实时位置。
  • 包裹预计送达时间,会根据交通状况等变化进行调整。
  • 车辆正在行驶的路线。
  • 距离送达还有多远,以及还要停靠多少站。

您还可以根据 Driver SDK 提供的位置信息,在消费者应用或网站中打造其他顺畅的地理位置感知型消费者体验。如需详细了解 Driver SDK,请参阅 Driver SDK 计划任务概览。

Consumer SDK 组件

JavaScript 消费者 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 消费者 SDK 如需了解详情,请参阅设置 JavaScript 消费者 SDK。
2 跟踪物流信息 了解如何初始化地图、开始跟踪配送以及停止跟踪并进行适当的清理。请参阅跟踪物流信息。
3 自定义地图界面 您可以使用 JavaScript 消费者 SDK 执行预定任务,以自定义地图界面、提供标记自定义或设置多段线样式。请参阅设置地图样式、自定义标记和自定义多段线。

后续步骤