Introduction

The NaviHelper SDK provides APIs for controlling route guidance and retrieving navigation information. Third-party apps use the NaviHelper SDK to integrate with Pleos Connect's Navi Service. When a third-party app requests destination or waypoint settings, route changes, navigation information, or a Navigation screen, Navi Service processes the request and delivers the result and driving-state changes as events.

Overview

The NaviHelper SDK provides the following features:

• Set, check, and cancel a destination
• Change route options and request rerouting
• Add, retrieve, and remove waypoints
• Receive route search and driving-state events
• Retrieve navigation information and request a Navigation screen (see the API Reference)

NaviHelper forwards requests to the Pleos Connect Navigation app. Request results and changes that occur while driving are delivered through NaviHelperEventListener callbacks. The events that are delivered may vary depending on the implementation and current state of the Navigation app.

Entry point

NaviHelper is the entry point to the SDK. Use the SDK in the following order:

1. Create a NaviHelper object.
2. Initialize the SDK connection with initialize().
3. Register an event listener with addListener().
4. Call a route request or information retrieval API.
5. Handle the result and state changes through callbacks.
6. Clean up resources with removeListener() and release().

For the package structure and complete API specifications, see the NaviHelper API Reference.

Emulator setup

To use the NaviHelper SDK, install the Pleos Connect Emulator in Android Studio and configure an AVD.

1. Check development environment requirements
2. Install the Pleos Connect Emulator
3. Create and run an AVD
4. Configure microphone access
5. Configure cold boot
6. Connect a Bluetooth dongle to the AVD