Basic SDK use

Our SDK connects with the our location service and provides regular indoor location updates to the application. The application software needs only to implement an event listener method to receive those updates, from there on it’s up to your application’s business logic and how you wish to use this information in your application. To try it out simply use the original image file in your application.

Can I use IndoorAtlas mobile app without Internet connection?

IndoorAtlas service is implemented as a cloud service and the API is communicating constantly with the cloud servers through the Internet connection. This means that you cannot run your app or use IndoorAtlas app without Internet connection. Newest SDK can handle a situation when the network breaks for a while, but the accuracy decreases the longer you stay offline.

Can I use IndoorAtlas outdoors?

Yes, IndoorAtlas can map any place outdoors with steel structures for reference such as sports stadiums, and the area immediately surrounding your building. However, IndoorAtlas becomes less accurate when in open areas without enough steel structures.

Can I use different devices to collect the map data for a venue?

Yes. You can use multiple devices for collecting data by logging into the same account with multiple devices. This enables you to collect the map data as a team effort. Please remember to upload the data with each device one by one after collecting the paths so you’ll be able to see it with any device logged into that same account.

Can I use different handsets for mapping and positioning?

Yes. Based on device validation results in our laboratory we recommend use of Android OS version 5.0 or later for initial mapping to prepare a venue for positioning. Best devices at this time are Nexus 5, Nexus 5X, Nexus 6, Nexus 6P, Honor 8, LG G4 & G5, Xiaomi Mi4, OnePlus 2 and OnePlus 3. Positioning on a map produced on one or more of these devices is possible on any device that includes accelerometer, gyro and compass – accuracy might vary depending on the quality of the device’s sensors.

Can IndoorAtlas automatically select a floorplan for me in a multi-story building?

Yes. Our newest SDK 2.x introduces the automated floorplan detection feature for Android.

Can IndoorAtlas’ solution use Wi-Fi signals for positioning?

IndoorAtlas location technology uses a patented sensor fusion algorithm combining every source of position-related data with a basis in magnetic field sensing for universal, accurate positioning. Wi-Fi and other radio signals are used for rough position sensing as well when platform limitations allow that. We recommend use of supported Android devices for initial mapping to prepare a venue for positioning based on device validation results in our laboratory.

Does IndoorAtlas have commercial plans?

Our pricing can be found from
You are free to test out our solution and pricing starts only when your application has got enough active end users.

How a retail store should be mapped?

Each store has it’s own layout characteristics so it is difficult to give a general answer. Typically a good approach is to map first the main aisles and the perimeter (aisles) of the store. It’s then easier to connect the short aisle segments one-by-one to these main segments.

Please see our mapping guides to get the best out of the blue dot.

How accurately I need to align a floor plan with geo-coordinates in the map tool?

You should align the floor plan as accurately as possible. This will ensure the best possible experience for you. If there is a large deviation in the alignment, the positioning will fail.

How could I closely collaborate with IndoorAtlas?

We try our best to welcome any collaboration requests, but due to limited bandwidth, we may not be able to support your request currently. Until then, please check out our free developer tools offered on our site.

How does the automatic floorplan detection work?

Please take a look at our blog post regarding automatic indoor positioning.

How long the map generation takes?

The map generation time depends on the size of the map. The generation may take only a few minutes or it might take few hours in case the map has hundreds of paths. If you don’t want to wait for map generation to finish, you can close the IndoorAtlas Mobile app – the map generation continues on the cloud service. Once the map has been generated, you can start navigating. If the dot doesn’t appear automatically on your floorplan when you open it on MapCreator, the generation might not be ready yet.

How to get started with the blue dot?

Please take a look at our mapping guides to get started.

Is IndoorAtlas technology patented?

IndoorAtlas technology is patented. We have globally more than 30 patents pending, and several essential patents granted.

Is IndoorAtlas working in all buildings?

The IndoorAtlas’ technology uses magnetic field variations for positioning. These variations are most typically observed in buildings with steel frame construction, which makes most modern buildings as good application environments. Buildings with wood frame construction can be challenging environments unless there are some steel structures or objects causing magnetic anomalies. Please try out IndoorAtlas and let us know how it did work for you.

Is IndoorAtlas working in multi-floor buildings?

IndoorAtlas’ location technology can be used in multi-floor buildings as the magnetic fields are different in each floor. Our newest SDK 2.0 introduces automated venue and floorplan detection feature for Android.

Is IndoorAtlas working in underground environments?

