简介：创建车辆

有关 Fleet Engine 中车辆工作原理的一般信息，请参阅 Fleet Engine 基本部分中的以下指南：

本部分中的文档介绍了如何在 Fleet Engine 中创建和管理车辆。您可以在 Fleet Engine 服务器环境中创建车辆，以反映实际运营中的车辆。您的 Fleet Engine 车辆还应与您用于车辆分配和路线规划的后端系统中的车辆相对应。

您可以使用 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 设置指南。

车辆资源字段

车辆资源包含以下几种类型的字段：

  • 仅限输出的字段。由服务设置为其他方法的输出且无法直接设置的字段。此类型的一个重要字段是 name 字段。根据 Google AIP 关于用户指定的 ID 的指南，Fleet Engine 会忽略车辆的 name 字段的任何提供的值。如果您为这些字段提供值，Fleet Engine 会返回错误。
  • 必填字段。在按需出行服务中创建的车辆要求在创建时设置某些字段。在预定任务服务中创建的车辆没有必需的车辆资源字段。
  • 可选字段。这两种服务都有可在创建时或创建后设置的字段。您可以在所用服务的相应参考指南中找到这些信息。

车辆名称（仅限输出）

name 字段对于按需行程和计划任务服务完全相同。车队引擎会在您创建车辆时根据您在创建车辆时设置的两个字段来定义该字段：

  • 父级：与您的 Google Cloud 项目 ID 关联的字符串，格式为 providers/{provider}，其中 {provider} 是您的 Cloud 项目的 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。

后续步骤