什么是 Fleet Engine 服务?

Fleet Engine 是一项后端服务,可与您用于登录 为客户管理运输服务。它可与各种 API 和 SDK 互操作,以增强地图绘制、路线规划和位置管理功能。

Fleet Engine 提供车辆的路线和状态更新 对实体车队进行建模。当系统发送车辆时 Fleet Engine 的进度更新,Fleet Engine 使用实时车辆位置信息 和路线信息,以提供准确的报告 例如预计到达时间、路况信息和车辆状况。

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 车队跟踪库,便于车队操作员更好地进行协调 并全天管理车辆分配。
  • 增强您的驾驶员的体验:驱动程序 SDK 是一款移动应用工具包 也是 Fleet Engine 的基本组件。它使用车辆的功能。借助此 SDK,您的驾车应用既可以管理工作分配,又可以启用驾驶员导航和路线功能。该 SDK 的核心是,当您的司机开始驾驶时,使用事件监听器将位置信息更新发送到车队引擎。它还会向车队引擎发送有关车辆状态的信号。借助此 SDK,您的司机可以使用一个应用来管理 分配和导航,就像使用 但无需切换到其他应用。

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

按需行程

  • 驾驶员车辆的实时道路贴靠位置。
  • 包含实时路况信息的实际驾驶员路线。
  • 上车点和下车点的预计到达时间。
  • 跟踪单程、多目的地和返程行程。
  • 多位顾客在同一条路线上拼车。
  • 列出特定地区的所有车辆,以找到最佳车辆 匹配。

计划任务

  • 地图上呈现的实时位置信息更新。
  • 自动调整的预计到达时间,可反映不断变化的情况,例如交通状况。
  • 已完成的任务和待处理的停靠点可帮助您深入了解 问题。
  • 增加经停次数和距离,让客户增加 自信。

Fleet Engine 的工作原理

本部分概述了 Fleet Engine 的运行情况 不同系统。

按需行程

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

计划任务

下图以矩阵形式显示了单个订单的 驱动程序及其在 Fleet Engine 系统中的处理方式 舰队跟踪库。

注意:您的系统可以同时使用运输跟踪或车队跟踪。包含 Fleet Engine 会过滤送货和司机信息 客户只能看到与其物流相关的信息。

Fleet Engine 架构

本部分介绍了适用于不同 Fleet Engine 的系统架构 产品/服务。两种服务均使用以下功能:

  • 车辆:即时行程和预约任务依赖于车辆,以模拟贵商家用于执行运营的真实车辆。在车队引擎中,车辆实体通过与 Driver SDK 集成的驾驶员应用接收其关联的真实车辆提供的位置信息。Fleet Engine 车辆主要 并行实体,两者之间存在一些差异。 阅读车辆简介,了解 Fleet Engine 中的车辆。
  • Driver SDK:对于按需和安排的任务,Driver SDK 都是基本组件。Driver SDK 可与您的驾驶员应用集成,并向车队引擎提供位置信息流以及路线信息(车队引擎依赖于这些信息来报告行程的实时状态),以及 ETA 和交通数据等其他信息。
  • 消费者 SDK:对于按需任务和计划任务而言,这项关键优势 是消费者 SDK,用于向消费者报告其 例如约车、送餐或定时包裹递送。

按需行程

有关车辆、行程和 SDK 的说明,请参阅 按需行程的文档:

  1. 车辆简介
  2. 按需行程
  3. 适用于按需行程的驱动程序 SDK
  4. 适用于按需行程的消费者 SDK

计划任务

有关交付车辆、任务和 SDK 的说明,请参阅 计划任务的相关文档:

  1. 车辆简介
  2. 计划任务
  3. 适用于定时任务的 Driver SDK
  4. 适用于安排的任务的使用方 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 中的资源命名

与所有基于 Google Cloud 的服务一样,在 Fleet Engine 中,资源具有唯一的 名为 names 的标识符,以字符串格式提供。该资源名称的一部分是资源 ID,您在发出创建请求时提供该 ID。不过,舰队引擎资源没有 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 服务和组件需要来自 车队。设计、开发应用并将其部署到 司机可能需要一些时间。因此,最好先使用模拟数据探索集成,然后再进行全面部署。如需了解详情,请参阅设置车队引擎

后续步骤

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