IndoorAtlas is a technology that uses the 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. MazeMap customers often will benefit if they use IndoorAtlas in combination with Cisco CMX based positioning. Our experience is that IndoorAtlas will provide a more exact positioning than CMX but requires more work with Fingerprinting and the end user also needs to download an app to use the technology. When we combine the two solutions it is possible for a visitor to use only CMX while e.g. employees or students at a university can download an app in order to get better positioning. IndoorAtlas will also use the floor mapping from CMX in order to locate the correct floor a 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 in 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. 

Step 3: Fingerprint onsite

IndoorAtlas has a process called Fingerprinting to gather signal data in the buildings. How this is done is described here. MazeMap suggests that you use different devices to do the fingerprinting to achieve the best result. A list of the best devices for the fingerprinting is listed 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.   

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. 
   
   
   
4. Copy the API key ID and the API key secret. Send the following information to support@mazemap.com.
   For example:
   API key id: 3d7259fa-0f5f-4af1-bf5d-56aeb8c1205f
   API key secret: 
   M1ejvibhNCzey2mq0pXNVMQRJS7SW0DVieqJHKlrs95jKdbbWXu3m2WOL9DJlK9m/DQiclez6P3D+EUAidGQy6lMMSRXp8U+HldgwUhokNCX7ogkaFKBhrOFCbzzCw==  

Step 5 Other credentials for MazeMap:

In addition to the API keys MazeMap needs the floor plan IDs and location IDs. You can find this information by clicking on My locations in the menu on the left hand side. 

1. Select a location. 
2. The floor plan IDs are located in the main screen.
   
   
   
3. The location ID is located at the right hand side of the screen. 
   
   
   
   
4. The "floor" category refers to the Z-level in MazeMap.
5. Send the following information to support@mazemap.com :  
   
   

Mapping between z-level in MazeMap and floor level in CMX

MazeMap also needs a mapping between z-level in MazeMap and the CMX floor name for all floors in all buildings. 

Step 6: Set up LIPI Server

If you are using IndoorAtlas in combination with Cisco CMX you need to set up a LIPI Server. This is explained in the tutorial /wiki/spaces/DPD/pages/7864425.