舰队跟踪概览

JavaScript 车队追踪库适用于以下用例:

  • 按需行程
  • 定时任务

本指南介绍了如何将此库用于这两项服务。

借助 JavaScript 车队跟踪库,您可以让车队运营商近乎实时地直观了解其车队中车辆的位置。如果车辆的路线已知,地图视图组件会以动画形式显示该车辆沿其预测路径移动。

车队跟踪地图视图示例

什么是车队跟踪?

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

  • 让按需行程运营商能够跟踪多辆车的行程进度。
  • 让定期运输运营商能够在基于 Web 的地图上近乎实时地查看车队运输进度。

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

为何要使用车队跟踪?

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

车队跟踪有哪些用途?

借助车队跟踪库中的信息,您可以使用以下功能创建车队运营的丰富视图:

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

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

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

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

组件

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

按需行程

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

车辆位置信息提供程序会显示单个车辆的位置信息。其中包含有关车辆位置、航点以及分配给车辆的行程的信息。

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

  • 车辆:车辆在 Fleet Engine 中创建后即会显示,并且在 vehicle_state 为 Online 时也会显示。这意味着,即使车辆当前未分配行程,也可以显示。
  • 航点标记:规划的车辆航点在地图上显示为起点、中间点和终点标记。
自定义选项 借助车辆位置信息提供程序选项,您可以提供多段线和标记自定义设置。您可以为多段线设置颜色和样式,以显示车辆的各种实际场景,例如行驶路线和路况。您可以针对不同用途自定义标记。您还可以为多段线和标记添加点击处理。
车辆事件监听器 事件监听器可让运营商获取车辆完成的行程的相关信息。
车队位置信息提供程序 车队位置信息提供程序会显示多辆配送车辆的位置信息。跟踪车队时,您可以设置地理边界,还可以选择按车辆 ID 进行过滤。

定时任务

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

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

以下是配送车辆、停靠点及其任务的公开范围规则:

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

如何使用车队跟踪

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

后续步骤