什么是 Fleet Engine 服务?

Fleet Engine 是一项后端服务,可与您用于管理客户运输服务的系统集成。它可与各种 API 和 SDK 互操作,以增强地图、路线和位置管理功能。

Fleet Engine 可为根据实际车辆车队建模的车辆实体提供路线规划和状态更新。当您的系统向 Fleet Engine 发送车辆进度更新时,Fleet Engine 会使用 Driver SDK 提供的实时车辆位置和路线信息,提供有关车辆行程的准确报告:预计到达时间、路况信息和车辆可用性。

Fleet Engine

Fleet Engine 服务可与以下两种出行服务产品搭配使用:

  • 按需行程:在此服务中,Fleet Engine 会对行程的生命周期进行建模,包括从起点到经停点再到下车点的整个过程。在行程生命周期中,车辆会经过上车地点、中间途经点和下车地点,以完成消费者通过请求预订的行程。如需详细了解按需行程,请参阅按需行程文档。
  • 预定任务:在此产品中,Fleet Engine 会对配送或服务任务的生命周期进行建模,其中行程中的每个停靠点都需要司机完成一项或多项预定任务。任务可以包括送包裹或完成服务调用。如需详细了解预定任务,请参阅预定任务文档。

Fleet Engine 的用途

借助 Fleet Engine 组件,您可以执行以下操作:

  • 启用消费者行程跟踪:对于按需行程,您可以使用 Fleet Engine 的消费者体验功能,并将 Consumer SDK 集成到您的移动应用或 Web 应用中。这样,您的消费者就可以使用同一应用来发出行程请求并跟踪行程。
  • 为客户提供实时包裹信息:对于预定任务,您可以使用 Fleet Engine 的消费者体验功能,并将 JavaScript Consumer SDK 集成到您的 Web 应用中。这样一来,您的消费者就可以近乎实时地了解包裹的状态。该 SDK 提供内置的过滤条件和数据隐私保护功能,以便消费者仅看到与其订单相关的信息。
  • 设计车队运营者解决方案:对于预定任务,请使用 JavaScript 车队跟踪库,以便车队运营者更好地协调和管理全天的车辆分配。
  • 提升驾驶员体验:Driver SDK 是一款移动应用工具包,也是 Fleet Engine 的基本组件。它使用车辆中的功能。借助此 SDK,您的驾驶应用既可以管理工作分配,也可以启用驾驶员导航和路线规划功能。从根本上讲,当司机开始驾驶时,SDK 会使用事件监听器将位置更新信息发送到 Fleet Engine。它还会向 Fleet Engine 发送有关车辆状态的信号。借助此 SDK,司机可以使用单个应用来管理任务和导航,就像使用其消费者版 Google 地图一样,但无需切换到其他应用。

更具体地说,您可以利用这些解决方案提供以下内容:

按需行程

  • 驾驶员车辆的实时贴合道路位置。
  • 包含实时路况信息的实际驾驶员路线。
  • 上车点和下车点的预计到达时间。
  • 跟踪单目的地行程、多目的地行程和连续行程。
  • 多位客户在同一路线上的拼车行程。
  • 列出特定区域内的所有车辆,以便为乘客找到最合适的车辆。

计划任务

  • 在地图上呈现实时位置信息更新。
  • 自动调整的 ETA,可反映不断变化的情况(例如交通状况)。
  • 已完成的任务和待处理的停止,以便深入了解可能存在的问题。
  • 停靠站数量和距离,以便客户更加放心。

Fleet Engine 的运作方式

本部分简要介绍了 Fleet Engine 系统针对每种出行服务的运作方式。

按需行程

下图显示了按需行程的两个关键部分:司机启用位置信息共享功能以向 Fleet Engine 共享位置信息的一天开始时间,以及使用 Fleet Engine 组件的简化行程管理视图。 如需详细了解行程流程,请参阅什么是行程? 按需行程文档中。

计划任务

下图显示了单个司机的典型送货工作日矩阵,以及 Fleet Engine 系统如何使用 Fleet Tracking 库处理其工作。

注意:您的系统可以同时使用货件跟踪和车队跟踪。借助配送跟踪功能,Fleet Engine 会过滤配送和司机信息,以便客户仅看到与其配送相关的信息。

Fleet Engine 架构

