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 finger printing 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 downlaod 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 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 bellowbelow:
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 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.
...
You will need one location pr 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:
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. How this is done is described here. MazeMap suggest 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 listed available here. It is recommended that you go be in the middle of a corridor or room instead of going 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.
- Go here to get an overview of of the application you have created.
- If there are no applications created, you need to do this by clicking +Create new application in the upper right corner.
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
. Byby clicking on the Add new Api key button on the right side of the screen.
Copy the API key ID and the API key secret. Send the following information to support@mazemap.com.Info title 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==
...
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 at the left hand side.
...
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.
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
If 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 /wiki/spaces/DPD/pages/7864425. 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.
| Info | ||
|---|---|---|
| ||
Note: The following are useful IndoorAtlas reference materials when you are already debugging/testing/troubleshooting your IA set up.TraceID IndoorAtlas - Troubleshooting Positioning by getting the TraceID Ground Truth IndoorAtlas - Troubleshooting Positioning by using Ground Truth |