舰队跟踪概览

JavaScript 舰队跟踪库适用于以下用例:

  • 按需行程
  • 计划任务

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

借助 JavaScript 舰队跟踪库,您可以让舰队运营商能够近乎实时地直观呈现其舰队中车辆的位置。 如果知道车辆的路线,地图视图组件会在车辆沿预测路径移动时为其添加动画效果。

车队跟踪地图视图示例

什么是舰队跟踪?

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

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

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

为何要使用舰队跟踪?

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

您可以使用舰队跟踪执行哪些操作?

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

  • 根据需要个性化定制舰队跟踪地图界面。

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

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

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

组件

下表介绍了舰队跟踪中使用的组件及其功能。

按需行程

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

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

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

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

计划任务

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

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

以下是 送货车辆、停靠点及其任务的可见性规则:

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

如何使用舰队跟踪

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

后续步骤