In this guide, we provide tips on how to complete the first three steps of our workflow required before you can build location-based mobile app features. You can also check our video tutorials for the main steps to start mapping your location.
|1. Create Location & Add Floor Plan||2. Map Location||3. Manage Map Data|
Step 1 - Create Location (your venue) & Add Floor Plan
- On your desktop, sign-in or create an account at app.indooratlas.com
1.1. Create your location:
- In the ‘Locations’ tab, click on the top right button ‘+ Create Location’
- Enter the name of your venue. Be descriptive/accurate e.g. ABC Shopping Mall
- Add the address. Check the location is correct on the map. Drag the marker as needed
- Add a location description e.g. ABC Mall, Market Street
- Click ‘Next’
1.2 Add your floor plan:
- Name your floor plan. Be descriptive and accurate e.g. ABC Mall, 1st Floor
- Add the floor number (use the same numbering as the building’s elevator)
- Optional: Add altitude of the floor in meters
- Upload your floor plan image (PNG / JPEG format recommended)
- Click ‘Next’
- Align your floorplan image on top of your building as accurately as possible using the scaling and rotating icons in the corner of the image. To move the image, drag and drop using the middle icon. Scaling the image to the correct measurement is extremely important
- You can change to a different map view from the menu on the top right e.g. satellite view.
- Select your map provider from the menu (Google Maps not currently supported)
- Click ‘Submit’
In your ‘Location Overview’ tab, you will now see your location.
Important: If you need to add additional floor plans for your location, you do not need to add the location again. Just add a new floor plan for an existing location.
Step 2 - Map your location/venue
MapCreator 2 provides an improved way to map your chosen indoor location/venue for IndoorAtlas’ geomagnetic indoor positioning service. Your mapping goal is to cover all walkable areas of your location’s floor plan with blue paths (no more than 1.5 meters apart) shown in the diagram. To do this, you will need to follow the steps detail below in section 2.0 - 2.6 of this guide.
Preparation for Mapping
2.0. Download MapCreator 2
- Download IndoorAtlas Map Creator 2 for Android
- For production quality maps, we recommend using Nexus 5, Nexus 5X, Nexus 6, Nexus 6P, Honor 8, LG G4 & G5, Oppo R9M, Oppo R9TM, Oppo R9s, OnePlus 2 and OnePlus 3
- Requires WiFi, magnetometer (compass), accelerometer and gyroscope (hardware sensor, not a virtual gyroscope) sensors
- Samsung smartphones have sensor filtering that may impact mapping quality
2.1. Get started
- Login with you IndoorAtlas account
- Remove possible magnet phone cover from the device to avoid interference with the mapping data
- Carefully read the app tutorial
- Choose the correct location and floor plan from the list
- Enable WiFi and Bluetooth
2.2 Add your waypoints
- Add a waypoint by tapping the right side button (it will turn green) and then tapping the desired location on the map
- Move the waypoint to a precise point in the map by dragging it or by moving the map. Zoom in to do this accurately, within 10 centimeters if possible
- Waypoints should be located in places you can easily and precisely recognize in the floorplan, (e.g. a pillar or doorway)
- To remove a waypoint, press and hold the waypoint and select “remove”
- Set waypoints no more than 10-20 meters apart and strive to leave 0.5 - 1 meter distance to walls
- If you mapping a small area e.g. a 3m wide hallway, we recommend that you map 2-3 paths (every map path you create covers an area of 75 cm to each side) for ample coverage
- For best results you need at least two waypoints but we highly recommend 5 for a small test area
- You can move your waypoint by longpressing it.
- You can measure the distance between two waypoints in meters by tapping two waypoints one after another. This way you can also make sure your map is in correct scale (i.e. measure the width and length of a corridor and make sure it matches the distance on the MapCreator also)
2.3 Calibrate your phone
- Press the calibration button , leave the phone on a stable surface, table, floor etc. (holding it in your hand is not enough, it needs to be on a flat and steady surface) and press ‘Start calibration’ *Note: If the percentage stays in 0%, the device is either not stable enough or the gyroscope in your device is not a hardware sensor, please see requirements above
- Start magnetometer calibration, rotate the device around its axes until phone reaches 100%
2.4 Get the walk right before mapping
- Walk naturally in straight lines as much as possible, keeping the phone horizontal and heading forward
- Keep the phone close to your body, avoiding major arm movements (like waving)
- When you turn, the phone should turn with you
- If something blocks you, just stop and wait for the obstacle to move before proceeding. Don’t stop recording
- You can check-in at the same waypoint multiple times
- Cover the whole walkable floor plan area with no more than 1.5m gaps between paths
- Each map path recording time should be 4 minutes maximum
Important: the application has to be active while mapping or the mapping data will be lost (for example, if you answer a phone call). We recommend turning the phone to “do not distrub” mode to avoid problems vibration can create in the mapping data.
Choose your starting waypoint by tapping and place yourself in the center of the starting waypoint; zoom close enough to see the exact spot.
Start mapping by tapping on the starting waypoint and clicking the start button.
- Walk to the next waypoint and click on it as you’re approaching
- Note: when you start walking from the first point your route won’t be drawn in the map. Even though the dot doesn’t yet follow you, keep walking
- When you arrive at the second waypoint and your device is precisely in the centerpoint, check yourself into the waypoint by pressing the button in the middle. Map Creator 2.0 will show an estimation of your walked path
- Continue mapping by facing the next waypoint and repeating the steps above. The app will try to predict your next waypoint and marks it with the green circle. If the estimated waypoint is the correct one, check yourself in. If it’s incorrect, manually correct the waypoint and then check in
- Continue process until you’ve covered your area. Maximum time is 5 minutes per path.
2.6 Stop, Save & Generate Map
- When you’re done, press the red stop button and click Save. Alternatively, Discard if you are not happy
- By saving, you automatically start the import to our cloud if you have a network connection
- Add paths until you’ve filled all walkable areas, there shouldn’t be holes in the mapping data.
- After all the paths have been uploaded to the cloud, you can trigger map generation from the app’s location page, or you can go to app.indooratlas.com where you can also choose the paths you want to include in the generation.
Step 3 - Manage your map data
- Open your location and floorplan at app.indooratlas.com
- There, you can see your saved map paths and check coverage
- Use the ‘Waypoints’ tab to edit and delete waypoints
- To generate your map, go to ‘Map data’ section and select ‘+ Generate New Map’
- ‘Generate now’ will automatically include all your mapping paths in the generation
- ‘Choose paths for the map’ and select which ones you’d like to include in the map generation. You can enable/disable the paths
- After the map generation is finished, you can go to ‘Test’ mode and try how the positioning works by walking around in the mapped area