有关车辆在 Fleet Engine 中的工作原理的一般信息,请参阅 请参阅 Fleet Engine 重要部分中的指南:
本部分中的文档介绍了如何在 Google Cloud 控制台中创建和管理车辆 Fleet Engine。在 Fleet Engine 服务器环境中创建车辆 真实反映您实际操作中的车辆您的舰队引擎 还应该与您在后端系统中使用的 名称一致 用于车辆分配和路线。
您可以使用 create 方法通过 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 功能。
请求正文中的信息因请求的性质而异。请参阅 请查看其各自的指南。
身份验证和授权令牌
向 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: 为司机之前安排的经停点或按需行程提供信息。