이 섹션의 문서에서는 Google 지도 모빌리티 주문형 이동 서비스로 이동을 만들고 사용하는 방법을 보여줍니다. 다음에 익숙하다고 가정합니다.
- Fleet Engine: Fleet Engine 구현 세부정보, 요청 메커니즘, 보안에 대해 잘 알고 있어야 합니다. 자세한 내용은 Fleet Engine 서비스란 무엇인가요? 및 Fleet Engine 설정의 보안 주제를 참고하세요.
- 주문형 서비스의 차량 기본사항 차량 소개를 참고하세요.
- 주문형 서비스의 경로 기본사항 주문형 이동을 참고하세요.
사용할 TripService
는 gRPC 및 REST에서 사용할 수 있습니다.
편의상 필드 참조는 gRPC 규칙을 따릅니다.
주문형 서비스용 Fleet Engine에서 이동은 소비자의 음식 배달 또는 차량 공유 요청 처리를 모델링하는 여정의 한 유형입니다. 이동에는 NEW
, ENROUTE_TO_PICKUP
등 이동이 진행됨에 따라 Fleet Engine에 보고하는 상태가 있습니다. 이동 상태는 차량에 할당된 위치 기반 웨이포인트에 해당하며, Fleet Engine은 이동을 업데이트할 때마다 이러한 차량 웨이포인트를 수정합니다. 이동 경로 및 차량과의 관계에 관한 자세한 내용은 Fleet Engine 기본사항의 주문형 이동 경로를 참고하세요.
경로 수명
Fleet Engine에서 각 이동을 추적하려면 먼저 Trip
항목을 만들어야 합니다. 참고로 gRPC 또는 REST를 참고하세요.
다음 표에서는 시스템에서 생성된 이동의 엔드 투 엔드 흐름 예시와 Fleet Engine의 수명 주기 단계를 설명합니다. Fleet Engine을 설정하고 운전자 앱에서 위치 업데이트를 사용 설정하여 이동에 할당할 차량이 있다고 가정합니다. 운전자 SDK: 주문형 이동을 참고하세요.
1 | 예약 요청을 받습니다. | Fleet Engine 이동이 시작되기 전에 먼저 앱 또는 다른 예약 시스템을 통해 소비자로부터 이동 또는 배송 요청이 예약 시스템에 수신됩니다. 그러면 시스템에서 CreateTrip 를 사용하여 픽업 위치와 같은 필수 입력란이 있는 이동 항목을 만듭니다.
이 시점에서 승객 및 하차 위치와 같은 다른 필드를 설정하거나 차량이 할당될 때까지 기다릴 수도 있습니다. 단일 목적지 경로 만들기를 참고하세요. |
2 | 차량을 할당합니다. | 시스템 내에서 직접 차량을 이동에 할당하고 할당을 Fleet Engine에 보고하거나 차량 검색 서비스를 사용하여 차량을 검색하고 이동 및 차량 속성으로 필터링하여 이동을 완료할 최적의 차량을 찾을 수 있습니다. 검색 반경 내에 있는 모든 온라인 차량은 Driver SDK에서 제공하는 위치 업데이트를 통해 근접성을 알립니다.
|
3 | 이동 경로 업데이트. | 운전자가 이동을 수락하고 픽업 위치로 이동하기 시작하면 시스템에서 이동 상태를 NEW 에서 ENROUTE_TO_PICKUP 로 업데이트합니다. 앱에서 백엔드로 직접 연결하거나 Driver SDK에서 차량 위치 업데이트 스트림을 수신하는 Fleet Engine을 폴링하여 이동 중에 차량 위치를 계속 폴링합니다. 그러면 시스템이 각 이동 마일스톤을 Fleet Engine에 보고하고 Fleet Engine은 그에 따라 차량의 중간 지점 목록을 업데이트합니다.
|
4 | 소비자와 여정을 공유합니다. | Fleet Engine은 경로 세부정보와 차량 위치를 Consumer SDK에 제공합니다. Consumer SDK는 리스너를 사용하여 경로 업데이트를 수신하고 소비자 앱에 표시합니다. Fleet Engine은 도착 예정 시간, 남은 거리, 경로, 남은 차량 경유지 웨이포인트를 자동으로 업데이트합니다. 자세한 내용은 주문형 이동의 여정 공유를 참고하세요. |
5 | 여정을 완료합니다. | 차량이 이동의 도착 웨이포인트에 도달하고 운전자가 이동 완료를 나타내면 시스템은 Fleet Engine에서 TripStatus 를 COMPLETE 로 설정합니다. 차량과 마찬가지로 이동 항목은 상태와 관계없이 7일 동안 Fleet Engine 내에서 활성 상태로 유지되며, 이 기간이 지나면 삭제됩니다. |
이동 시퀀스 흐름
다음 다이어그램은 이 흐름을 더 자세히 보여줍니다.