Step1: Create indoor map and path routing file by using JOSM

if you want to import the map from autocad/ai/visio please refer to PDF import into JOSM

The first step to create indoor locating environment is drawing indoor map. This article will tech you how to use JOSM to draw the map step by step. Due to internet requirement, please check your PC network connection.

Step 1

Download free software JOSM and install it . After install and open the software, you will be asked to update the plugin lists when first open. Please click yes to update.


If you want to change language, please click Edit and choose Preferences.


The program will reopen after change language.


Step 2

Install PicLayer & building_tools plugins.
Open Preference same as Step 1. Then switch to plugin tab and search "PicLayer" keywords. If found, check it.


Also search "buldings_tools", and check it.


Click OK, then program will ask you to restart, please click restart button and let plugin become effective.


Mapping indoor picture on world map. Go to Imagery -> click OpenStreetMap to open world map.


To control JOSM's map view you have two way:

  1. Hold down the right mouse button and move mouse can move the map view, and use mouse wheel to zoom in/out the map view.

  2. If you want to quickly jump to specify latitude and longitude, you can double click latitude/longitude panel left below, input the building latitude, longitude, and zoom level (we suggest set 30). (Here use Tempus Hotel-Dadun building for a example. If you don't know the building's latitude and longitude, you can use google map to inquiry location beforehand.)


Click Jump to , the world map can quickly show the location you just set.


And then go imagery -> click New picture layer from file.. to import indoor picture.


You may not see the imported picture in the beginning. Please choose the indoor picture layer on the right window and place the layer to the top. Then you can see the picture on the world map.



You can adjust the indoor picture by using move, zoom, and rotate function button to fit the world map on the location it belongs to.


You also can adjust alpha to make the outline more clear when you depict the map in the following next step.

Step 4

Add a new layer, begin to depict map from indoor picture.


The following describes the common function keys:


A. Select (Hot key S): this function can select one or more nodes. You can delete a selected node or a node set, or change shape of node set by hold down the left mouse button to move the selected nodes.

B. Draw nodes (Hot key A): create node or node set, press Esc can stop continuous drawing.

C. Create Circle (Hot key Shift + O): create a circle by converting a diameter from one line.

The following picture is a simple map depict example.


Step 5

After depict all region you need, you must define properties of the regions。The following shows kinds of tag usages:


icon_sails names


To add tag, please click Add button on the right side window, then input key & value.


The following show two tag define examples:

Ali Seafood


Emergency Door


The two major differences of these two examples are where "Ali Seafood" region need to show region label, and "Emergency Door" region doesn't need it. So show_label tag must add and set true for "Ali Seafood" region. On the other hand, "Emergency Door" region only show icon_sails icon, there is no need to show region outline, so show_region tag must add and set false for "Emergency Door". Also, icon_sails tag should be add for "Emergency Door" region to show exit icon in map view.


You can use CTRL + F open search dialog and search any keywords set in all region. System will filter out and highlight all regions with this keyword, and then you can modify tags for multiple region in one time.


Step 6

Draw routing path.

Please add another new layer.


Use draw nodes tool to draw path by following three principles as below:

A. All routing path must connected together.

B. The ending node of a path must inside the destination region.

C. In addition to the path ending node, other nodes can not fall within the destination region.


Step 7

Export map.xml file and path.xml file.

choose one layer at one time, and save as .xml file.