After the fingerprinting process you can test the indoor location capabilities of Accuware Indoors on an Android or iOS device with the Accuware Indoors App installed.

Provide indoor navigation to an Android device

This demo is intended to show how to test the indoor navigation capabilities on an Android device with the Accuware Indoors App set in NAVIGATION mode.

PLEASE READ: if you are doing your tests using the same device used for the fingerprinting process, then the prerequisites below are already met and you can start reading from Step 6 of the Instructions.

Prerequisites

  • an Android device with with at least Android 4.3.
  • a set of Accuware credentials.
  • a  valid Internet connection (Wi-Fi or cellular data) to download the floor plan and the database of fingerprints from the Accuware server. If you are using a Wi-Fi Internet connection these are the requirements that MUST be met:
    • Accessible domains:
      • s3.amazonaws.com – this is the address where the device downloads the floor plan(s) of the area
      • its.accuware.com – this is the address where the device downloads the database of fingerprints
    • Ports (opened outbound): 53/tcp (DNS), 80/tcp (HTTP) and 443/tcp (HTTPS)

Instructions

  1. Turn On the Wi-Fi and/or Bluetooth on the device depending on the radio signals available/installed in your environment. When using the Bluetooth please disassociate the Bluetooth from any other Bluetooth device in the environment (e.g. headsets, speakers etc..)
  2. Setup Accuware Indoors by following step by step all the documents under the Setup of the table of contents on the left.
  3. Install the Accuware Indoors App on your Android device:
    • Tap the Google Play Store button on your device  (or click this link from the device).
    • Tap the Search icon from the upper portion of the screen.
    • Type Accuware Indoors, and tap on search.
    • Tap on the Accuware Indoors app and tap on INSTALL. Please update the Google Play services if it will be asked to do so.
    • Accept the requirements.
    • Wait for the app to be downloaded and installed.
  4. Once the Accuware Indoors app is installed and active, the Map view will appear on the screen of your device (you are now in the Positioning mode):
    • Press the Settings icon on the upper right side.
    • Inside the INDOORS ACCOUNT section, enter:
      • your username (as provided in the Accuware Activation email).
      • your password
  5. Inside the SITE AND LEVELS section, enter your Site ID (as provided in the Accuware Activation email) and the Level IDs according to the levels created inside the Accuware dashboard. If you have multiple levels, separate them with a space character. Do not enter levels that do not contain a floor plan OR levels that do not exist, otherwise you will receive the error: Floor plan fetch completed, no floor plan retrieved.
  6. Press the Back arrow on the upper left side and the floor plans will be fetched (according to the levels chosen inside the settings of the App).
  7. Press again on the Settings button and verify these things:
    • Indoors Mode: NAVIGATION
    • Beacon Mode: the choice for this option depends on the type of radio signals collected during the fingerprinting phase. In case of doubts please check the type of fingerprints inside the Accuware dashboard. The radio signals related to iBeacons are identified by a MAC address that starts with the letter “I” while the radio signals related to Wi-Fi APs starts with any letter other than “I”.
    • Automatic Level Selection: ✓
    • Animated Position Update: ✓
    • Disassociate Wi-Fi:  ✓
    • Use Legacy filter Mechanism:
      • if the fingerprints are related to iBeacons: leave this option OFF.
      • if the fingerprints are related to iBeacons AND Wi-Fi APs: leave this option OFF.
      • if the fingerprints are related to Wi-Fi APs: leave this option ON.
  8. Exit from the settings by pressing the arrow button in the top left corner.
  9. If you have more than one level inside the Settings, then you can switch between your levels by pressing the Levels icon on the upper bar.
  10. To start the Indoors engine click on the cross-hair icon on the left side of the upper bar.
  11. Over the floor plan there is now a BLUE dot which represents the real-time location of your device! At the beginning of the navigation session the position estimated is not always super accurate. The accuracy improves as soon as you start walking (4-5 steps) in any direction.
  12. Start walking.
  13. To stop the Indoors engine click again on the cross-hair icon.

Very important info about the Legacy Filter: the legacy filter mechanism will make use  of the built-in sensors of your device (accelerometer, gyroscope, compass). Be aware of these things when the Use Legacy filter Mechanism is ON:

  • the device MUST be kept perpendicular to your body in front of you (like in the video below). This is mandatory because the Legacy filter makes use of the smartphone sensors.
  • if the gyroscope and/or the compass is missing then the navigation results could be compromised. In this case we suggest to use another device or to test the Indoor engine in Tracking mode. Please check the sensors available on your device:
  • if, during your tests, the estimated location does not follow your walking direction, then means that the compass is not calibrated. It can be calibrated following the info inside this support page.
  • ​the estimated location is updated at each step.
  • the estimated location can be outside the fingerprinted area.
  • the estimated location won’t be updated when you are not moving.

Troubleshooting: if you encounter any issue related to the Accuware Indoors App or to the accuracy, please look at this page where you can find all the help you need.

Run time information

Anytime, by tapping on the top blue bar with the icons you can enable or disable the debug panel. This additional panel is very useful to visualize in real-time several statistics regarding the radio signals detected. By tapping on the debug panel you can see the following information:

  • First line: #of location updates, level ID, latitude, longitude, precision
  • Second line:
    • (W)ifi: #of Wi-Fi scans| # of access points in last scan | avg. duration of a scan in ms
    • (i)Beacon: #of iBeacon scans| # of iBeacons in last scan | avg. duration of a scan in ms
    • (U)pdates: # location updates| # of fails | avg. location update period in ms
    • (C)amera: # of images scans| # of images in the last scan | avg. duration of a scan in ms

