소비자 SDK 주문형 이동 개요

소비자가 주문, 이동, 기타 제공하는 서비스를 이용하는 동안 이동 상황을 확인할 수 있도록 하여 주문형 이동에 맞는 소비자 환경을 맞춤설정합니다.

소비자 SDK란 무엇인가요?

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

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

• Android
• iOS
• 자바스크립트

소비자 SDK를 사용해야 하는 이유

소비자 SDK를 주문형 이동 애플리케이션에 통합하면 거의 실시간 위치 업데이트와 도로 스냅 위치를 통해 포괄적인 소비자 환경을 제공할 수 있습니다. 소비자는 이동 중인 차량이나 배송 위치를 파악하는 데 도움이 되는 진행 상황 세부정보를 포함하여 차량 경로가 지도 위에 표시되는 것을 볼 수 있습니다.

소비자 SDK로 무엇을 할 수 있나요?

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

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

• 경로를 따라 이동하는 차량의 현재 위치를 따라가며 위치를 주기적으로 업데이트합니다.

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

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

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

소비자 SDK의 작동 방식

대략적으로 Consumer SDK는 다음 메커니즘을 사용합니다.

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

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

이 표는 이동 흐름과 그 뒤에 오는 소비자 앱을 보여줍니다.

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

소비자 SDK 사용 방법

소비자 앱에서 이동 추적을 시작하는 방법을 보려면 플랫폼을 선택하세요.

구성요소

이 섹션에서는 이동 경로를 추적하는 데 필요한 두 가지 구성요소를 요약합니다.

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

원하는 경우 다음 구성요소를 사용하여 소비자 환경을 맞춤설정할 수도 있습니다.

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

인증 토큰 가져오기 도구

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

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

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

지도 뷰 및 이동 추적기

경로 추적에는 차량 및 웨이포인트 시각화를 위한 구성요소와 운전자의 도착 예정 시간 또는 남은 운전 거리에 관한 원시 데이터 피드가 포함됩니다.

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

구성요소	설명
소비자 지도 보기	지도 뷰는 경로의 수명 주기를 관리하여 경로가 진행되는 동안 차량 위치의 중간 지점을 표시합니다. 차량의 경로가 알려진 경우 지도 뷰는 차량 경로 다중선이 경로를 따라 차량의 진행 상황을 나타내도록 업데이트합니다.
JavaScript의 이동 위치 정보 제공자	JavaScript 웹 앱의 경우 이동 위치 제공업체가 추적된 객체의 위치 정보를 공유 이동 지도에 제공합니다. 자세한 내용은 경로 위치 제공자 인스턴스화를 참고하세요. 경로 위치 정보 제공자를 사용하여 여행에 대한 다음 세부정보를 추적할 수 있습니다. 이동의 승차 또는 하차 위치입니다. 이동에 할당된 차량의 위치와 경로입니다.

추적된 위치 객체

위치 제공업체는 다음 표에 설명된 대로 웨이포인트 및 차량과 같은 객체의 위치를 추적합니다.

추적된 위치	설명
수령 위치	픽업 위치는 이동이 시작되는 위치입니다.
대상 위치	도착 위치는 이동이 종료되는 위치입니다. 하차 위치를 표시합니다.
경유지 위치	중간 지점 위치는 추적된 경로의 중간 위치입니다. 기술적으로는 중간 지점에는 픽업 및 하차 위치가 포함될 수 있지만, 일반적으로 중간 지점은 경로 중간의 중간 정류장을 의미합니다. 예를 들어 배송 경로의 승차 위치와 목적지 위치 사이의 정류장은 경유지 위치입니다. 자세한 내용은 Fleet Engine 문서의 경로 웨이포인트를 참고하세요.
차량 위치	차량 위치는 차량의 보고된 위치입니다. 자세한 내용은 Fleet Engine 문서의 차량 위치를 참고하세요.

지도 스타일 지정하기

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

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

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

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

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

다음 단계

이동 경로를 추적하려는 플랫폼의 문서를 참고하세요.

• Android
• iOS
• 자바스크립트