Introduction
NaviHelper SDK는 경로 안내 제어와 내비게이션 정보 조회를 위한 API를 제공합니다. 3rd party 앱은 NaviHelper SDK를 통해 Pleos Connect의 Navi Service와 연동됩니다. 3rd party 앱이 목적지·경유지 설정, 경로 변경, 정보 조회 또는 Navigation 화면 표시를 요청하면 Navi Service가 이를 처리하고, 처리 결과와 주행 상태 변화를 이벤트로 전달합니다.
개요
NaviHelper SDK는 다음 기능을 제공합니다.
- 목적지 설정·확인·취소
- 경로 옵션 변경 및 재탐색
- 경유지 추가·조회·제거
- 경로 탐색과 주행 상태 이벤트 수신
- 내비게이션 정보 조회 및 Navigation 화면 요청 (API Reference 참고)
NaviHelper 요청은 Pleos Connect Navigation 앱에 전달됩니다. 요청 결과와 주행 중 변경 사항은 NaviHelperEventListener의 콜백으로 전달됩니다. 실제로 전달되는 이벤트는 Navigation 앱의 구현과 현재 상태에 따라 달라질 수 있습니다.
Entry point
NaviHelper가 SDK의 진입점입니다. 일반적인 사용 순서는 다음과 같습니다.
NaviHelper객체를 생성합니다.initialize()로 SDK 연결을 초기화합니다.addListener()로 이벤트 리스너를 등록합니다.- 경로 요청 또는 정보 조회 API를 호출합니다.
- 콜백으로 결과와 상태 변화를 처리합니다.
removeListener()와release()로 리소스를 정리합니다.
패키지 구조와 전체 API 명세는 NaviHelper API Reference에서 확인할 수 있습니다.
Emulator setup
NaviHelper SDK를 사용하려면 Android Studio에 Pleos Connect Emulator를 설치하고 AVD를 설정해야 합니다.