本部分介绍了不同 Fleet Engine 产品的系统架构。这两项服务均使用以下内容:

  • 车辆:按需行程和预定任务依赖于车辆,用于对业务中用于执行运营的实际车辆进行建模。在 Fleet Engine 中,车辆实体通过与 Driver SDK 集成的驾驶员应用接收其关联的真实世界车辆提供的位置信息。Fleet Engine 车辆在很大程度上是这两种服务之间的并行实体,但也有一些区别。请阅读车辆简介,了解 Fleet Engine 中的车辆。
  • Driver SDK:无论是按需任务还是预定任务,Driver SDK 都是基本组件。Driver SDK 与您的司机应用集成,并向 Fleet Engine 提供位置更新信息流以及 Fleet Engine 报告行程实时状态所依赖的路线信息,以及预计到达时间和路况数据等其他信息。
  • Consumer SDK:对于按需任务和预定任务,Consumer SDK 的主要优势在于,它可用于向消费者报告其行程、食品配送或预定包裹配送的状态。

按需行程

如需了解车辆、行程和 SDK,请参阅有关按需行程的相关文档:

  1. 车辆简介
  2. 按需行程
  3. 适用于按需行程的 Driver SDK
  4. 面向按需行程的 Consumer SDK

计划任务

如需了解送货车辆、任务和 SDK,请参阅有关预定任务的相关文档:

  1. 车辆简介
  2. 计划任务
  3. 用于安排任务的 Driver SDK
  4. 用于安排任务的 Consumer SDK

资源

按需行程

交通工具
服务 RESTv1.providers.vehicles
gRPCmaps.fleetengine.v1.VehicleService
资源名称 providers/{provider}/vehicles/{vehicle}
行程
服务 RESTv1.providers.trips
gRPCmaps.fleetengine.v1.TripService
资源名称 providers/{provider}/trips/{trip}

计划任务

配送车辆
资源 RESTproviders.deliveryVehicles
gRPCmaps.delivery.v1
资源名称 providers/{provider}/deliveryVehicles/{vehicle}
任务
服务 RESTproviders.tasks
gRPCmaps.fleetengine.delivery.v1.Task
资源名称 providers/{provider}/tasks/{task}

Fleet Engine 中的资源命名

在 Fleet Engine 中,与所有基于 Google Cloud 的服务一样,资源具有称为 names 的唯一标识符,以字符串格式提供。该资源名称的一部分是资源 ID,您可以在发出创建请求时提供该 ID。不过,Fleet Engine 资源没有 ID 字段,而是有一个仅输出的名称字段,其中包含资源 ID。

Fleet Engine 使用相对资源名称。这些 ID 由集合 ID 和资源 ID 组成,以指示其层次结构的方式进行结构化。

  • 集合 ID:集合用于存放资源或其他集合。

按需行程

三个集合:providersvehiclestrips

计划任务

三个集合:providersdeliveryVehiclestasks

资源 ID:参考文档中的资源标识符在名称字段中以英文大括号表示。这些变量用于存储您在发出创建请求时提供的 ID。

按需行程

  • {provider}:您的 Cloud 项目 ID。每个项目创建一次。
  • {vehicle}:您的车辆资源,用于每次车辆创建,通常会针对同一司机-车辆对重复使用。
  • {trip}:您的出行资源,用于每次出行,通常不会重复使用。

计划任务

  • {provider}:您的 Cloud 项目 ID。每个项目只需创建一次。
  • {vehicle}:您的送货车辆资源,用于每次车辆创建,通常会针对同一司机-车辆对重复使用。
  • {task}:您的任务资源,用于每个任务,通常不会重复使用。

如需了解详情,请参阅 Google Cloud API 文档中的资源名称

Fleet Engine 的 Google Cloud 日志

Fleet Engine 提供了一项基本日志记录服务,可用于保存其 API 请求和响应载荷。借助这些日志,您可以调试集成、创建监控指标并分析流量模式。

如需了解详情,请参阅 Cloud Logging

如何使用 Fleet Engine

1 设置 Cloud 项目。

在此步骤中,您将创建各种服务账号角色,并启用相关 API。

Fleet Engine API 和 SDK 需要使用通过 Cloud 控制台创建的服务账号签名的 JSON Web 令牌 (JWT)。按照创建 Fleet Engine 项目中的说明操作。如需更好地了解这些角色,请参阅服务账号角色

2 验证您的设置 创建服务账号后,验证设置是否已完成,以及您是否可以创建车辆。此步骤可确保您已解决项目设置期间可能出现的常见授权问题。请按照验证设置下的指南操作。
3 创建您的第一个历程 这包括创建一个具有一组坐标的单个车辆,这些坐标代表按需行程或预定任务中的停靠点。如需了解详情,请参阅按需行程预定任务的概览内容。
4 测试您的集成 Fleet Engine 服务和组件需要来自车队的实时数据。为整个司机群体设计、开发和部署应用可能需要花费一些时间。因此,最好先使用模拟数据探索集成,然后再进行大规模部署。如需了解详情,请参阅设置 Fleet Engine

后续步骤

  1. 了解 Fleet Engine 车辆
  2. 了解按需行程预定任务
  3. 设置 Fleet Engine