Fleet Engine에서 직접 이동 데이터 검색

이 가이드에서는 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 필드의 예입니다.

[0] location.point = trip.pickup_point.point
trip_id = "trip_A"
waypoint_type = PICKUP_WAYPOINT_TYPE
path_to_waypoint = LatLng[] 남은 경로에서 승차까지의 첫 번째 LatLng
수령까지의 남은 경로에서 두 번째 LatLng
...
수령까지의 남은 경로의 마지막 LatLng
pickup_point(마지막과 다른 경우)
traffic_data
distance_meters = 현재 vehicle_location에서 path_to_waypoint를 따라 pickup까지의 거리
eta = 업데이트된 도착예정시간
duration = 업데이트된 기간
[1] location.point = trip.dropoff_point.point
trip_id = "trip_A"
경유지_유형 = DROP_OFF_WAYPOINT_TYPE
path_to_경유지 = LatLng[] 하차 구간에서 첫 번째 LatLng
하차 구간의 두 번째 LatLng
...
하차 구간의 마지막 LatLng
dropoff_point(마지막과 다른 경우)
traffic_data
speed_meters = path_to_경유지 승차에서 하차 지점까지의 거리
eta = 업데이트된 도착예정시간
duration = 하차 구간 소요 시간

연달아 풀링 여행을 공유하는 경우 이 목록에는 경유지가 포함될 수 있습니다. 이 여정 전에 통과해야 하는 다른 이동의 거리가 될 수 있습니다. 예를 들어 경로 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개의 항목이 표시됩니다. 운행 정보를 제공합니다.