이 문서에서는 연달아 이동하는 경로를 만들고 올바른 필드를 설정하고 차량에 할당하여 처리하는 방법을 설명합니다. Fleet Engine을 설정하고, 차량을 만들고, 작동하는 운전자 앱과 선택적으로 소비자 앱을 보유하고 있다고 가정합니다. 또한 주문형 이동에 사용할 수 있는 다양한 이동 시나리오에 익숙해야 합니다. 자세한 내용은 다음 관련 가이드를 참고하세요.
- Fleet Engine 설정
- 차량 만들기
- 주문형 이동 개요의 이동 시나리오
경로 생성 기본사항
이 섹션에서는 Fleet Engine에서 이동을 만들 때 필요한 요청 세부정보를 설명합니다. gRPC 또는 REST를 사용하여 생성 요청을 전송합니다.
이동 필드
다음 필드를 사용하여 Fleet Engine에서 이동을 만듭니다. 목적지가 하나인 경우, 목적지가 여러 개인 경우, 연달아 이동하는 경우, 공유 풀링 이동의 경우 등 다양한 이동 유형에 서로 다른 필드를 사용할 수 있습니다. 경로를 만들 때 선택사항인 필드를 입력하거나 나중에 경로를 업데이트할 때 설정할 수 있습니다.
| 이름 | 필수 여부 | 설명 |
|---|---|---|
| parent | 예 | 프로젝트 ID가 포함된 문자열입니다. 이 ID는 전체 Fleet Engine 통합에서 동일한 서비스 계정 역할과 함께 사용되는 ID와 동일해야 합니다. |
| trip_id | 예 | 이 이동을 고유하게 식별하는 개발자가 만드는 문자열입니다. 참조에 표시된 대로 경로 ID에는 특정 제한사항이 있습니다. |
| trip_type | 예 | 만들려는 이동 유형에 따라 TripType을 다음 값으로 설정합니다.
|
| pickup_point | 예 | 이동의 출발점입니다. |
| 중간 대상 | 예 | 다중 목적지 이동만 해당: 운전자가 픽업과 하차 간에 방문하는 중간 목적지 목록입니다. |
| vehicle_waypoints | 예 | 공유 풀링 경로만 해당: 이 필드는 여러 경로의 중간 지점을 교체하는 기능을 지원합니다.
여기에는 할당된 차량의 나머지 모든 경유지와 이 경로의 픽업 및 하차 경유지가 포함됩니다. |
| number_of_passengers | 아니요 | 이동의 승객 수입니다. |
| dropoff_point | 아니요 | 경로의 도착지입니다. |
| vehicle_id | 아니요 | 이동에 할당된 차량의 ID입니다. |
예: 연달아 이동하는 경로 만들기
다음은 연달아 이동하는 경로를 만들고 차량에 할당하는 방법을 보여줍니다. 이 시나리오에서 경로 생성은 단일 대상 경로와 동일합니다. 나중에 다른 이동을 만들고 이미 활성 상태인 이동이 있는 차량에 할당합니다.
// 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;
}
연속 경로 업데이트
연달아 이동하는 경로에 차량을 할당하면 이미 차량에 경로가 할당되어 있더라도 차량에 경로를 할당합니다.
Fleet Engine에서 생성된 모든 이동 경로는 Fleet Engine에서 이동 경로 도착 예상 시간을 계산하고 추적할 수 있도록 차량에 할당되어야 합니다. 경로를 만들 때 또는 나중에 경로를 업데이트할 때 경로의 시작 시간과 종료 시간을 설정할 수 있습니다.
차량에 이동을 할당하면 Fleet Engine에서 연달아 발생한 이동과 연결된 중간 정류장을 차량의 중간 정류장 필드에 자동으로 추가합니다. 이동의 remainingWaypoints 필드에는 이동의 하차 전에 방문할 다른 이동의 와이포인트를 비롯한 모든 와이포인트의 목록이 포함됩니다.
예를 들어 연달아 발생한 두 경로(경로 A 및 경로 B)를 생각해 보겠습니다. 차량이 여정 A의 사용자를 태우고 있으며, 하차 위치로 이동하는 중에 운전자는 다음 여정인 여정 B의 다른 사용자를 태우라는 요청을 받습니다.
getVehicle()를 호출하면 다음을 포함하는remainingWaypoints가 반환됩니다.
A Drop-off → B Pickup → B Drop-off.getTrip()또는 경로 A의onTripRemainingWaypointsUpdated콜백은 다음을 포함하는remainingWaypoints을 반환합니다.
A 하차getTrip()또는 경로 B의onTripRemainingWaypointsUpdated콜백은
A 하차 → B 픽업 → B 하차를 포함하는remainingWaypoints를 반환합니다.