AR Visualisation tool

for transportation problems in the HSL public transport region

This repository contains:

• An Android application for displaying realtime public transport data
  • High-frequency positioning of vehicles via MQTT API Terms of use
  • HSL alerts via Apollo GraphQL Client
  • Traffic data from Here Maps API (you need to provide your own API key for this functionality)
  • AR map for displaying public transport vehicle positions and alerts from HERE maps
  • Data visualization

To run the Android app via Android Studio

1. Open NokiaHslVisualisation directory in Android Studio
2. Add here maps APIkey to local.properties
   • row should look like: HERE_MAPS_API_KEY="<API KEY>"
3. Preferably use your device's mobile data. Some network firewalls block MQTT traffic.

Install from APK

1. To get the apk, use the releases tab in this repository.

Install from Google Play

1. To install from Google Play you need to be part of the Mobile Project course of Metropolia. All those who are in the course can access the application installation via Google Play from here. When you click the link it might tell you that "The application is not in use on this account." Then simply change your user to your Metropolia account and you will get access to the installation.

Instructions

There are 5 tabs to navigate to:

• Home: here you can find the HSL public transport alerts and browse them
• AR map: this is the place where you can access the AR map. Simply find a place for the map by moving your phone on a surface, when dots appear, tap your screen and the map will manifest itself onto the screen. You can filter the view by swiping from left to right. That brings out the filtering menu. You can hide it by swiping it back from right to left.
• Alerts: this is the place where you can find the alerts from HERE Maps API. First you need to input your private API key.
• AR view: this is the view that tells you where the vehicles are in the real world. It locates your position and creates a bounding box and then shows you all the vehicles as 3D objects on your screen.
• Analytics: this view shows you information of all the buses arriving at bus stops in greater Helsinki area

Used libraries:

• Jetpack Navigation 2.3.3 License
• Room DB 2.2.6 License
• Lifecycle 2.3.0 License
• Coroutines 1.4.2 License
• AR Core 1.23.0 License
• Sceneform 1.17.1 License
• OsmDroid 6.1.6 License
• Retrofit 2.9.0 License
• Jacoco 0.8.5 License
• Apollo Graphql Client 2.5.5 License
• Paho Mqtt Client 1.1.0 License
• Glide 4.9.0 License
• Gson 2.8.6 License
• AAChartKit Github

Used APIs

• HSL Routing API
• HSL Realtime API
• HSL High Frequency Positioning API
• HERE Maps API

---

Demo video of the application in use

---

Link to tools and instructions no more in use