주문형 이동이란 무엇인가요?

이 섹션의 문서에서는 Google Maps Mobility 주문형 이동 서비스를 사용하여 이동을 만들고 작업하는 방법을 보여줍니다. 이 문서에서는 사용자가 다음에 익숙하다고 가정합니다.

사용할 TripService은 gRPC 및 REST에 사용할 수 있습니다. 간단히 말해 필드 참조는 gRPC 규칙을 따릅니다.

주문형 서비스를 위한 Fleet Engine에서 이동은 소비자의 음식 배달 또는 차량 요청 처리를 모델링하는 여정 유형입니다. 이동에는 이동이 진행됨에 따라 Fleet Engine에 보고하는 상태(예: NEW, ENROUTE_TO_PICKUP 등)가 있습니다. 이동 상태는 차량에 할당된 지리적 위치 경유지에 해당하며, Fleet Engine은 이동을 업데이트할 때마다 이러한 차량 경유지를 수정합니다. 이동 및 차량과의 관계에 관한 자세한 내용은 Fleet Engine 필수사항의 주문형 이동을 참고하세요.

이동의 수명

Fleet Engine에서 각 이동을 추적하려면 먼저 Trip 항목을 만들어야 합니다. gRPC 또는 REST를 참고하세요.

다음 표에서는 시스템에서 생성된 이동의 엔드 투 엔드 흐름 예시와 Fleet Engine에서의 수명 주기 단계를 설명합니다. Fleet Engine을 설정했고 운전자 앱에서 위치 업데이트가 사용 설정된 상태로 이동에 할당할 차량이 있다고 가정합니다. Driver SDK: 주문형 이동을 참고하세요.

1 예약 요청을 받습니다. Fleet Engine 이동이 시작되기 전에 예약 시스템은 먼저 앱 또는 다른 예약 시스템을 통해 소비자로부터 탑승 또는 배송 요청을 받습니다. 그러면 시스템에서 승차 위치와 같은 필수 필드가 있는 CreateTrip를 사용하여 이동 항목을 만듭니다. 이 시점에서 승객 및 하차 위치와 같은 다른 필드를 설정하거나 차량을 할당할 때까지 기다릴 수도 있습니다. 단일 목적지 이동 만들기를 참고하세요.
2 차량을 할당합니다.

시스템 내에서 직접 차량을 이동에 할당하고 할당을 Fleet Engine에 보고하거나 차량 검색 서비스를 사용하여 차량을 검색하고 이동 및 차량 속성으로 필터링하여 여정을 완료하는 데 가장 적합한 차량을 찾을 수 있습니다. 검색 반경 내에 있는 모든 온라인 차량은 Driver SDK에서 제공하는 위치 업데이트를 통해 근접성을 알립니다.

SearchVehicle가 이동에 일치하는 차량을 반환하면 시스템은 UpdateTrip 엔드포인트를 호출하여 NEW 이동에 할당한 차량 ID를 보고합니다.
3 이동 업데이트 운전자가 이동을 수락하고 픽업 위치로 이동하기 시작하면 시스템에서 이동 상태를 NEW에서 ENROUTE_TO_PICKUP로 업데이트합니다. 앱에서 백엔드로 직접 연결하거나 Driver SDK에서 지속적인 차량 위치 업데이트 스트림을 수신하는 Fleet Engine을 폴링하여 여정 내내 차량 위치를 계속 폴링합니다. 그러면 시스템에서 각 여정 마일스톤을 Fleet Engine에 보고하고, Fleet Engine은 이에 따라 차량의 경유지 목록을 업데이트합니다.
4 소비자와 여정을 공유합니다. Fleet Engine은 Consumer SDK에서 이동 세부정보와 차량 위치를 사용할 수 있도록 합니다. Consumer SDK는 리스너를 사용하여 이동 업데이트를 수신하고 소비자 앱에 표시합니다. Fleet Engine은 ETA, 남은 거리, 경로, 남은 차량 경유지를 자동으로 업데이트합니다. 자세한 내용은 주문형 이동의 여정 공유를 참고하세요.
5 이동을 완료합니다. 차량이 이동의 목적지 경유지에 도달하고 운전자가 이동이 완료되었음을 나타내면 시스템은 Fleet Engine에서 TripStatus를 COMPLETE로 설정합니다. 차량과 마찬가지로 이동 항목은 상태와 관계없이 7일 동안 Fleet Engine 내에서 활성 상태로 유지되며, 이 시점이 지나면 삭제됩니다.

이동 시퀀스 흐름

다음 다이어그램은 이 흐름을 더 자세히 보여줍니다.

TripSequenceDiagram

다음 단계