IndoorAtlas may work in an underground environment if the environment contains enough magnetic information. We have successfully tested the IndoorAtlas’ technology in underground mining tunnels (1400 m below the surface), where the metal ore is contributing to the magnetic anomalies.

Is there a difference in the position accuracy depending on which floor you’re at?

Each floor has an unique magnetic fingerprint so it shouldn’t affect whether you’re underground or on the top floor (blue dot has been tested 1400m below the surface). If you’re using Android device (which we recommend) for fingerprinting the floors it uses magnetic and WiFi-mapping combined to create the most accurate results. Underground the magnetic field might be stronger due heavy metal structures, which would make it optimal place for magnetic positioning. On the top floors where there are more lighter structures (windows and such) usually WiFi-scanning helps to create the most accurate map.

May I need to re-map a venue once it has been mapped?

If the venue goes through a major structural change, e.g., steel structures are being modified or large steel objects like shelves are being relocated, you may need to re-map the areas that have gone through modifications.

My sign in/up fails, why?

Please try resetting your password. If the issue still exists please contact our support.

Positioning doesn't work, why?

If the positioning doesn’t work, you may want to check that:

  • The device is supported by IndoorAtlas
  • You have a working Internet connection
  • The floor plan image has been aligned correctly to geo-coordinates. The positioning will fail if the floor plan image is randomly placed over the world map in an arbitrary scale, for example
  • The floor plan image is correctly proportioned
  • You keep the device approximately in the portrait orientation, pointing to the walking direction
  • Ensure the map data has been collected for all areas where you are using the positioning

If you still face problems you can contact IndoorAtlas at or by logging in at and starting a conversation from the bottom right corner’s question mark – A good problem description would include:

  • Accurate description of the problem
  • Used devices on mapping and in testing, OS versions and used networks
  • Which map was tested – Floorplan ID from the world map tool identifies the map
What are the known issues?

There are some known issues with the current version of IndoorAtlas. We are working on to fix these issues:

  • The Map tool may fail with some file formats. We recommend to use .PNG files for now.
  • Samsung smartphones have sensor filtering that may impact mapping quality
What are the supported devices?

Minimum requirements for a mapping tool with MapCreator 2 is to have Android OS version 5.0 or later and three sensors: accelerometer, magnetometer and gyroscope. Almost all modern high end smartphones have these sensors. Mapping with an Android device will also enable the magnetic map for iOS applications.

What image file formats the map tool support?

We recommend to use .PNG or .JPG files for now. There may be some problems with other bitmap formats.

What is a good IndoorAtlas workflow?

Please check our How to get started guide.

What is the positioning accuracy of IndoorAtlas?

The accuracy depends on the building’s magnetic field information and how much effort you put to the fingerprinting phase. Usually you can get 1-2 meter accuracy.

Where can I find the floorplan ID?

Sign into your IndoorAtlas account at, open your location and you will see the floorplanID of each floor.

Where do I get the floorplans?

There are several sources for indoor floorplans, such as the building’s manager, info services, or in some cases public databases. Your best source will vary depending on country, venue type and application use case. For example, if you’re mapping a mall you might find the floorplans from the mall’s website etc.

Why I cannot see the details of my building in the satellite view of the map tool?

In some geographic areas the quality of satellite images can be low and it’s not possible to see buildings with enough details to align floor plan images. Please, try to change the map view from the bottom right of the Map tool on our web-site to find the best map view with enough details. The current options are: Mapbox Street/Satellite, and HERE Street/Satellite. Mapbox Street view often shows the detailed outlines of buildings without satellite images.

You can also use geo-coordinates to place your floorplan image – you can add lock points to your floorplan image and add the corresponding geo-coordinates from the “Exact coordinates” menu.

Why I have to walk in order to get the location fix?

IndoorAtlas technology is using the history of magnetic field observations for computing the precise location. This means that the device needs to move some distance in order to collect enough data to converge to a correct location estimate, i.e., to have a location fix. We are constantly improving our service to decrease the time needed for the first location fix.

Why I need to calibrate my phone when I’m using the IndoorAtlas mobile app and the API?

Calibration prior collecting map data is very important as it ensures the high quality of your maps. All the calibration data we receive from users helps us to improve our service. For positioning use, SDK version 1.4 and above implement automatic calibration requiring no specific action from the application developer and only minimal, natural hand movement from the end user.

Why the distance displayed for a map segment seems to be wrong?

This a symptom caused by an error in the alignment of the floor plan image with the geo-coordinates. Ensure you have aligned your floor plan image accurately with the geo-coordinates.

Your question not answered here?

We are here to help you in any way possible. Please drop us an email.