简介：创建车辆

有关车辆在 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： 为司机之前安排的经停点或按需行程提供信息。

后续步骤