简介：创建车辆

如需了解有关车辆在 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 字段完全相同。Fleet Engine 会在您创建车辆时根据您在车辆创建时设置的两个字段来定义该字段：

  • 父级：与您的 Google Cloud 项目 ID 关联的字符串，格式为 providers/{provider}，其中 {provider} 是您的 Cloud 项目的 ID。您为给定项目创建的每个车辆都将具有相同的父路径。

    您在此处引用的 Cloud 项目还必须包含您所用服务的 Fleet Engine 服务账号角色。如需查看这些服务账号的列表，请参阅服务账号。Fleet Engine 不支持从多个 Google Cloud 项目进行访问。

  • 车辆的 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。

后续步骤