按需约车和送货解决方案目前仅面向部分合作伙伴提供。

此页面由 Cloud Translation API 翻译。

创建和显示连续行程

连续行程是接连发生的独占行程，司机在完成当前行程之前承诺为下一个消费者接单。

连续行程和单目的地行程之间的主要区别在于，对于连续行程，行程运营商可以将行程分配给已分配行程的车辆。

本教程将引导您完成创建连续行程的过程。此外，它还展示了如何随后将该行程与您的消费者应用集成，以便您的客户可以通过他们的手机查看行程进度。您可以使用消费者 SDK 执行此集成。

前提条件

如需完成本教程，请务必完成以下操作：

设置 Fleet Engine。如需了解详情，请参阅 Fleet Engine：初始设置。
将您的应用与驱动程序 SDK 集成。如需了解详情，请参阅初始化驱动程序 SDK 和驱动程序 SDK 集成指南。
将面向消费者的应用与消费者 SDK 集成。如需了解详情，请参阅开始使用消费者 SDK 和消费者 SDK 使用入门。
设置授权令牌。有关授权令牌的更多信息，请参阅 Fleet Engine 使用入门指南中的创建用于授权的 JSON Web 令牌；以及 Fleet Engine 的使用方 SDK 文档中的身份验证和授权。

第 1 步：在 Fleet Engine 中创建车辆

车辆是代表车队中车辆的对象。您必须创建 Fleet Engine 中的实例，以便能够在消费者应用中跟踪它们。

您可以使用以下两种方法之一制作车辆：

gRPC: 致电CreateVehicle() 方法（其中包含 CreateVehicleRequest 请求消息。您必须拥有 Fleet Engine 超级用户权限才能调用 CreateVehicle()。
REST: 拨打 https://fleetengine.googleapis.com/v1/providers.vehicles.create。

注意事项

制作车辆时，请注意以下事项。

请务必将车辆的初始状态设为 OFFLINE。这样可以确保 Fleet Engine 能够发现您的车辆，以便匹配行程。
车辆的 provider_id 必须与包含用于调用舰队的服务账号的 Google Cloud 项目。虽然多个服务账号可以在同一位置访问 Fleet Engine，拼车服务提供商，Fleet Engine 目前不支持访问相同车辆的不同 Google Cloud 项目。
从 CreateVehicle() 返回的响应包含 Vehicle 实例。如果 7 天后该实例仍未使用 UpdateVehicle()。您应该先调用 GetVehicle()，然后再调用 CreateVehicle() 只是为了确认车辆尚不存在。如果 GetVehicle() 返回 NOT_FOUND 错误，则您应继续调用 CreateVehicle()。如需了解详情，请参阅交通工具及其生命周期。

示例

以下提供程序代码示例演示了如何在 Fleet Engine

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

VehicleServiceBlockingStub vehicleService = VehicleService.newBlockingStub(channel);

String parent = "providers/" + PROJECT_ID;

Vehicle vehicle = Vehicle.newBuilder()
    .setVehicleState(VehicleState.OFFLINE)  // Initial state
    .addSupportedTripTypes(TripType.EXCLUSIVE)
    .setMaximumCapacity(4)
    .setVehicleType(VehicleType.newBuilder().setCategory(VehicleType.Category.AUTO))
    .build();

CreateVehicleRequest createVehicleRequest = CreateVehicleRequest.newBuilder()
    .setParent(parent)
    .setVehicleId("8241890")  // Vehicle ID assigned by solution provider.
    .setVehicle(vehicle)      // Initial state.
    .build();

