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