1 – Requirements to be met by a floor plan

Here you can find all the things that you need to know during the upload of a floor plan to the Accuware dashboard. The ideal floor plan is an accurate and detailed digital image that shows the correct position of doors, walls and hallways. It must also be correctly scaled, so that relative proportions of features are maintained when the floor plan image is stretched or shrunk.

Supported formats

The Accuware dashboard supports the upload of GIF, JPG and PNG floor plans with a maximum size of 1 MB each one. If you have a PDF floor plan, then you should convert it into an image file using Adobe Acrobat or using an online service like these.


The floor plans MUST be accurate and detailed, showing the correct position of doors, walls, hallways, atriums, etc.

Relative dimensions/proportions

Be careful when working on the proportions of the floor plan image during the creation of the floor plan image or during the upload to the Accuware dashboard). Altering the relative dimensions of the image (and thus of the elements inside the floor plan) can compromise the results. It is absolutely important to maintain a proportion between the dimensions of the elements inside the floor plan and the dimension of the same elements in the real life. The idea is simple: if a room has a square shape, it should not be stretched and become a rectangle.


Be careful when scaling the floor plan image. It is crucial that the floor plan is scaled correctly so that it matches (as much as possible) the physical dimension of the building. This can be checked using the ruler tool of the Accuware dashboard or using the ruler tool available inside Google Earth.

2 – Create the geo-reference using Google Earth

The process of creating the geo-reference requires the use of Google Earth, which is freely available here.

  • In Google Earth:
    • Open the menu Tools > Options
    • In the 3D View tab:
      • Set Show Lat/Long to Decimal Degrees.
      • Set Terrain > Elevation Exaggeration to 0.01
    • In the Navigation tab:
      • Select Do not automatically tilt while zooming.
    • Click on OK.

2.1 – Add an overlay image and export the KML file

  • Move the map to the area where your site is located
  • Make sure your Tilt & Compass are reset (View > Reset > Tilt and Compass)
  • Disable all the active Layers inside the Layers tab usually located in the bottom-left corner of Google Earth
  • Open the menu Add and select Image Overlay
  • A dialog box containing a field Link will appear
  • Click on  Browse button
  • Select an high quality floor plan image of your production/test environment from your computer and click on Open
  • Without closing the dialog box place your image on the map keeping in mind the important information reported in this page.
  • To position the image on the map you can take advantage of the following tools:
    • SHIFT button: the  proportions of the image uploaded are NOT kept by default. By pressing the SHIFT button the relative dimensions of the image are kept
    • Ruler tool (top bar): this tool allows you to measure distances on the map. We strongly encourage you to use the this tool to verify the correct scaling of the floor plan by checking if the dimensions of some elements of the floor plan matches the real physical dimensions of the same elements in your environment (w.g. doors, walls etc..)
    • Transparency bar: this tool (inside the dialog box) let you change the opacity of the floor plan in order to make the image fit the ​underlying building
    • Green elements on the map: these are the points that you have to drag and drop to scale, move and rotate the image
  • Once you are done, click on the OK button in dialog box
  • The image overlay just added will be listed in the Places pane, on the left of the screen
  • Right click on the overlay, and select the menu item Save Place As
  • In the Save File dialog box, select Save as type: KML file (DO NOT save it as a KMZ file)
  • Save the KML file in a location of your choice

Part of the image is cut: if the dimension of your floor plan exceeds the Max Texture Size parameter of Google Earth, part of the image will be cut. In this case you have to re-size your floor plan using a graphic editor. The allowed dimension of the floor plan image depends on your computer’s graphics capabilities. Switching graphics mode OpenGL / DirectX (Tools, Options, 3D View tab) may make a difference. To view your Max Texture Size:

  • click Help > About Google Earth on a PC
  • or Google Earth > About Google Earth on a Mac

2.2 – Import the KML and image files into the Accuware dashboard

Access the Accuware dashboard at this page, supply the credentials contained in the email from Accuware Activation email and press the Login to dashboard button.

Once authenticated you will be automatically re-directed to the Sites section of the General tab and the information of your first site will be displayed.

Multiple levels: use the logical mechanism of the Levels to split the floor plans based on:

  • their vertical positions (e.g. floor plans of different levels of the same store).
  • or their different locations (e.g. floor plans of different stores of the same shopping mall).

You can create more levels (and later, add one and only one floor plan to each level) by following these steps:

  1. Select General > Levels.
  2. Click on the Add Level button.
  3. Select the Level ID and assign a Name and a Description (optional).
  4. Click on Save.

Using the Accuware dashboard it is possible to create up to 30 Levels (in addition to the Level 0). Additional levels can be created using this PUT API call.

  1. Click on General > Floor Plans
  2. Click on the Import KML button
  3. Choose the Level ID in which you want to upload the floor plan
  4. (optional) Assign a name and a description to the floor plan
  5. Use the two buttons to select the KML file and the custom floor plan image (the KML file is the one that was saved using Google Earth. The image file is the same file chosen during the previous step when adding the image overlay in Google Earth)
  6. After you have selected both files, press the Upload Files button

You will receive 3 messages in sequence: Uploading, Processing and OK. At the end of the upload process, the page should display the floor plan just uploaded in the table above the map.

Touch screen laptops: on some combination of laptops equipped with a touch screen and browsers it is not possible to use the touch pad mouse/bluetooth mouse/USB mouse to scale/move/rotate the image. If you encounter issues we recommend to try a different browser.