Fleet Engine 是一项后端服务 ,可与您用于管理客户运输服务的系统集成。它可与各种 API 和 SDK 互操作,以增强地图、路线和位置管理功能。
Fleet Engine 可为根据您的真实车队建模的车辆实体提供路线和状态更新。当您的系统向 Fleet Engine 发送车辆进度更新时,Fleet Engine 会使用 Driver SDK 提供的实时车辆位置和路线信息,提供有关车辆行程的准确报告:预计到达时间、路况信息和车辆可用性。
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 地图一样,但无需切换到其他应用。
更具体地说,您可以借助这些解决方案提供以下内容:
按需行程
- 司机车辆的实时路况位置。
- 包含实时路况信息的实际司机路线。
- 上车和下车地点的预计到达时间。
- 跟踪单目的地、多目的地和连续行程。
- 为同一路线上的多位客户提供拼车服务。
- 列出特定区域内的所有车辆,以便为请求的行程找到最佳 匹配项。
计划任务
- 在地图上呈现实时位置信息更新。
- 自动调整预计到达时间,以反映不断变化的情况, 例如路况。
- 已完成的任务和待处理的停靠点,以便深入了解可能存在的问题 。
- 停靠点数量和距离,以便客户更加放心 。
Fleet Engine 的工作原理
本部分概述了每种出行服务产品的 Fleet Engine 系统的运作方式。
按需行程
下图显示了按需行程的两个关键部分:司机启用位置信息共享功能以向 Fleet Engine 共享位置信息的一天开始,以及使用 Fleet Engine 组件的行程管理简化视图。如需详细了解行程流程,请参阅 什么是行程? in the On-demand trips documentation.
计划任务
下图显示了单个 司机典型配送工作日的矩阵,以及如何使用 Fleet Tracking 库在 Fleet Engine 系统中处理其工作。
注意:您的系统可以使用配送跟踪或车队跟踪。借助 配送跟踪,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,请参阅按需行程的相关 文档:
计划任务
如需了解配送车辆、任务和 SDK,请参阅 相关文档:
资源
按需行程
| 车辆 | ||
|---|---|---|
| 服务 | REST: v1.providers.vehicles
gRPC: maps.fleetengine.v1.VehicleService |
|
| 资源名称 | providers/{provider}/vehicles/{vehicle} |
|
| 行程 | ||
| 服务 | REST: v1.providers.trips
gRPC: maps.fleetengine.v1.TripService |
|
| 资源名称 | providers/{provider}/trips/{trip} |
|
计划任务
| 配送车辆 | ||
|---|---|---|
| 资源 | REST: providers.deliveryVehicles
gRPC: maps.delivery.v1 |
|
| 资源名称 | providers/{provider}/deliveryVehicles/{vehicle} |
|
| 任务 | ||
| 服务 | REST: providers.tasks
gRPC: maps.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:集合包含资源或其他集合。
按需行程
三个集合:providers、
vehicles 和 trips。
计划任务
三个集合:providers、deliveryVehicles 和 tasks。
资源 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。 |
后续步骤
- 了解 Fleet Engine 车辆。
- 了解按需行程或计划任务。
- 设置 Fleet Engine。