如需了解车辆在车队引擎中的运作方式的一般信息,请参阅“车队引擎必备知识”部分中的以下指南:
本部分中的文档介绍了如何在车队引擎中创建和管理车辆。您可以在 Fleet Engine 服务器环境中创建车辆,以反映实际运营中的实际车辆。您的车队引擎车辆还应与您在后端系统中用于车辆分配和路线规划的车辆相对应。
您可以使用 gRPC 或 REST 方法来创建车辆资源。为简单起见,本指南中的字段名称使用 gRPC 表示法。
按需行程
CreateVehicleRequest
(gRPC)providers.vehicle.create
(REST)Vehicle
资源(REST、gRPC)
计划任务
CreateDeliveryVehicleRequest
(gRPC)providers.deliveryVehicles.create
(REST)DeliveryVehicle
(REST、gRPC)
车辆请求
对于按需和安排的任务功能,您可以通过发出包含字段的请求消息来创建和更新车辆,如下所示:
- 父级:与您的 Google Cloud 项目 ID 关联的字符串,用于填充车辆实例的名称字段。
车辆的 ID:用于填充车辆的
name
字段的唯一字符串。车辆实例及其必填字段。这些字段取决于您使用的车队引擎功能。
请求正文中的信息因请求性质而异。如需了解详情,请参阅各自的指南。
身份验证和授权令牌
向 Fleet Engine 发出的请求还必须提供正确的访问凭据。本指南中的示例假定:
- gRPC 示例假定使用 Java 版授权库。
- REST 示例展示了 HTTP 请求标头,其中必须包含值为
Bearer <token>
的字段Authorization
,其中<token>
是您发出的 JSON Web 令牌。
如需了解详情,请参阅设置车队引擎指南。
车辆资源字段
车辆资源具有以下类型的字段:
- 仅限输出的字段。由服务作为其他方法的输出设置的字段,无法直接设置。此类型的一个重要字段是
name
字段。根据 Google AIP 针对用户指定的 ID 的准则,车队引擎会忽略为车辆的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 天,这意味着您可以在接下来的工作日重复使用车辆,而无需创建新的车辆。每次您重复使用车辆时,车队引擎都会重置其空闲状态,此时 7 天倒计时会重新开始。
如需在车队引擎中保持车辆可用,建议定期更新其位置信息。更新 Vehicle
实体中的大多数其他字段也会延长其生命周期,前提是新字段值不同于现有字段值。
注意:Vehicle
实体(例如 device_settings
)上的某些字段纯粹是调试信息,不会由车队引擎保留。更新这些实体不会延长 Vehicle
实体的生命周期。
为了获得更准确的系统分析数据,最好每天重复使用相同的驾驶员-车辆 ID 配对。为此,请使用与之前的预约停靠点或随叫车行程关联的车辆 ID。