本文档介绍了如何创建多目的地行程、设置正确的 字段,并将其分配给车辆以完成任务。本文假定您已设置舰队 你已经创建了车辆,有了有效的驾驶应用, 消费者应用(可选)。您还应该熟悉 为按需行程提供的场景。请参阅以下相关指南 :
- 设置 Fleet Engine
- 创建车辆
- 按需行程概览中的行程场景
行程创建基础知识
本部分介绍了在 Fleet Engine。您可以使用 gRPC 和 REST 发出创建请求。
。行程字段
使用以下字段在 Fleet Engine 中创建行程。您可以针对不同类型的行程(单目的地或多目的地、接连行程或共享拼车行程)使用不同的字段。您 可以在创建行程时提供可选字段,也可以将它们设置为 更新行程的时间。
名称 | 必需? | 说明 |
---|---|---|
父级 | 是 | 包含项目 ID 的字符串。此 ID 必须与整个 Fleet Engine 集成中使用的 ID 相同,并且具有相同的服务账号角色。 |
trip_id | 是 | 您创建的一个字符串,用于唯一标识此行程。行程 ID 包含 如参考信息中所述。 |
trip_type | 是 | 针对您要创建的行程类型,将 TripType 设置为以下值:
|
pickup_point | 是 | 行程的起点。 |
中间目的地 | 是 | 仅限多目的地行程:司机在其间访问的中间目的地列表
上车点和下车点。与 |
vehicle_waypoints | 是 | 仅限共享池化行程:此字段支持交错多个行程中的航点。
它包含分配给指定车辆的所有剩余路点,以及此行程的上车点和下车点路点。您可以设置此字段
方法是调用 |
number_of_passengers | 否 | 相应行程的乘客人数。 |
dropoff_point | 否 | 行程的目的地。 |
vehicle_id | 否 | 为行程分配的车辆 ID。 |
示例:创建多目的地行程
以下示例演示了如何创建包含上车点、下车点和一个中途目的地的专享多目的地行程。
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "multi-destination-trip-A";
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
// Trip initial settings.
String parent = "providers/" + PROJECT_ID;
Trip trip = Trip.newBuilder()
.setTripType(TripType.EXCLUSIVE)
.setPickupPoint(
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.195139).setLongitude(106.820826)))
.setNumberOfPassengers(1)
.setDropoffPoint(
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.1275).setLongitude(106.6537)))
// Add the list of intermediate destinations.
.addAllIntermediateDestinations(
ImmutableList.of(
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.195139).setLongitude(106.820826)).build()))
.build();
// Create the Trip request.
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
.setParent(parent)
.setTripId(TRIP_ID) // Trip ID assigned by the Provider server.
.setTrip(trip) // Initial state is NEW.
.build();
// Error handling.
try {
Trip createdTrip =
tripService.createTrip(createTripRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case ALREADY_EXISTS: // Trip already exists.
break;
case PERMISSION_DENIED:
break;
}
return;
}
更新多目的地行程
您必须使用车辆 ID 配置行程,以便 Fleet Engine 可以跟踪 沿途车辆如需详细了解如何更新行程,请参阅 更新行程并管理其状态。
如果您在创建行程时未指定下车点或中途目的地,可以随时在此处进行指定。
行程更新示例
下面演示了如何更新行程以添加中间层列表 以及设置车辆 ID。
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "multi-destination-trip-A";
String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_ID;
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
// The trip settings to be updated.
Trip trip = Trip.newBuilder()
// Add the list of intermediate destinations.
.addAllIntermediateDestinations(
ImmutableList.of(
TerminalLocation.newBuilder().setPoint(
LatLng.newBuilder()
.setLatitude(-6.195139).setLongitude(106.820826)).build()))
.setVehicleId("8241890")
.build();
// The trip update request.
UpdateTripRequest updateTripRequest = UpdateTripRequest.newBuilder()
.setName(tripName)
.setTrip(trip)
.setUpdateMask(
FieldMask.newBuilder()
.addPaths("intermediate_destinations")
.addPaths("vehicle_id")
.build())
.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 PERMISSION_DENIED:
break;
}
return;
}
管理多目的地行程的行程状态
您可以使用 TripStatus
枚举值之一指定行程的状态。当行程的状态发生变化时,例如从 ENROUTE_TO_PICKUP
更改为
ARRIVED_AT_PICKUP
,您必须在 Fleet Engine 中更新行程状态。行程
状态始终以值 NEW
开始,以值
COMPLETE
或 CANCELED
。
对于多目的地行程,除了在更新过程中 ,您还必须更新以下内容: 每当您的车辆到达中途目的地时:
intermediateDestinationIndex
intermediateDestinationsVersion
为此,请使用 TripStatus
枚举中的以下值。
ENROUTE_TO_PICKUP
ARRIVED_AT_PICKUP
ENROUTE_TO_INTERMEDIATE_DESTINATION
ARRIVED_AT_INTERMEDIATE_DESTINATION
ENROUTE_TO_DROPOFF
COMPLETE
包含中途目的地的行程示例
下面展示了如何创建已经过了其 上车点,目前正在前往其第一个中途目的地的途中。
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "multi-destination-trip-A";
String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_ID;
// Get the trip object from either the Fleet Engine or storage.
Trip trip = …;
TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);
// The trip settings to be updated.
Trip trip = Trip.newBuilder()
// Trip status cannot return to a previous state once it has passed.
.setTripStatus(TripStatus.ENROUTE_TO_INTERMEDIATE_DESTINATION)
// Enroute to the first intermediate destination.
.setIntermediateDestinationIndex(0)
// You must provide an intermediate_destinations_version to ensure that you
// have the same intermediate destinations list as the Fleet Engine.
.setIntermediateDestinationsVersion(
trip.getIntermediateDestinationsVersion())
.build();
// The trip update request.
UpdateTripRequest updateTripRequest = UpdateTripRequest.newBuilder()
.setName(tripName)
.setTrip(trip)
.setUpdateMask(
FieldMask.newBuilder()
.addPaths("trip_status")
.addPaths("intermediate_destination_index")
// intermediate_destinations_version must not be in the update mask.
.build())
.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: // Either the trip status is invalid, or the
// intermediate_destinations_version doesn't
// match Fleet Engine's.
break;
case PERMISSION_DENIED:
break;
}
return;
}