更新行程并管理其状态

本文档介绍了如何更新行程并管理其状态， 涉及使用字段掩码为行程设置相关字段。它假定您 已按照本网站中的说明设置了 Fleet Engine，并且正在与 分配给行程的车辆。

行程更新基本信息

在以下情况下，您的系统会使用 Fleet Engine 更新行程：

  • 在创建行程后为其分配车辆时。
  • 当行程状态发生变化时；例如，当车辆通过 途经航点
  • 当您更新行程字段（例如乘客人数和 下车点。

如需更新行程，请使用 gRPC 和 REST 发送请求。

  • UpdateTrip() 方法：gRPC 或 REST
  • UpdateTripRequest 消息：仅 gRPC

为项目的服务账号使用适当的凭据，如下所示 Fleet Engine：服务账号角色中描述。

更新行程字段

您可以更新创建中的行程字段 单个目的地行程。例如，创建行程后，它是一个常见的 练习首先查找车辆，然后将行程 vehicle_id 字段更新为 并将其与将执行此次行程的车辆相关联。

使用字段掩码

API 调用方可通过字段掩码列出请求应显示的字段 或更新。使用 FieldMask 避免不必要的工作，并提升性能。Fleet Engine 使用字段掩码 用于更新所有资源中的字段。

使用车辆 ID 更新行程

您必须使用车辆 ID 配置行程，以便 Fleet Engine 可以跟踪 沿途车辆以下代码示例演示了如何 使用车辆 ID 更新行程。

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "trip-8241890";

String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_ID;

TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);

// The trip settings to update.
Trip trip = Trip.newBuilder()
    .setVehicleId("8241890")
    .build();

// The trip update request.
UpdateTripRequest updateTripRequest =
    UpdateTripRequest.newBuilder()      // No need for the header.
        .setName(tripName)
        .setTrip(trip)
        .setUpdateMask(FieldMask.newBuilder().addPaths("vehicle_id"))
        .build();

// Error handling.
// If the Fleet Engine has both a trip and vehicle with IDs, and if the
// credentials validate, then the service updates the trip.
try {
  Trip updatedTrip = tripService.updateTrip(updateTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case NOT_FOUND:                    // Neither the trip nor vehicle exist.
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

管理行程的行程状态

您可以使用其中一个 TripStatus 枚举指定行程的状态 值。当行程的状态发生变化时；例如从 ENROUTE_TO_PICKUP 到 ARRIVED_AT_PICKUP，您需要在 Fleet Engine 中更新行程状态。旅程 生命周期始终以状态值 NEW 开始，以值 COMPLETE 或 CANCELED。

行程更新示例

下面演示了如何更新连续的行程状态 Fleet Engine 中的行程。

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "trip-8241890";

String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_ID;

TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);

// Trip settings to be updated.
Trip trip = Trip.newBuilder()
    .setTripStatus(TripStatus.ARRIVED_AT_PICKUP)
    .build();

// Trip update request
UpdateTripRequest updateTripRequest = UpdateTripRequest.newBuilder()
    .setName(tripName)
    .setTrip(trip)
    .setUpdateMask(FieldMask.newBuilder().addPaths("trip_status"))
    .build();

// Error handling.
try {
  Trip updatedTrip = tripService.updateTrip(updateTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case NOT_FOUND:            // The trip doesn't exist.
      break;
    case FAILED_PRECONDITION:  // The given trip status is invalid.
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

如需查看有关如何更新行程的其他示例，请参阅其他行程类型 部分。

处理行程错误

更新或查找现有行程时，您可能会遇到 DEADLINE_EXCEEDED 错误（在这种情况下，Fleet Engine 的状态未知）。 如需对此进行调查，请先使用您之前的同一行程 ID 再次调用 CreateTrip 正在尝试更新或监控。此时应返回 201（已创建）或 409（冲突）。在后一种情况下，上一个请求在 DEADLINE_EXCEEDED。

查看使用方 SDK 中的网络连接错误列表，针对 Android 或 iOS。

后续步骤