소비자 SDK 주문형 이동 개요

소비자가 주문, 탑승 또는 제공하는 기타 서비스의 이동을 따라갈 수 있도록 허용하여 주문형 이동의 소비자 환경을 맞춤설정합니다.

Consumer SDK란 무엇인가요?

Consumer SDK는 주문형 이동을 위한 Fleet Engine의 일부입니다. 이동 데이터를 모델링하고 Fleet Engine에서 이동을 따르는 인터페이스를 제공하며, 소비자 사용자와 여정을 공유하기 위한 지도 기반의 풍부한 디스플레이를 만드는 데 사용하는 클래스를 제공합니다. Consumer SDK를 앱에 통합하고 Fleet Engine 내에서 적절한 역할 프로필을 설정하여 이 소비자 환경을 만듭니다.

Consumer SDK 플랫폼별 API를 사용하면 애플리케이션에 여정을 기본적으로 공유하는 기능을 빌드할 수 있습니다. Consumer SDK는 다음 플랫폼에서 사용할 수 있습니다.

• Android
• iOS
• JavaScript

Consumer SDK를 사용하는 이유는 무엇인가요?

Consumer SDK를 주문형 이동 애플리케이션에 통합하면 거의 실시간 위치 업데이트와 도로에 스냅된 위치를 통해 포괄적인 소비자 환경을 제공할 수 있습니다. 소비자는 탑승 또는 배송 위치를 파악하는 데 도움이 되는 진행률 세부정보를 비롯하여 지도 위에 오버레이된 차량의 경로를 확인할 수 있습니다.

Consumer SDK로 할 수 있는 작업

Driver SDK 및 Fleet Engine의 정보를 사용하여 다음 기능을 비롯한 맞춤형 소비자 환경을 만들 수 있습니다.

• 브랜드 요구사항에 맞게 지도 UI를 맞춤설정합니다.

• 차량이 경로를 따라 이동할 때 차량의 현재 위치를 따라가고 위치는 주기적으로 업데이트됩니다.

• 픽업 및 하차 위치의 도착 예정 시간 (ETA)을 표시합니다.

• 남은 거리를 표시합니다.

• 경로에 실시간 교통정보를 표시합니다.

Consumer SDK 작동 방식

대략적으로 Consumer SDK는 다음 메커니즘에 의존합니다.

• 인증된 앱이 소비자의 주문과 연결된 이동을 따라갈 수 있도록 적절한 Fleet Engine 역할이 있어야 합니다.
• 백엔드 시스템에서 제공하는 소비자와 이동 간의 연결입니다.
• 이동 데이터를 모델링하고 소비자 앱에서 이동 세션을 공유하는 TripModel 및 JourneySharingSession SDK 클래스입니다.

Consumer SDK는 교통정보, 지도 마커, ETA, 경로 데이터와 같은 세부정보가 포함된 풍부한 앱 환경을 만들 수 있도록 다른 인터페이스와 클래스도 제공합니다.

이 표는 소비자 앱에서 따르는 이동의 흐름을 보여줍니다.

1	소비자 앱에서 이동을 요청합니다	백엔드 서버에서 주문형 이동 요청을 받고 다음을 실행합니다. 다음: Fleet Engine에서 이동을 만듭니다. 이동을 차량에 할당합니다.
2	운전자가 이동을 수락합니다	운전자 앱에서 이동 ID와 이동 정보를 가져오고 운전자가 이동을 수락합니다.
3	소비자 앱에서 이동을 따라갈 수 있는 액세스 권한을 요청합니다	소비자 앱에서 백엔드에서 이동 ID를 가져오고 이동을 따라가기 시작하도록 요청합니다.
4	운전자가 이동을 시작합니다	운전자가 운전자 앱을 사용하여 이동이 시작되었음을 나타내면 앱에서 Driver SDK를 통해 백엔드 서버에 알립니다. 예를 들어 운전자가 음식점을 떠나거나 픽업 위치로 운전하려는 경우입니다.
5	Fleet Engine에서 이동 정보 전송을 시작합니다	Fleet Engine에서 이동 추적을 시작하고 진행률을 소비자 앱과 공유합니다.
6	소비자 앱에서 이동 정보를 표시합니다	소비자 앱에서 소비자에게 알리고 이동 정보를 표시하기 시작하며 이동이 진행됨에 따라 이동을 업데이트합니다.
7	이동이 취소되거나 완료됩니다	운전자가 이동을 취소하거나 완료하면 운전자 앱에서 위치 추적을 사용 중지하고 백엔드 서버에서 Fleet Engine에 이동을 취소됨 또는 완료됨으로 표시하도록 지시합니다.
8	소비자 앱에서 이동을 따라가는 것을 중지합니다	이동이 취소됨 또는 완료됨으로 표시됩니다.
9	다음 이동에 대해 프로세스가 반복됩니다	새 이동이 생성되고 프로세스가 반복됩니다.

