이 가이드에서는 Fleet Engine에서 직접 이동 데이터를 사용할 수 있습니다. 이 접근 방식을 사용하여 최종 사용자 환경에 대한 제어 권한을 유지하면서도 Fleet를 계속 활용할 수 있습니다. 엔진의 정확한 실시간 차량 위치, 도착예정시간, 경로를 제공합니다.
소비자 SDK 사용에 대한 자세한 내용은 주문형 여정 공유를 참조하세요. 여정에 대해 자세히 알아보세요.
여행 정보 가져오기
Fleet Engine에서 직접 이동 정보를 가져오려면 GetTrip
를 호출하세요.
메서드로 JOURNEY_SHARING_V1S
뷰를 지정합니다. RPC 또는 REST 참조를 확인하세요.
일반적으로 서버는 사용자가 차량 진행 상황을 적극적으로 모니터링하는 동안 이동 서비스에서 각 이동의 상태를 폴링합니다. 차량 위치
업데이트는 일반적으로 10초마다 이루어지며
시스템은 해당 시간 동안
요율이 같습니다 Trip.last_location.update_time
필드를 모니터링하여
이전 GetTrip
호출 이후 업데이트가 있습니다.
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "trip-A";
String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_ID;
GetTripRequest getTripRequest =
GetTripRequest.newBuilder()
.setName(tripName)
.setView(JOURNEY_SHARING_V1S)
.build();
Trip trip = tripService.getTrip(getTripRequest);
결과 Trip
객체에는
여행에 사용할 수 있는 정보:
name |
trip_status |
remaining_waypoints |
vehicle_id |
trip_type |
last_location |
number_of_passengers |
pickup_point |
view (== JOURNEY_SHARING_V1S) |
actual_pickup_point |
intermediate_destinations |
intermediate_destination_index |
pickup_time |
intermediate_destinations_version |
dropoff_point |
actual_dropoff_point |
dropoff_time |
|
나머지 경유지 가져오기
여행 항목에 TripWaypoint
유형의 반복되는 입력란이 포함되어 있습니다. 이 입력란
에는 출발하기 전에 차량이 이동해야 하는 모든 경유지가 포함됩니다.
목적지에 도착하지 않습니다. 탐색 여정 공유 뷰를 지정하면
나머지 경유지[0]에 업데이트된 정보를 입력하는 Fleet Engine
TripWaypoint
여정 공유가 아닌 다른 보기에서는 해당 경유지가
일반적으로 할당된 차량의 최신 위치를 반영합니다. 자세한 내용은
RPC 또는 REST에 대한 참조입니다.
자세한 내용은 운행 소개 가이드의 운행 상태 및 남은 차량 웨이포인트를 참고하세요.
다음은 이동 A에 대한 remaining_waypoints
필드의 예입니다.
| |||||||||||||||||||||
|
연달아 풀링 여행을 공유하는 경우 이 목록에는 경유지가 포함될 수 있습니다.
이 여정 전에 통과해야 하는 다른 이동의 거리가 될 수 있습니다. 예를 들어
경로 B가 이동 A와 동일한 차량에 할당되는 시나리오입니다. 이
그러면 이동 A의 remaining_waypoints
필드가 다음과 같이 채워집니다.
간결성을 위해 대부분의 필드가 생략되었지만
이전 예와 일치하도록 채워졌습니다.
[0] | trip_id = "trip_A" |
---|---|
경유지_유형 = PICKUP_WAYPOINT_TYPE | |
[1] | trip_id = "trip_B" |
경유지_유형 = PICKUP_WAYPOINT_TYPE | |
[2] | trip_id = "trip_B" |
경유지_유형 = DROP_OFF_WAYPOINT_TYPE | |
[3] | trip_id = "trip_A" |
경유지_유형 = DROP_OFF_WAYPOINT_TYPE |
이동 B의 remaining_waypoint
필드는 비슷하게 채워지지만
이동 A의 하차 지점이 포함되어 있지 않으므로 첫 3개의 항목이 표시됩니다.
운행 정보를 제공합니다.