gpkg-arna

Augmented Reality Navigation Assistance Using GeoPackage

This was our very first Android application ever. The code is still a bit messy, and there is some functionality that we started that has not yet been completed.

In our app, the route is displayed as a line between the current position and the next waypoint on the route (or the next vertex on the linestring). The nearest CNPs to the next waypoint is displayed as a black and white marker, and any related photo for that CNP is automatically displayed on the screen. POI features are indicated with a pink marker. If a POI feature has a name attribute, that name will be displayed under the marker.

Hopefully everything works as expected, and we hope you enjoy using our app!

Please email me at kbentley@cognitics.net if you have any questions or comments.

How to Use

• You can change some settings by clicking on the wrench in the bottom left of the screen.
• The heading on the top center of the screen represents the direction the phone is currently oriented towards (as you look through the camera)
• When you begin a route, the distance to the next waypoint is shown under the heading indicator.
• Select a GeoPackage file and route from the "SELECT ROUTE" button on the top right of the screen
• The white line from the bottom middle of the screen points you to the next waypoint in the route line
• The white/black marker identifies the next Critical Navigation Point (CNP) in the route. The CNP closest to the waypoint in the route will be displayed
• If there is an related image for the CNP in the GeoPackage, using the Related Tables Extension (RTE), it will appear in the bottom right of the screen
• You can add a new image and RTE relationship to the current CNP by clicking on the black/white CNP marker. You can use the camera to take a picture, or you can select a file from the phone's gallery.
• The 'pause' button near the bottom middle of the screen will switch to manual navigation mode. In this mode, you select the next waypoint with the forward button and the previous waypoint is selected with the rewind button.
  • When in auto-route mode and "Always Start Routing on the First CNP" is not selected, the nearest waypoint to the current position is set automatically, skipping any intermediate waypoints. In the Tampa example database, the start and endpoint are very close to each other, so this may result in the endpoint being selected immediately.
• Pressing the 'play' button while in manual navigation mode will switch back to automatic navigation mode.
• In automatic navigation mode, the route line will point to the next waypoint on the route. If you wander too far from the route, the line will point towards the nearest heading to intercept and return to the route. The distance you must be to be considered off route is 50 meters by default, and is configurable in the settings dialog.
• In automatic mode, once you are a certain distance from the next waypoint (25 meters by default, configurable through the settings screen), the waypoint will automatically be advanced to the next on the route.
• The pink markers are Points of Interest (POIs) for the selected route
• In the settings dialog there is a configurable Sensor Smoothing value. A higher number will result in less smoothing, but will result in more jerky/noisy indicators. A lower value will add some lag to the heading indicator (and also the position of the markers on-screen). A

Known Issues

• Group Overlapping CNP Markers has not been implemented yet, so if there are many markers in the same part of the screen, the text may overlap.
• AOI features have not been implemented

Building

See the INSTALL.md file.

Third party libraries are configured to be used automatically in the gradle script.

Third party scripts used include:

• com.github.angads25:filepicker
• com.github.karanchuri:PermissionManager
• mil.nga.geopackage:geopackage-android

DEADLINE: APRIL 15TH

Requirements for the app:

• Software builds and installs according to supplied instructions ¹
• Route highlighted as overlay on live device camera image ¹
• Markers displayed for Critical Navigation Points (CNPs) ¹
• Accurate location of live AR navigation aids ¹
• Photos stored in Related Tables Extension media table displayed at CNPs
• User able to select from pre-defined routes available in the GeoPackage
• Distance-to-CNP and other navigation hints (visual and/or audible)
• Look-ahead option (see next CNP and the one after that)
• Use POIs to highlight landmarks for route confidence/verification
• Cross-platform operation, e.g. browser-based solution
• Utilize proposed RTE “features” relation type linking routes and their CNPs & POIs
• Additional functionality & UI/UX features addressing ease of use in high-stress scenarios.

¹Top priority functionality required for prize award)

Mockup of main screen

Mockup of settings screen