本部分中的文档介绍了如何使用 Google 地图出行服务创建和处理行程。本文假定您熟悉以下内容:
- 车队引擎:您应熟悉车队引擎实现细节、请求机制和安全性。如需了解详情,请参阅什么是 Fleet Engine 服务?以及设置 Fleet Engine 中的安全主题。
- 面向按需服务的车辆基础知识。请参阅车辆简介。
- 针对按需服务的行程基础知识。请参阅按需行程。
您将使用的 TripService
适用于 gRPC 和 REST。为简单起见,字段引用遵循 gRPC 惯例。
在适用于按需服务的 Fleet Engine 中,行程是一种历程,用于模拟执行来自消费者的送餐或乘车请求。行程具有状态,您可以在行程演变过程中向 Fleet Engine 报告该状态,例如 NEW
、ENROUTE_TO_PICKUP
等。行程状态与分配给车辆的地理定位路点相对应,并且每当您更新行程时,车队引擎都会修改这些车辆路点。如需详细了解行程及其与车辆的关系,请参阅车队引擎基础知识中的按需行程。
行程生命周期
如需在车队引擎中跟踪每一次行程,您必须先创建一个 Trip
实体。如需查看参考信息,请参阅 gRPC 或 REST。
下表介绍了在您的系统中创建的出行的一例端到端流程,以及其在车队引擎中的生命周期阶段。它假定您已设置 Fleet Engine 并有一辆车分配给行程,且驾驶员应用中启用了位置信息更新。请参阅驱动程序 SDK:按需行程。
1 | 接收预订请求。 | 在车队引擎行程开始之前,您的预订系统会先通过您的应用或其他预订系统收到来自消费者的乘车或送货请求。然后,您的系统会使用 CreateTrip 和必填字段(例如上车地点)创建行程实体。还可以在此时间点设置其他字段,例如乘客和下车点,或等待分配车辆。请参阅创建单目的地行程。 |
2 | 分配车辆。 | 您可以直接在自己的系统中将车辆分配给行程,并将分配情况报告给车队引擎;也可以使用搜索车辆服务搜索车辆,同时按行程和车辆属性进行过滤,以找到最适合完成行程的车辆。搜索半径范围内的所有在线车辆都会通过 Driver SDK 提供的位置信息更新来告知其相近情况。
|
3 | 更新行程。 | 当司机接受行程并开始导航至上车地点后,您的系统会将行程状态从 NEW 更新为 ENROUTE_TO_PICKUP 。您在整个行程中继续轮询车辆位置,方法是直接从应用连接到后端,或轮询 Fleet Engine,后者会从 Driver SDK 接收持续的车辆位置信息更新流。然后,您的系统会将每项行程里程碑报告给车队引擎,后者会相应地更新车辆的航点列表。
|
4 | 与消费者分享历程。 | Fleet Engine 将行程详情和车辆位置提供给消费者 SDK,消费者 SDK 使用监听器接收行程更新,并在消费者应用中显示这些信息。Fleet Engine 会自动更新预计到达时间、剩余距离、路线和剩余车辆航点。如需了解详情,请参阅分享约车行程。 |
5 | 完成行程。 | 当车辆到达行程的目的地航点,并且您的司机指示行程已成功后,您的系统会在车队引擎中将 TripStatus 设置为 COMPLETE 。请注意,与车辆一样,无论状态如何,行程实体都会在车队引擎中保持活跃状态 7 天,之后便会被移除。 |
行程序列流程
下图更详细地展示了此流程。