|The data structure of the plug-in is based on the F3DB proposal, and is therefore just a draft. The mapping, done with this plug-in, should happen in a seperated OSM-Layer and must not be uploaded.|
IndoorHelper is a JOSM plug-in to create, validate and view indoor maps correctly.
After the installation the plug-in appears in the sidebar of JOSM. From there it can be activated using the "POWER"-button, which will make the "Level Selection"-dialog appear where the user describes the building structure by input the lowest and highest level. Next he has to fit his indoor maps into existing OpenStreetMap data or GPS-tracks. It is recommended to use the plug-in Piclayer to complete this task.
When the fitting process of the indoor maps is completed, the user can start to map the indoor data. First he selects the level he wants to edit in the "Working Level" dropdown menu. Next he selects an indoor object he wants to draw out of the "object" dropdown menu. Then he can draw the object, adds when needed a name and ref and applies the tags with the "Apply Tags"-button.
The recommended order of editing is:
- stairways and elevators
- POIs (door/entrance)
On the right side of the plug-in you can find the preset button section. These buttons are created depending on what objects you are using the most. To use these presets, just draw an object and click on the preset you would like to apply.
The data scheme which underlies the plug-in is based on the F3DB approach but has some differences or improvements. It is completely based on tags and is therefore easy to understand.
Here is the complete set of tags which is used by the plug-in:
|indoor:level=*||the number of the level||
|indoor:level:name=*||the name or function of the level||
|name=*||the name or function of the room||
|ref=*||the reference number of the room||
The first way of data validation is the MapCSS rendertheme which comes with the plug-in. It is installed during the first start. Furthermore it is activated when the plug-in is turned on and deactivated when it is turned off. Thus the user doesn't have to care about to care about it and has a instant graphical validation of the mapped data.
The rendertheme uses the zoomlevel filtering of MapCSS to show the data in different ways depending on the zoom level of JOSM. For exmaple in a high zoom level every detail is shown and in a low zoom levels rooms and POIs are hidden.
The other method which can be used to validate the data is the JOSM validator file which is also installed with the plug-in. Like the MapCSS rendertheme it is also activated when the plug-in is activated.
The validator alarms the user if following mapping errors occur:
- way or node without the tag indoor:level=*
- properties which should be only assigned to ways are assigned to nodes
- properties which should be only assigned to nodes are assigned to ways
The validation check is done everytime when the user clicks the "Apply"-button or a preset button.
- No connections between levels
- It's just a graphical representation
- therefore not suited for routing
- It is no usable standard (yet)
Created by User:Erigrus. Please submit your bug reports.
Source Code: SVN
-  - The plug-in was devoloped in this bachelor thesis. It can be seen as a detailed (German) documentation.