舰队跟踪概览

JavaScript Fleet Tracking 库适用于以下使用情形:

  • 按需行程
  • 计划任务

本指南讨论了如何将此库用于这两种服务。

借助 JavaScript 车队跟踪库,您可以让车队运营方近乎实时地直观了解车队中车辆的位置。 如果车辆的路线已知,地图视图组件会随着车辆沿其预测路径移动而为该车辆添加动画效果。

车队跟踪地图视图示例

什么是车队跟踪?

舰队跟踪是 Fleet Engine 的一项功能,专为车队运营商而设计。它提供用于在 Fleet Engine 中对车队数据进行建模和跟踪的接口,并提供用于为车队经理创建基于 Web 的丰富地图显示界面的类,以显示行程信息。例如:

  • 允许按需行程运营商跟踪多辆车的行程进度。
  • 让预定送货的运营商能够在基于网络的地图上近乎实时地查看车队送货进度。

您将该库集成到 Web 应用中,并在 Fleet Engine 中设置适当的角色配置文件,以支持与消费者分享行程。如需详细了解 Fleet Engine 中的角色,请参阅服务账号角色

为何要使用车队跟踪?

将车队跟踪功能集成到车队运营中后,您将获得全面的车辆监控体验,并能近乎实时地了解车辆位置信息。您可以在地图上查看一支或所有车队的车辆位置,包括有助于您了解车队表现的停靠点或途经点详细信息。

车队跟踪功能有哪些用途?

借助舰队跟踪库提供的信息,您可以利用以下功能创建丰富的舰队运营视图:

  • 根据需要对车队跟踪地图界面进行个性化自定义。

  • 查看单辆、多辆或所有车辆在沿路线行驶时的当前位置,其位置会定期更新。

  • 计算行程或送货的预计到达时间以及剩余距离。

  • 查看车辆进度,包括已完成的行程或任务状态。

组件

下表介绍了车队跟踪中使用的组件及其用途。

按需行程

组件 说明
旅程分享地图视图 行程分享地图视图会显示车辆的位置及其行程。如果 Fleet Engine 知道车辆的路线,地图视图组件会在车辆沿其预测路径移动时为其添加动画效果。
车辆位置提供器

车辆位置信息提供程序显示单个车辆的位置信息。它包含车辆位置、途经点和分配给车辆的行程的相关信息。

以下是车辆及其途经点标记的可见性规则:

  • 车辆:车辆在 Fleet Engine 中创建后立即可见,并且当 vehicle_stateOnline 时可见。这意味着,即使车辆当前未分配任何行程,也可以显示。
  • 途经点标记:地图上会显示计划的车辆途经点,包括起点、中间点和目的地标记。
自定义选项 借助车辆位置信息提供程序选项,您可以自定义多段线和标记。您可以为多段线着色并设置样式,以显示车辆的各种实际情况,例如行驶路线和交通状况。您可以根据不同用途自定义标记。您还可以为多段线和标记添加点击处理功能。
车辆事件监听器 借助事件监听器,运营商可以获取有关车辆完成的行程的信息。
车辆车队位置信息提供商 车队位置信息提供程序会显示多辆送货车辆的位置信息。在跟踪车队时,您可以设置地理边界,还可以选择按车辆 ID 进行过滤。

计划任务

组件 说明
旅程分享地图视图 行程分享地图视图会显示送货车辆和任务的位置。如果 Fleet Engine 知道车辆的路线,地图视图组件会在车辆沿其预测路径移动时为其添加动画效果。
送货车辆位置信息提供商

送货车辆位置信息提供程序会显示单个送货车辆的位置信息。它包含有关车辆位置、停靠站以及配送车辆完成的任务的信息。

以下是配送车辆、配送站及其任务的可见性规则:

  • 车辆:配送车辆在 Fleet Engine 中创建后立即可见,并且在整个路线中都可见,无论其任务如何。
  • 停靠站:地图上会以车辆停靠站标记的形式显示规划的车辆停靠站。已完成任务的标记会以不同于车辆规划停靠点的样式显示。
  • 任务:任务结果的位置会显示任务结果标记。结果为 SUCCEEDED 的任务会显示成功任务标记,而所有其他任务会显示不成功任务标记。
自定义选项 借助配送车辆位置信息提供程序选项,您可以提供多段线和标记自定义设置。您可以为多段线着色并设置样式,以显示车辆的各种实际场景,例如车辆的有效路线。您可以自定义标记,以用于不同目的,例如用于送货车辆。您还可以为多段线和标记添加点击处理功能。
交付任务过滤器 借助任务过滤条件,操作员可以按指定时间之前或之后完成的任务过滤视图,也可以按待处理任务或已关闭的任务进行过滤。
送货车辆事件监听器 借助事件监听器,运营商可以获取有关配送车辆完成的行程段的信息,以及车辆服务的任务列表。
配送车队位置信息提供程序 配送车队位置信息提供程序会显示多辆配送车辆的位置信息。您可以过滤以显示特定送货车辆及其位置,也可以显示整个车队的车辆位置。

如何使用车队跟踪功能

1 在 JavaScript 中设置车队跟踪。 如需了解详情,请参阅设置 JavaScript 车队跟踪库
2 加载库并初始化地图。 如需了解详情,请参阅加载库并初始化地图视图
3 提供车辆位置并设置地图视图。 若要开始跟踪车辆,请使用正确的车辆 ID 实例化位置信息提供程序,并使用该提供程序初始化地图视图。如需了解详情,请参阅提供车辆位置
5 更新车队进度并处理行程错误。 如需了解详情,请参阅更新机群进度处理错误
5 结束一天的工作后,停止跟踪车队车辆。 如需了解详情,请参阅停止跟踪送货车辆

后续步骤