简介：创建车辆

如需了解有关车辆在 Fleet Engine 中的工作方式的一般信息，请参阅 Fleet Engine 基础知识部分中的以下指南：

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

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

按需行程

计划任务

车辆请求

对于按需和计划任务功能，您可以通过发出包含字段的请求消息来创建和更新车辆，具体如下所示：

  1. 父项：与您的 Google Cloud 项目 ID 关联的字符串，用于填充车辆实例的名称字段。

  2. 车辆的 ID：用于填充车辆的 name 字段的唯一字符串。

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

请求正文中的信息因请求的性质而异。请在各自的指南中查看这些详细信息。

身份验证和授权令牌

对 Fleet Engine 的请求还必须提供正确的访问凭据。 本指南中的示例具有以下假设：

  • gRPC 示例假定使用 授权库 for 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} 是您的云项目的 ID。您为给定项目创建的每辆车都将具有相同的父路径。

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

  • 车辆的 ID，该 ID 在车队中的所有车辆中必须是唯一的，并且必须是有效的 Unicode 字符串。这是车辆的 资源 ID。按需行程和计划停靠点都使用此 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，用于之前的计划停靠点或按需行程。

后续步骤