// The Vehicle is created in the OFFLINE state, and no initial position is
// provided.  When the driver app calls the rideshare provider, the state can be
// set to ONLINE, and the driver app updates the vehicle location.
try {
  Vehicle createdVehicle = vehicleService.createVehicle(createVehicleRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case ALREADY_EXISTS:
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

如需创建支持连续行程的 Vehicle，您必须在传递给 CreateVehicleRequest 的 Vehicle 对象中将 backToBackEnabled 字段设置为 true。

Vehicle vehicle = Vehicle.newBuilder()
    .setVehicleState(VehicleState.OFFLINE)
    .addSupportedTripTypes(TripType.EXCLUSIVE)
    .setMaximumCapacity(4)
    .setVehicleType(VehicleType.newBuilder().setCategory(VehicleType.Category.AUTO))
    .setBackToBackEnabled(true) // Set as 'true' so vehicle can be assigned back-to-back trips.
    .build();

第 2 步：启用位置跟踪

位置跟踪是指跟踪车辆在行程中的位置。其中，Driver 应用将遥测数据发送到 Fleet Engine，其中包含车辆当前位置。这个不断更新的位置流信息用于传递车辆在行程路线中的进度。启用位置跟踪功能后，驾驶员应用就会开始发送此遥测数据，以每 5 秒一次的默认频率运行。

您可以按如下方式为 Android 和 iOS 启用位置跟踪：

调用适用于 Android 的驱动程序 SDK 方法 enableLocationTracking()。
将 iOS 版驱动程序 SDK 布尔属性 locationTrackingEnabled 设置为 true。

。

示例

以下代码示例演示了如何启用位置跟踪。

Java

RidesharingVehicleReporter vehicleReporter = ...;

vehicleReporter.enableLocationTracking();

Kotlin

val vehicleReporter = ...

vehicleReporter.enableLocationTracking()

Swift

vehicleReporter.locationTrackingEnabled = true

Objective-C

_vehicleReporter.locationTrackingEnabled = YES;

第 3 步：将车辆的状态设为在线

您需要通过以下方式安排车辆进入维修（即，使其可供使用）并将其状态设置为 online，但您必须先完成这些操作，然后才能执行此操作。已启用位置跟踪。

对于 Android 和 iOS，您需要将车辆的状态设置为在线，具体操作步骤如下：

调用适用于 Android 的驱动程序 SDK 方法 setVehicleState(VehicleState.ONLINE)。
调用适用于 iOS 的驱动程序 SDK 方法 vehicleReporter.update(.online)。

示例

以下代码示例演示了如何将车辆的状态设置为 ONLINE。

Java

vehicleReporter.setVehicleState(VehicleState.ONLINE);

Kotlin

vehicleReporter.setVehicleState(VehicleState.ONLINE)

Swift

vehicleReporter.update(.online)

Objective-C

[_vehicleReporter updateVehicleState:GMTDVehicleStateOnline];

第 4 步：在 Fleet Engine 中创建行程

为了创建连续的行程，您需要创建一个 Trip 对象，就像为单目的地行程创建对象一样。

行程是表示行程的对象，是一个地理坐标点集合，包括起点、航点和下车点。您必须为每个行程请求创建一个 Trip 对象，以便该请求可以与车辆匹配并进行跟踪。

通过调用 CreateTrip() 方法（其中包含 CreateTripRequest 请求消息。

提供必需属性

如需创建连续的行程，您必须提供以下字段：

parent: 包含提供方 ID 的字符串。该名称必须与包含服务账号的 Google Cloud 项目的 ID 用于调用 Fleet Engine
trip_id: 您创建的一个字符串，用于唯一标识此行程。
trip: 要创建的 Trip 对象。

必须在传递给 CreateTripRequest 的 Trip 对象中设置以下字段：

trip_type: TripType.EXCLUSIVE
pickup_point: 行程的出发地。
dropoff_point: 行程的下车点。此字段在行程创建时非必填字段，可以稍后通过调用 UpdateTrip 进行设置。

示例

以下后端集成示例演示了如何创建行程并将其分配给车辆。

// A vehicle with ID 'my-vehicle' is already created and it is assigned to a trip with ID 'current-trip'.

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String VEHICLE_ID =" my-vehicle";
static final String TRIP_ID = "back-to-back-trip");

TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);

String parent = "providers/" + PROJECT_ID;

Trip trip = Trip.newBuilder()
    .setTripType(TripType.EXCLUSIVE)
    .setPickupPoint(
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder()
                .setLatitude(-6.195139).setLongitude(106.820826)))
    .setDropoffPoint(
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder()
                .setLatitude(-6.1275).setLongitude(106.6537)))
    .setVehicleId(VEHICLE_ID)
    .build();

