주문형 이동에 Fleet Engine 여정 공유를 사용하면 소비자가 사용자가 제공한 주문, 차량 공유 또는 기타 서비스의 진행 상황을 추적할 수 있습니다.
여정 공유란 무엇인가요?
여정 공유는 주문형 탑승을 위한 Fleet Engine의 기능으로, 소비자 SDK 이동 데이터를 모델링하고 이동 상황을 추적하는 인터페이스를 제공합니다. 다양한 세션을 제공하며, 풍부한 리소스를 만드는 데 사용할 수 있는 지도 기반 표시로 일반 사용자에게 여행 정보를 표시할 수도 있습니다. 사용자는 앱에 연결하고 Fleet Engine 내의 적절한 역할 프로필을 설정하여 소비자의 여정 공유 사용을 지원합니다
여정 공유는 플랫폼별 API를 제공하므로 여정을 빌드할 수 있습니다. 공유할 수 있습니다. 소비자 SDK는 다음과 같은 플랫폼을 사용할 수 있습니다.
여정 공유를 사용해야 하는 이유
여정 공유를 주문형 여행 애플리케이션에 통합하면 실시간에 가까운 속도로 포괄적인 차량 모니터링 환경을 위치 업데이트 및 도로 맞추기 위치가 포함됩니다. 내 소비자는 차량의 경로를 지도 위에 오버레이하여 볼 수 있습니다. 차량 또는 배송 위치를 이해하는 데 도움이 되는 진행 세부정보
여정 공유로 무엇을 할 수 있나요?
드라이버 SDK 및 Fleet Engine의 정보를 사용해 다음과 같은 기능을 제공하는 웹 서비스 응답을 제공합니다.
브랜딩 요구사항에 맞게 지도 UI 맞춤설정을 제공합니다.
경로를 따라 이동하는 차량의 현재 위치 위치가 주기적으로 업데이트됩니다
승차 및 하차 위치의 예상 도착 시간 (ETA)입니다.
남은 거리입니다.
경로상의 실시간 교통정보
여정 공유 작동 방식
대략적으로 여정 공유는 다음과 같은 메커니즘을 사용합니다.
- 적절한 Fleet Engine 사용자 역할로 인증된 앱 사용자가 해당 주문과 관련된 이동을 가져옵니다.
- 소비자와 여행 간의 연결로, 판매자가 제공한 것입니다. 사용할 수 있습니다
- 소비자 SDK
TripModel및JourneySharingSession, 소비자 앱에서 여행 데이터를 모델링하고 여행 세션을 공유할 수 있습니다.
또한 소비자 SDK는 다른 인터페이스와 클래스를 제공하므로 앱을 위한 매핑 사용자 인터페이스를 제작하여 소비자가 교통정보, 지도 마커, 도착예정시간, 경로 데이터.
이 표에서는 공유된 여정의 흐름을 보여줍니다.
| 1 | 소비자 앱에서 여행을 요청합니다. | 백엔드 서버가 주문형 이동 요청을 받고
있습니다.
|
| 2 | 운전자가 여정을 수락합니다. | 운전자 앱이 이동 ID와 경로 정보를 가져오고 운전자는 경로를 수락합니다. |
| 3 | 소비자 앱에서 여정에 대한 액세스를 요청함 | 소비자 앱이 백엔드에서 이동 ID를 가져오고 요청할 수 있습니다 |
| 4 | 운전자가 이동을 시작함 | 운전자가 운전자 앱을 사용하여 경로 이동이 시작되었음을 나타내는 경우 앱이 드라이버 SDK를 통해 백엔드 서버에 알립니다. 예를 들어 운전자가 식당을 떠나거나 픽업 위치로 운전하려고 합니다. |
| 5 | 여정 공유를 시작한 Fleet Engine | Fleet Engine에서 여정 추적 및 공유 시작 진행 상황을 확인할 수 있습니다 |
| 6 | 여정을 보여주는 소비자 앱 | 소비자 앱은 소비자에게 알리고 이들이 진행됨에 따라 여정을 업데이트합니다. |
| 7 | 이동 완료 또는 취소 | 운전자가 이동을 취소하거나 완료하면 드라이버 앱이 위치 추적을 비활성화하고 백엔드 서버는 Fleet Engine에 이동을 취소 또는 완료로 표시하라고 지시합니다. |
| 8 | 소비자 앱에서 여정 공유를 중단함 | 여정이 취소 또는 완료로 표시됩니다. |
| 9 | 이 과정은 다음 이동에도 반복됩니다. | 새 이동이 생성되고 프로세스가 반복됩니다. |
여정 공유 사용 방법
플랫폼을 선택하여 여정 공유를 시작하는 방법을 알아보세요.
Android
| 1 | Android에서 소비자 SDK 설정 | 앱에서 주문형 여행 여정을 공유하려면 소비자 SDK를 설정하세요. 자세한 내용은 Android 소비자 SDK 가져오기를 참고하세요. |
| 2 | 여정 공유 시각적 인터페이스 설정 | 지도를 정의하고 벡터 지도 지원을 추가하여 여정의 인터페이스를 설정하세요. 자세한 내용은 지도 설정하기를 참고하세요. |
| 3 | 여정 공유하기 | 이동 경로를 따라 적절한 차량의 위치를 소비자에게 공유합니다. 자세한 내용은 경로 팔로우하기를 참고하세요. |
| 5 | 여정 진척도 업데이트 및 이동 오류 처리 | 이동 거리, 도착 예정 시간 등 이동 여정에 대한 세부정보를 업데이트하고 해당 여정 중 발생하는 오류를 처리합니다. 자세한 내용은 이동 상황 업데이트 경로 오류를 처리합니다. |
| 5 | 여정이 끝나면 공유 중지하기 | 소비자에 대한 차량 위치 공유를 중지하려면 이동 팔로우를 중지하세요. 자세한 내용은 경로 팔로우 중지하기를 참고하세요. |
iOS
| 1 | iOS에서 소비자 SDK 설정 | 앱에서 주문형 여행 여정을 공유하려면 소비자 SDK를 설정하세요. 자세한 내용은 iOS 소비자 SDK 가져오기를 참고하세요. |
| 2 | 여정 공유 시각적 인터페이스 설정 | 지도뷰를 초기화하고 지도 이벤트를 처리하여 여정의 인터페이스를 설정합니다. 자세한 내용은 지도 설정하기를 참고하세요. |
| 3 | 여정 공유하기 | 이동 경로를 따라 적절한 차량의 위치를 소비자에게 공유합니다. 자세한 내용은 경로 팔로우하기를 참고하세요. |
| 5 | 여정 진척도 업데이트 및 이동 오류 처리 | 이동 거리, 도착 예정 시간 등 이동 여정에 대한 세부정보를 업데이트하고 해당 여정 중 발생하는 오류를 처리합니다. 자세한 내용은 이동 상황 업데이트 경로 오류를 처리합니다. |
| 5 | 여정이 끝나면 공유 중지하기 | 소비자에게 차량 위치 공유를 중지하려면 경로 팔로우를 중지하세요.자세한 내용은 경로 팔로우 중지하기를 참고하세요. |
자바스크립트
| 1 | JavaScript에서 탐색 여정 공유 설정하기 | 앱에서 주문형 여행 여정을 공유하려면 소비자 SDK를 설정하세요. 자세한 내용은 JavaScript 소비자 SDK 설정을 참고하세요. |
| 2 | 여정 공유 지도 로드 및 맞춤설정하기 | Maps JavaScript API를 사용 설정하고 여정의 인터페이스를 설정하기 위한 승인을 설정합니다. 자세한 내용은 지도 설정하기를 참고하세요. |
| 3 | 여정 공유하기 | 이동 경로를 따라 적절한 차량의 위치를 소비자에게 공유합니다. 자세한 내용은 경로 팔로우하기를 참고하세요. |
| 5 | 여정 진척도 업데이트 및 이동 오류 처리 | 이동 거리, 도착 예정 시간 등 이동 여정에 대한 세부정보를 업데이트하고 해당 여정 중 발생하는 오류를 처리합니다. 자세한 내용은 이동 상황 업데이트 및 확인하기 경로 오류를 처리합니다. |
| 5 | 여정이 끝나면 공유 중지하기 | 소비자에 대한 차량 위치 공유를 중지하려면 이동 팔로우를 중지하세요. 자세한 내용은 여정 공유 중지하기를 참고하세요. |
구성요소
이 섹션에서는 여정을 공유하는 데 필요한 두 가지 구성요소를 요약합니다.
원하는 경우 다음을 사용하여 여정 공유 환경을 맞춤설정할 수도 있습니다. 구성요소:
인증 토큰 가져오기 도구
Fleet Engine에 저장된 위치 데이터에 대한 액세스를 제어하려면 다음을 수행해야 합니다. 있습니다.
Fleet Engine용 JSON 웹 토큰 (JWT) 생성 서비스 구현 있습니다.
웹 또는 모바일 앱에서 인증 토큰 가져오기 도구 구현 위치 데이터 액세스를 인증해야 합니다.
대상 자세한 내용은 Android 설정 가이드를 참조하세요. iOS 또는 JavaScript
지도 뷰 및 이동 추적기
여정 공유에는 시각화를 위한 구성요소가 포함됨 운전자의 도착예정시간에 대한 원시 데이터 피드와 함께 또는 남은 거리를 확인할 수 있습니다.
다음 표에서는 이러한 구성요소를 설명합니다.
| 구성요소 | 설명 |
|---|---|
| 여정 공유 지도뷰 | 지도뷰는 경유지를 표시하는 여정의 수명 주기를 관리합니다. 을 사용합니다. 차량 경로가 알려진 경우 지도 보기에서 차량 경로를 업데이트합니다. 경로를 따라 차량의 진행 상황을 나타냅니다. |
| JavaScript의 이동 위치 정보 제공자 | JavaScript 웹 앱의 경우 여행 위치 제공자가 위치를 피드합니다.
공유된 여정 맵에 추적한 객체의 정보를 저장합니다. 자세한 내용은
자세한 내용은
이동 위치 정보 제공자를 인스턴스화합니다.
여행 위치 정보 제공자를 사용해
이동:
|
추적된 위치 객체
위치 제공자는 경유지 및 목적지와 같은 객체의 위치를 추적합니다. 차량을 식별할 수 있습니다.
| 추적된 위치 | 설명 |
|---|---|
| 수령 위치 | 승차 위치는 여정이 시작되는 위치입니다. 그것은 표시 승차 위치입니다. |
| 대상 위치 | 목적지 위치는 여정이 끝나는 위치입니다. 하차 위치를 표시합니다. |
| 경유지 위치 | 경유지 위치는 목적지의 경로에 있는 중간 위치입니다. 추적할 수 있습니다. 엄밀히 말해 경유지에는 승차 및 하차 위치이며, 경유지는 일반적으로 중간 위치를 의미합니다 정류장이 있습니다. 예를 들어 승차와 목적지 사이의 정류장입니다. 배송 경로의 위치는 경유지 위치입니다. 자세한 내용은 이동 경유지 참조하세요 |
| 차량 위치 | 차량 위치는 차량의 보고된 위치입니다. 자세한 내용은 자세한 내용은 차량 위치를 참고하세요. 참조하세요 |
지도 스타일 지정
마커와 폴리라인 스타일은 지도에 추적된 위치 객체를 표시합니다. 이때 스타일에 맞게 기본 스타일을 변경하는 맞춤 스타일 지정 옵션 웹 애플리케이션의 API입니다
추적된 위치의 공개 상태 관리
Fleet Engine의 사전 정의된 위치 제공업체는 다음 공개 상태 규칙을 따릅니다. 지도에서 추적된 위치 객체에 사용됩니다. 커스텀 또는 파생 제품을 만드는 경우 위치 제공자의 경우 공개 상태 규칙을 변경할 수 있습니다.
이동 중일 때만 차량이 표시됨: 여정 차량이 이동에 할당된 시점부터 수 있습니다. 이동이 취소되면 차량이 더 오래 표시됩니다.
기타 모든 위치 마커 항상 표시: 기타 모든 위치 마커 출발지, 목적지 및 경유지가 항상 지도에 표시됩니다. 대상 예: 여정 공유: 하차 위치 또는 배송 위치는 지도의 상태에 관계없이 항상 지도에 배송을 요청할 수 있습니다
다음 단계
여정을 공유할 플랫폼의 문서를 참조하세요.