Using Navigine Application for Android¶
Navigine demo application enables you to test indoor navigation as well as measure your target location's radiomap.
Before you begin¶
Log into the CMS.
Switch to the User Information tab using the button in the left-most part of the screen to find the user ID.
Add Location as described here: Locations tab.
Installing the Navigine Application¶
To install the Navigine application for Android, please find Navigine at Google Play.
You can also download source codes of the Demo application, where you can find examples on how to integrate Navigine SDK. They are available at GitHub.
Please note that you can find full documentation about integrating Navigine SDK here.
You need internet connection on the target device to work with the application.
First steps with demo application¶
Sign in the Demo Application. Apply e-mail and password that you used in the CMS website.
Choose a location to work with and tap it to activate for measurement and navigation. The active location is checked.
Tap the Info button to review information about the location.
Using the Measurement Mode¶
Once the map archive is loaded, you can run the Measurement mode - simply tap the Measurement mode button in the main menu.
In the Measurement mode you can measure radiomap of your target location as well as add beacons. To active the measurement tools, select type of the object that you need to measure:
For detailed information on radiomap measurement, refer to the Measuring Radiomap.
Using the Navigation Mode¶
Once the map archive is loaded, you can run the Navigation mode - simply tap the Navigation mode button in the main menu.
The navigation mode provides the following control functions:
- Beacon Counter - shows the amount of beacons that are currently visible for the device
- Zoom + - enables you to zoom the map in
- Zoom - - enables you to zoom the map out
- Lock - locks the map in the centred position, so that you can zoom it but cannot change map's position
- Scroll - enables scrolling the map, so that you can zoom in and take a closer look at some specific part of the map
Use this mode to control data and check application working capacity.
Configure the Navigine Demo Application settings using the Settings button in the application's main screen. You can also use the Settings menu to enable some debug features like saving logs, changing power modes, and so on.
The following options are available:
Background navigation mode Toggle switch - enable collecting coordinates while the application is minimized
Power saving modes (available with Background navigation mode ON):
- NORM radio button - enables normal mode when the device modules (e.g. Wi-Fi, Bluetooth) scan for available signals continuously. Battery usage is high, while the navigation is more accurate compared to ECO modes.
- ECO-1 radio button - enables economic mode, when only Bluetooth and sensor modules (accelerometer) are used for navigation. In this mode the applications scans the available modules periodically, while Wi-Fi and GPS modules are not scanned at all. Navigation accuracy in ECO-1 mode might be worse than in NORM mode, while battery usage is 4-5 times less.
- ECO-2 radio button - enables super economic mode, when only Bluetooth module is used for navigation, and delays between scanning are even bigger than in ECO-1 mode. In ECO-2 mode, navigation accuracy might be worse than in NORM and ECO-1 modes, while battery consumption is 10-15 less than in NORM mode.
Notifications enabled - enable/disable PUSH notifications
Save navigation log - if on, a log file with all sensors' measurements will be created after the next Navigation mode use. You can send this log file accompanied by the true traversed path to the Navigine support to resolve any possible issues with positioning accuracy. Default path to the file is: /android/data/com.navigine.navigine/<location_name>
Save navigation track - if on, a log file with all measured coordinates (path) will be created after the next Navigation mode use. Default path to the file is: /android/data/com.navigine.navigine/<location_name>
Send statistics to the server - if on, the application will send positioning results to the Navigine server. In this case you can view positions of the device in real time in the Analytics tab of the Navigine CMS. You can view the history of device's movement in the Heatmap mode of the Analytics tab.
Send crashes to the server - if on, the application will send the errors to the Navigine server.
Debug mode enabled - if on, the Debug mode appears in the Main menu.
Navigation file enabled - view path from the log file created via Save navigation log feature.