// Create trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
    .setParent(parent)
    .setTripId(TRIP_ID)
    .setTrip(trip)
    .build();

// Error handling.
try {
  // Fleet Engine automatically assigns a 'waypoints' list to the trip containing
  // the vehicle's current trip waypoints.
  Trip createdTrip =
      tripService.createTrip(createTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case ALREADY_EXISTS:
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

第 5 步：使用车辆 ID 和航点更新行程

您必须使用车辆 ID 配置行程，以便 Fleet Engine 可以跟踪沿途车辆对于背靠背模式，即使已为相应车辆分配行程，也会将行程分配给该车辆。

您可以通过调用 UpdateTrip 具有 UpdateTripRequest。使用 update_mask 字段指明您要更新车辆 ID。

您将行程分配给车辆后，Fleet Engine 会自动添加与到车辆航点的连续行程相关联的航点字段。行程的 remainingWaypoints 字段包含所有将会在此之前访问过的航点，行程的下车点

例如，假设有两条连续的行程：行程 A 和行程 B。车辆已上车行程 A，在前往下车点的途中司机收到要求为下一趟行程取货的消费者（行程 B）。

调用 getVehicle() 会返回剩余航点的列表 (remainingWaypoints)，包含：
流失 → B _自提 → B _流失。
getTrip() 或 onTripRemainingWaypointsUpdated 回调行程 A 会返回剩余航点的列表 (remainingWaypoints)，包含退出次数。
getTrip() 或 onTripRemainingWaypointsUpdated 回调行程 B 会返回剩余航点的列表 (remainingWaypoints)，包含 _离开 → B _上车点 → 和 B _流失。

第 6 步：在消费者应用中监听行程更新

对于 Android，您可以通过获取 TripModel 对象来监听行程中的数据更新并注册 TripModelCallback 监听器。TripModelManager
对于 iOS，您可以通过获取 GMTCTripModel 对象来监听行程中的数据更新并注册 GMTCTripModelSubscriber 订阅者。GMTCTripService

TripModelCallback 监听器和 GMTCTripModelSubscriber 订阅者可让您的应用定期接收根据自动刷新间隔，在每次刷新时更新行程进度。只有发生更改的值才能触发回调。否则，不会发出任何通知

无论数据发生任何更改，系统始终会调用 TripModelCallback.onTripUpdated() 和 tripModel(_:didUpdate:updatedPropertyFields:) 方法。

示例 1

以下代码示例演示了如何从 API 中获取 TripModel TripModelManager/GMTCTripService，并为其设置监听器。

Java

// Start journey sharing after a trip has been created via Fleet Engine.
TripModelManager tripModelManager = consumerApi.getTripModelManager();

// Get a TripModel object.
TripModel tripModel = tripModelManager.getTripModel(tripName);

// Register a listener on the trip.
TripModelCallback tripCallback = new TripModelCallback() {
  ...
};
tripModel.registerTripCallback(tripCallback);

// Set the refresh interval.
TripModelOptions tripModelOptions = TripModelOptions.builder()
    .setRefreshInterval(5000) // interval in milliseconds, so 5 seconds
    .build();
tripModel.setTripModelOptions(tripModelOptions);

// The trip stops auto-refreshing when all listeners are unregistered.
tripModel.unregisterTripCallback(tripCallback);

Kotlin

// Start journey sharing after a trip has been created via Fleet Engine.
val tripModelManager = consumerApi.getTripModelManager()

// Get a TripModel object.
val tripModel = tripModelManager.getTripModel(tripName)

// Register a listener on the trip.
val tripCallback = TripModelCallback() {
  ...
}

tripModel.registerTripCallback(tripCallback)

// Set the refresh interval.
val tripModelOptions =
  TripModelOptions.builder()
    .setRefreshInterval(5000) // interval in milliseconds, so 5 seconds
    .build()

tripModel.setTripModelOptions(tripModelOptions)

// The trip stops auto-refreshing when all listeners are unregistered.
tripModel.unregisterTripCallback(tripCallback)

Swift

let tripService = GMTCServices.shared().tripService

// Create a tripModel instance for listening for updates from the trip
// specified by the trip name.
let tripModel = tripService.tripModel(forTripName: tripName)

// Register for the trip update events.
tripModel.register(self)

// Set the refresh interval (in seconds).
tripModel.options.autoRefreshTimeInterval = 5

// Unregister for the trip update events.
tripModel.unregisterSubscriber(self)

Objective-C

GMTCTripService *tripService = [GMTCServices sharedServices].tripService;

// Create a tripModel instance for listening for updates from the trip
// specified by the trip name.
GMTCTripModel *tripModel = [tripService tripModelForTripName:tripName];

// Register for the trip update events.
[tripModel registerSubscriber:self];

// Set the refresh interval (in seconds).
tripModel.options.autoRefreshTimeInterval = 5;

// Unregister for the trip update events.
[tripModel unregisterSubscriber:self];

示例 2

以下代码示例演示了如何设置 TripModelCallback 监听器和 GMTCTripModelSubscriber 个订阅者。

Java

// Implements a callback for the trip model so your app can listen for trip
// updates from Fleet Engine.
TripModelCallback subscriber =
  new TripModelCallback() {

    @Override
    public void onTripStatusUpdated(TripInfo tripInfo, @TripStatus int status) {
      // ...
    }

    @Override
    public void onTripActiveRouteUpdated(TripInfo tripInfo, List<LatLng> route) {
      // ...
    }

    @Override
    public void onTripVehicleLocationUpdated(
        TripInfo tripInfo, @Nullable VehicleLocation vehicleLocation) {
      // ...
    }

    @Override
    public void onTripPickupLocationUpdated(
        TripInfo tripInfo, @Nullable TerminalLocation pickup) {
      // ...
    }

    @Override
    public void onTripPickupTimeUpdated(TripInfo tripInfo, @Nullable Long timestampMillis) {
      // ...
    }

    @Override
    public void onTripDropoffLocationUpdated(
        TripInfo tripInfo, @Nullable TerminalLocation dropoff) {
      // ...
    }

    @Override
    public void onTripDropoffTimeUpdated(TripInfo tripInfo, @Nullable Long timestampMillis) {
      // ...
    }

    @Override
    public void onTripETAToNextWaypointUpdated(
        TripInfo tripInfo, @Nullable Long timestampMillis) {
      // ...
    }

    @Override
    public void onTripActiveRouteRemainingDistanceUpdated(
        TripInfo tripInfo, @Nullable Integer distanceMeters) {
      // ...
    }

    @Override
    public void onTripUpdateError(TripInfo tripInfo, TripUpdateError error) {
      // ...
    }

    @Override
    public void onTripUpdated(TripInfo tripInfo) {
      // ...
    }

    @Override
    public void onTripRemainingWaypointsUpdated(
        TripInfo tripInfo, List<TripWaypoint> waypointList) {
      // ...
    }

    @Override
    public void onTripIntermediateDestinationsUpdated(
        TripInfo tripInfo, List<TerminalLocation> intermediateDestinations) {
      // ...
    }

    @Override
    public void onTripRemainingRouteDistanceUpdated(
        TripInfo tripInfo, @Nullable Integer distanceMeters) {
      // ...
    }

    @Override
    public void onTripRemainingRouteUpdated(TripInfo tripInfo, List<LatLng> route) {
      // ...
    }
  };

Kotlin

// Implements a callback for the trip model so your app can listen for trip
// updates from Fleet Engine.
val subscriber =
  object : TripModelCallback() {
    override fun onTripStatusUpdated(tripInfo: TripInfo, status: @TripStatus Int) {
      // ...
    }

    override fun onTripActiveRouteUpdated(tripInfo: TripInfo, route: List<LatLng>) {
      // ...
    }

    override fun onTripVehicleLocationUpdated(
      tripInfo: TripInfo,
      vehicleLocation: VehicleLocation?
    ) {
      // ...
    }

    override fun onTripPickupLocationUpdated(tripInfo: TripInfo, pickup: TerminalLocation?) {
      // ...
    }

    override fun onTripPickupTimeUpdated(tripInfo: TripInfo, timestampMillis: Long?) {
      // ...
    }

    override fun onTripDropoffLocationUpdated(tripInfo: TripInfo, dropoff: TerminalLocation?) {
      // ...
    }

    override fun onTripDropoffTimeUpdated(tripInfo: TripInfo, timestampMillis: Long?) {
      // ...
    }

    override fun onTripETAToNextWaypointUpdated(tripInfo: TripInfo, timestampMillis: Long?) {
      // ...
    }

    override fun onTripActiveRouteRemainingDistanceUpdated(
      tripInfo: TripInfo,
      distanceMeters: Int?
    ) {
      // ...
    }

    override fun onTripUpdateError(tripInfo: TripInfo, error: TripUpdateError) {
      // ...
    }

    override fun onTripUpdated(tripInfo: TripInfo) {
      // ...
    }

    override fun onTripRemainingWaypointsUpdated(
      tripInfo: TripInfo,
      waypointList: List<TripWaypoint>
    ) {
      // ...
    }

    override fun onTripIntermediateDestinationsUpdated(
      tripInfo: TripInfo,
      intermediateDestinations: List<TerminalLocation>
    ) {
      // ...
    }

    override fun onTripRemainingRouteDistanceUpdated(tripInfo: TripInfo, distanceMeters: Int?) {
      // ...
    }

    override fun onTripRemainingRouteUpdated(tripInfo: TripInfo, route: List<LatLng>) {
      // ...
    }
  }

Swift

class TripModelSubscriber: NSObject, GMTCTripModelSubscriber {

  func tripModel(_: GMTCTripModel, didUpdate trip: GMTSTrip?, updatedPropertyFields: GMTSTripPropertyFields) {
    // Update the UI with the new `trip` data.
    updateUI(with: trip)
    ...
  }

  func tripModel(_: GMTCTripModel, didUpdate tripStatus: GMTSTripStatus) {
    // Handle trip status did change.
  }

  func tripModel(_: GMTCTripModel, didUpdateActiveRoute activeRoute: [GMTSLatLng]?) {
    // Handle trip active route did update.
  }

  func tripModel(_: GMTCTripModel, didUpdate vehicleLocation: GMTSVehicleLocation?) {
    // Handle vehicle location did update.
  }

  func tripModel(_: GMTCTripModel, didUpdatePickupLocation pickupLocation: GMTSTerminalLocation?) {
    // Handle pickup location did update.
  }

  func tripModel(_: GMTCTripModel, didUpdateDropoffLocation dropoffLocation: GMTSTerminalLocation?) {
    // Handle drop off location did update.
  }

  func tripModel(_: GMTCTripModel, didUpdatePickupETA pickupETA: TimeInterval) {
    // Handle the pickup ETA did update.
  }

  func tripModel(_: GMTCTripModel, didUpdateDropoffETA dropoffETA: TimeInterval) {
    // Handle the drop off ETA did update.
  }

  func tripModel(_: GMTCTripModel, didUpdateRemaining remainingWaypoints: [GMTSTripWaypoint]?) {
    // Handle updates to the pickup, dropoff or intermediate destinations of the trip.
  }

  func tripModel(_: GMTCTripModel, didFailUpdateTripWithError error: Error?) {
    // Handle the error.
  }

  func tripModel(_: GMTCTripModel, didUpdateIntermediateDestinations intermediateDestinations: [GMTSTerminalLocation]?) {
    // Handle the intermediate destinations being updated.
  }

  ...
}

Objective-C

@interface TripModelSubscriber : NSObject <GMTCTripModelSubscriber>
@end

@implementation TripModelSubscriber

- (void)tripModel:(GMTCTripModel *)tripModel
            didUpdateTrip:(nullable GMTSTrip *)trip
    updatedPropertyFields:(GMTSTripPropertyFields)updatedPropertyFields {
  // Update the UI with the new `trip` data.
  [self updateUIWithTrip:trip];
  ...
}

- (void)tripModel:(GMTCTripModel *)tripModel didUpdateTripStatus:(enum GMTSTripStatus)tripStatus {
  // Handle trip status did change.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdateActiveRoute:(nullable NSArray<GMTSLatLng *> *)activeRoute {
  // Handle trip route did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdateVehicleLocation:(nullable GMTSVehicleLocation *)vehicleLocation {
  // Handle vehicle location did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdatePickupLocation:(nullable GMTSTerminalLocation *)pickupLocation {
  // Handle pickup location did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdateDropoffLocation:(nullable GMTSTerminalLocation *)dropoffLocation {
  // Handle drop off location did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel didUpdatePickupETA:(NSTimeInterval)pickupETA {
  // Handle the pickup ETA did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdateRemainingWaypoints:(nullable NSArray<GMTSTripWaypoint *> *)remainingWaypoints {
  // Handle updates to the pickup, dropoff or intermediate destinations of the trip.
}

- (void)tripModel:(GMTCTripModel *)tripModel didUpdateDropoffETA:(NSTimeInterval)dropoffETA {
  // Handle the drop off ETA did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel didFailUpdateTripWithError:(nullable NSError *)error {
  // Handle the error.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdateIntermediateDestinations:
        (nullable NSArray<GMTSTerminalLocation *> *)intermediateDestinations {
  // Handle the intermediate destinations being updated.
}
…
@end

您可以按以下步骤随时访问该行程的信息：

调用 Consumer SDK for Android 方法 TripModel.getTripInfo()。调用此方法不会强制刷新数据，但数据仍会继续以刷新频率进行刷新。
获取 iOS 版使用方 SDK 属性 GMTCTripModel.currentTrip。

第 7 步：在消费者应用中显示历程

您可以按如下方式访问 Rides and Deliveries 界面元素 API：

获取 Android 版使用方 SDK ConsumerController 对象。如需了解详情，请参阅使用界面元素 API。
获取 iOS 版使用方 SDK GMTCMapView 对象。如需了解详情，请参阅使用界面元素 API。

示例

以下代码示例演示了如何开始分享用户历程界面。

Java

JourneySharingSession session = JourneySharingSession.createInstance(tripModel);
consumerController.showSession(session);

Kotlin

val session = JourneySharingSession.createInstance(tripModel)
consumerController.showSession(session)

Swift

let journeySharingSession = GMTCJourneySharingSession(tripModel: tripModel)
mapView.show(journeySharingSession)

Objective-C

GMTCJourneySharingSession *journeySharingSession =
    [[GMTCJourneySharingSession alloc] initWithTripModel:tripModel];
[self.mapView showMapViewSession:journeySharingSession];

示例场景

假设车辆已经接走了为消费者提供第一印象。车辆正在前往下车点的途中，司机在接单后收到接其他消费者的请求当前行程。

此时，第一次行程的消费者会看到以下内容。

与此同时，第二次行程的消费者看到以下信息。

默认情况下，使用方 SDK 仅显示路线中的活动路程，可以选择显示剩余路程，其中包括目的地。

如果您想显示有关其他行程中的航点的信息，可以访问与行程相关的所有航点，如下所示：

调用 Android 版使用方 SDK 方法 TripModel.getTripInfo()。然后，调用 TripInfo.getRemainingWaypoints() 以获取 TripWaypoint。每个 TripWaypoint 对象都包含行程 ID、航点位置和航点类型。
获取 iOS 版使用方 SDK 属性 GMTCTripModel.currentTrip。然后，获取 GMTSTrip.remainingWaypoints 数组以访问 GMTSTripWaypoint。每个 GMTSTripWaypoint 对象都包含行程 ID、航点位置和航点类型。

第 8 步：在 Fleet Engine 中管理行程状态

您可以使用 TripStatus 枚举值。当行程的状态发生变化时（例如，从 ENROUTE_TO_PICKUP 到 ARRIVED_AT_PICKUP），您必须通过以下方式更新行程状态： Fleet Engine行程状态始终以值 NEW 开始，以值为 COMPLETE 或 CANCELED。如需了解详情，请参阅 trip_status。

示例

以下后端集成示例演示了如何在 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;
}