Consumer SDK를 사용하는 방법

플랫폼을 선택하여 소비자 앱에서 이동을 따라가기 시작하는 방법을 확인하세요.

구성요소

이 섹션에서는 이동을 따라가는 데 필요한 두 가지 구성요소를 요약합니다.

• 인증 토큰 가져오기 도구
• 지도 뷰 및 이동 추적기

선택적으로 다음 구성요소를 사용하여 소비자 환경을 맞춤설정할 수도 있습니다.

• 지도 스타일 지정
• 추적된 위치의 공개 상태 제어.

인증 토큰 가져오기 도구

Fleet Engine에 저장된 위치 데이터에 대한 액세스를 제어하려면 다음을 실행해야 합니다.

1. 서버에서 Fleet Engine용 JSON 웹 토큰 (JWT) 생성 서비스를 구현합니다. 자세한 내용은 JWT 발급을 참고하세요.

2. 웹 또는 모바일 앱에서 인증 토큰 가져오기 도구를 구현하여 위치 데이터에 대한 액세스를 인증합니다. 토큰 가져오기 도구 설정에 관한 자세한 내용은 Android, iOS 또는 JavaScript 설정 가이드를 참고하세요.

지도 뷰 및 이동 추적기

이동을 따라가는 데는 차량 및 경유지 시각화를 위한 구성요소와 운전자의 ETA 또는 운전할 남은 거리에 대한 원시 데이터 피드가 포함됩니다.

다음 표에서는 이러한 구성요소를 설명합니다.

구성요소	설명
소비자 지도 뷰	지도 뷰는 이동의 수명 주기를 관리하고 이동이 진행됨에 따라 차량 위치의 경유지를 표시합니다. 차량의 경로를 알고 있는 경우 지도 뷰는 차량 경로 다중선을 업데이트하여 경로를 따라 차량의 진행률을 나타냅니다.
자바스크립트의 이동 위치 제공업체	JavaScript 웹 앱의 경우 이동 위치 제공업체는 추적된 객체의 위치 정보를 공유 이동 지도에 제공합니다. 자세한 내용은 이동 위치 제공업체 인스턴스화를 참고하세요. 이동 위치 제공업체를 사용하여 이동의 다음 세부정보를 추적할 수 있습니다. 이동의 픽업 또는 하차 위치 이동에 할당된 차량의 위치 및 경로

추적된 위치 객체

위치 제공업체는 다음 표에 설명된 대로 경유지 및 차량과 같은 객체의 위치를 추적합니다.

추적된 위치	설명
수령 위치	수령 위치는 이동이 시작되는 위치입니다.
대상 위치	대상 위치는 이동이 종료되는 위치입니다. 하차 위치를 표시합니다.
경유지 위치	경유지 위치는 추적된 이동의 경로를 따라 있는 중간 위치입니다. 엄밀히 말하면 경유지에는 픽업 및 하차 위치가 포함될 수 있지만 일반적으로 경유지는 경로를 따라 있는 중간 정류장을 나타냅니다. 예를 들어 배송 경로의 픽업 위치와 대상 위치 사이의 정류장은 경유지 위치입니다. 자세한 내용은 Fleet Engine 문서의 이동 경유지 를 참고하세요.
차량 위치	차량 위치는 보고된 차량 위치입니다. 자세한 내용은 Fleet Engine 문서의 차량 위치를 참고하세요.

지도 스타일 지정

마커 및 다중선 스타일은 지도에서 추적된 위치 객체의 디자인과 분위기를 결정합니다. 맞춤 스타일 지정 옵션을 사용하여 웹 애플리케이션의 스타일과 일치시킬 수 있습니다.

추적된 위치의 공개 상태 제어

Fleet Engine의 미리 정의된 위치 제공업체는 지도에서 추적된 위치 객체에 대해 다음 공개 상태 규칙을 따릅니다. 맞춤 또는 파생된 위치 제공업체를 만드는 경우 공개 상태 규칙을 변경할 수 있습니다.

• 이동이 진행 중일 때만 차량이 표시됨: 이동 차량 은 이동에 할당된 시간부터 하차 시간까지 표시됩니다. 이동이 취소되면 차량이 더 이상 표시되지 않습니다.

• 다른 모든 위치 마커는 항상 표시됨: 출발지, 목적지, 경유지의 다른 모든 위치 마커는 항상 지도에 표시됩니다. 예를 들어 이동 하차 위치 또는 배송 위치는 이동 또는 배송 상태와 관계없이 항상 지도에 표시됩니다.

다음 단계

이동을 따라가려는 플랫폼의 문서를 참고하세요.

• Android
• iOS
• JavaScript