简介:创建车辆

有关车辆在 Fleet Engine 中的工作原理的一般信息,请参阅 请参阅 Fleet Engine 重要部分中的指南:

本部分中的文档介绍了如何在 Google Cloud 控制台中创建和管理车辆 Fleet Engine。在 Fleet Engine 服务器环境中创建车辆 真实反映您实际操作中的车辆您的舰队引擎 还应该与您在后端系统中使用的 名称一致 用于车辆分配和路线。

您可以使用 create 方法通过 gRPC 或 REST 创建车辆资源。 为简单起见,本指南中的字段名称使用 gRPC 表示法。

按需行程

计划任务

车辆请求

对于按需任务和计划任务功能,您可以创建和更新 来发送包含字段的请求消息,总结如下:

  1. 父级:与您的 Google Cloud 项目 ID 关联的字符串,用于 来填充车辆实例的名称字段。
  2. 车辆的 ID:用于填充 name 的唯一字符串 车身区域。

  3. 车辆实例及其必填字段。这些字段取决于 您使用的 Fleet Engine 功能。

请求正文中的信息因请求的性质而异。请参阅 请查看其各自的指南。

身份验证和授权令牌

向 Fleet Engine 发出的请求还必须提供正确的访问凭据。 本指南中的示例做了以下假设:

  • gRPC 示例假定使用 Java 版授权库
  • REST 示例展示了 HTTP 请求标头,该标头必须包含 字段 Authorization,值为 Bearer <token>,其中 <token>您颁发的 JSON Web 令牌

如需了解详情,请参阅设置 Fleet Engine 指南。

车辆资源字段

车辆资源具有以下种类的字段:

  • 仅限输出的字段。由服务设置为 另一种方法,并且不能直接设置。其中的一个重要字段 type 是 name 字段。Fleet Engine 会忽略为 车辆的 name 字段(根据 Google AIP 的指导,针对用户指定) ID。如果您为这些字段提供了值,Fleet Engine 返回一个错误。
  • 必填字段。在按需行程服务中创建的车辆需要 在创建时设置特定字段在计划中创建的车辆 任务服务没有必需的车辆资源字段。
  • 选填字段。两种服务都有在创建时设置的字段 还是后续操作您可以在本单元的相应参考指南中找到 您使用的服务。

车辆名称(仅限输出)

按需行程和计划任务的 name 字段完全相同 服务。Fleet Engine 根据 您在创建车辆时设置的两个字段:

  • 父级:与 providers/{provider} 格式,其中 {provider} 是您的云 ID 项目。您为给定项目创建的每辆车将具有相同的 父路径。

    您在此处引用的 Cloud 项目还必须包含 Fleet Engine 您所用服务的服务账号角色。请参阅服务账号 这些服务账号的列表Fleet Engine 不支持从以下位置访问: 多个 Google Cloud 项目

  • 车辆 ID,该 ID 必须在应用的所有车辆中保持唯一 且为有效的 Unicode 字符串。这是您资源 ID 。按需行程和计划站点均使用此对象将 行程或任务。

在基于 Google Cloud 的服务中,所有 API 都必须将资源表示为字符串。 如需了解详情,请参阅Fleet Engine 中的资源命名

唯一实体标识符

资源调用中使用的唯一实体标识符的格式和值如下: 对 Fleet Engine 而言是不透明的。请确保该标识符不包含任何 个人身份信息 (PII),例如驾驶员的电话号码。

车辆再利用

车辆完成指定行程的所有经停点后,仍可使用 在 Fleet Engine 中可再利用 7 天的时间,这意味着您可以在该区域 而不必创建新订单。您每次 Fleet Engine 会重置其可用性,此时 7 天倒计时将重新开始。

在 Fleet Engine 中保持车辆可用的建议方法是 定期更新其位置。对 Vehicle 实体也会延长其生命周期,前提是新字段值 与现有的不同。

注意:Vehicle 实体上的某些字段(如 device_settings)是纯调试的 Fleet Engine 不会保留这些信息。更新它们不会 可延长 Vehicle 实体的生命周期。

为了改进系统分析,最好重复使用相同的驾驶车辆 ID 配对。为此,请使用与以下地点相关联的相同车辆 ID: 为司机之前安排的经停点或按需行程提供信息。

后续步骤