IndoorAtlas is a technology that uses magnetic fields that are in all buildings and rooms. This has proven to be a high quality technology used for positioning especially since it is possible to combine the technology with other positioning mechanisms. In order for IndoorAtlas to work on iOS devices you need to use it together with either CMX (or similar) or beacons. This is so that the iOS device will be able to distinguish which floor the user is located on. 

To set up positioning with IndoorAtlas you need to follow the steps below:

Step 1: Create IndoorAtlas Account

Create an IndoorAtlas Account. This can be done here https://app.indooratlas.com/signup. 

Step 2: Set up Maps in IndoorAtlas admin system

The process of setting up Maps are described by IndoorAtlas. Follow the instructions to set up the maps correctly. In order for it to work properly you need to use images that are exported from MazeMap. This is done using the functionality Export images in the MazeMap Map Editor. 

When adding a floor plan, in the second screen, click align using image coordinates (see image 1). The corner coordinates can be obtained from the .csv file you get with the exported images (see screenshot below).

You will need one location per building, and one application for MazeMap positioning. 

It is important that when setting up the floors that the floor number in IndoorAtlas is the same as the z-level for the floor in MazeMap. This is set by clicking on My location  in the main menu and choosing the building. For each floor click on the three dots to get a menu as shown bellow.

In this menu click on Edit floor plan info and image. You then get to the screen bellow:

The Floor number must be the same as the z-level in MazeMap. There are two ways to check your floor's z level in MazeMap. 

First, is to go your campus in use.mazemap.com, click on the building and look at the url. The url will look similar to this:

https://use.mazemap.com/#v=1&zlevel=4&center=10.407436,63.432811&zoom=18.5&campusid=47&sharepoitype=poi&sharepoi=486921

In the url you will find the zlevel as marked above. 

Or second, you can go to the Buildings menu, choose your building from the list in the side bar and you will be directed to this view:

Where the upper number on the left side refers to the floor name showing in the map (eg. "K2") and the value below is the z level (eg. "-2").

Remember:  MazeMap never assigns 0 as Z level value to any floors of the building.  All floors on top of the ground are assigned positive (integer) numbers and all floors below the ground are assigned negative (integer) numbers, as shown in the screenshots above.

If you need any help do contact the customer success team at support@mazemap.com. 

Step 3: Fingerprint onsite

IndoorAtlas has a process called Fingerprinting to gather signal data in the buildings. We recommend that you read through documentation of  how to achieve good fingerprinting coverage and recording paths.  We suggests that you use different devices to do the fingerprinting to achieve the best result, you are recommended to do the fingerprinting 2-3 times (or until the visualized path turns green) in order to record the best result. Make sure that you will publish/generate your maps after you have finished fingerprinting. 

          IndoorAtlas: Publish your Map for Positioning (Generate Maps)

A list of the best devices for the fingerprinting is available here. It is recommended that you be in the middle of a corridor or room instead of being close to a wall when collecting fingerprints. Please also note the Android 9 Wi-Fi Fingerprinting Limitations.

Step 4: Create API Keys

In order for MazeMap to set up the positioning on our side we need a set of API Keys from IndoorAtlas.

1. Go here to get an overview of the application you have created.
2. If there are no applications created, you need to do this by clicking +Create new application in the upper right corner.
    
   
   

3. When you have created the applications you need you can click on the name of the application. You will then get the possibility to create API keys by clicking on the Add new Api key button on the right side of the screen. 
      

   When creating API Keys...

   Make sure that you set the settings of the API Key to enable it to "Store location permanently" because this will help your team and the IA and MazeMap support teams during the testing

     

Step 5 Test position in IndoorAtlas' own apps ("MapCreator2" for Android or "IndoorAtlas Positioning" for IOS)

To be sure that everything is set up correctly and that the mapping and positioning is working as expected, check the position you get by using the MapCreator2 or IndoorAtlas Positioning app from Indoor Atlas. You will then see how the position from IndoorAtlas works isolated. 

           IndoorAtlas : Troubleshooting Positioning - Overview

           IndoorAtlas: Diagnostic Mode - Troubleshooting using Ground Truth

When this is working as expected, you are ready to test it in the MazeMap app.

Step 6 Send credentials to MazeMap:

MazeMap needs to do some configuration at our end. Please gather the information listed bellow and send it to support@mazemap.com with the topic IndoorAtlas set up for <campus name>  

• The API key id and API key secret from the step above, for example: 
  API key id: 3d7259fa-0f5f-4af1-bf5d-56aeb8c1205f
  API key secret: M1ejvibhNCzey2mq0pXNVMQRJS7SW0DVieqJHKlrs95jKdbbWXu3m2WOL9DJlK9m/DQiclez6P3D+EUAidGQy6lMMSRXp8U+HldgwUhokNCX7ogkaFKBhrOFCbzzCw==

Note:  IndoorAtlas data are automatically sent to MazeMap upon registration of the API key ID and API key Secret in the Map Editor Tool.  

Step 6: Set up LIPI Server

Only in case you are using IndoorAtlas in combination with Cisco CMX, then you also need to set up a LIPI Server. This is explained in the tutorial  LIPI for CMX Installation Guide.

Step 7: Testing in MazeMap app

We would like to refer you to the debug mode in the MazeMap app. This mode will be very helpful while testing.