Provide indoor navigation to an Apple device

This demo is intended to show how to test the indoor navigation capabilities on an Apple device with the Accuware Indoors App set in NAVIGATION mode.

PLEASE READ: if you are doing your tests using the same device used for the fingerprinting process, then the prerequisites below are already met and you can start reading from Step 7 of the Instructions.

Prerequisites

  • an Apple device with at least iOS 7.
  • a set of Accuware credentials.
  • a  valid Internet connection (Wi-Fi or cellular data) to download the floor plan and the database of fingerprints from the Accuware server. If you are using a Wi-Fi Internet connection these are the requirements that MUST be met:
    • Accessible domains:
      • s3.amazonaws.com – this is the address where the device downloads the floor plan(s) of the area
      • its.accuware.com – this is the address where the device downloads the database of fingerprints
    • Ports (opened outbound): 53/tcp (DNS), 80/tcp (HTTP) and 443/tcp (HTTPS)

Instructions

  1. Turn On the Bluetooth on the device depending on the radio signals available/installed in your environment.  Please disassociate the Bluetooth from any other Bluetooth device in the environment (e.g. headsets, speakers etc..)
  2. Setup Accuware Indoors by following step by step all the documents under the Setup of the table of contents on the left.
  3. Install the Accuware Indoors App on your Apple device:
    • Tap the App Store button on your device (or click this link from the device).
    • Tap the Search button from the bottom portion of the screen.
    • Type Accuware Indoors, and tap on search.
    • Tap on the Accuware Indoors App and tap on INSTALL.
    • Type your Apple ID and password.
    • Wait for the app to load and install.
  4. Once the Accuware Indoors app is installed and active, the Map view will appear on the screen of your device (you are now in the View mode):
    • Press the Settings button on the upper left side.
    • Inside the ACCUWARE ACCOUNT section, enter:
      • your username (as provided in the Accuware Activation email).
      • your password.
  5. Inside the SITE AND LEVELS section, enter your Site ID (as provided in the Accuware Activation email) and the Level IDs according to the levels created inside the Accuware dashboard. If you have multiple levels, separate them with a space character. Do not enter levels that do not contain a floor plan OR levels that do not exist, otherwise you will receive the error: Floor plan fetch completed, no floor plan retrieved.
  6. Press the Done on the upper left side and the floor plans will be fetched (according to the levels chosen inside the settings of the App).
  7. You will be asked if the Accuware application can use information about your current location. Tap YES.
  8. Press again on the Settings button and verify these things:
    • INDOORS MODE: NAVIGATION
    • BEACON MODE: iBeacons.
    • IBEACON CONFIGURATION: enable the switch related to one or more iBeacons vendors or enter the UUIDs of the vendor of the iBeacons used in your installation.
    • Automatic Level Selection: ✓
    • Animated Position Update: ✓
  9. Exit from the settings by pressing the Done button in the top left corner.
  10. If you have more than one level inside the Settings, then you can switch between your levels by pressing the Levels icon on the right side of the bottom bar.
  11. To start the Indoors engine, click on the cross-hair icon on the left side of the bottom bar.
  12. Over the floor plan there is now a BLUE dot which represents the real-time location of your device! At the beginning of the navigation session the position estimated is not always super accurate. The accuracy improves as soon as you start walking (4-5 steps) in any direction.
  13. Start walking.
  14. To stop the Indoors engine click again on the Cross-hair icon.

Very important info about the Legacy Filter: the legacy filter mechanism will make use  of the built-in sensors of your device (accelerometer, gyroscope, compass). Be aware of these things when the Use Legacy filter Mechanism is ON:

  • the device MUST be kept perpendicular to your body in front of you (like in the video below). This is mandatory because the Legacy filter makes use of the smartphone sensors.
  • if the gyroscope and/or the compass is missing then the navigation results could be compromised. In this case we suggest to use another device or to test the Indoor engine in Tracking mode. \
  • if, during your tests, the estimated location does not follow your walking direction, then means that the compass is not calibrated. It can be calibrated following the info inside this support page.
  • ​the estimated location is updated at each step.
  • the estimated location can be outside the fingerprinted area.
  • the estimated location won’t be updated when you are not moving.

Troubleshooting: if you encounter any issue related to the Accuware Indoors App or to the accuracy, please look at this page where you can find all the help you need.

Run time information

Anytime, by long pressing on the floor plan area for more than 5 seconds, you can enable or disable the debug panel. This additional panel is very useful to visualize in real-time several statistics regarding the radio signals detected. The debug panel provides these information:

  • First line: #of location updates, level ID, latitude, longitude, precision
  • Second line:
    • (i)Beacon: # of iBeacon scans | # of iBeacons in last scan | Average duration [ms] an iBeacon scan takes
    • (C)amera: # of images scans| # of  failed camera updates during this session| # of images in the last scan | Average duration [ms] a camera scan takes
    • (L)ocation updates: # of location updates during this session | # of failed location updates during this session | Average period [ms] of location updates