Home

Tracks2Map is a plugin for the OpenStreetMap editor JOSM. It opens all GPX tracks in the current map view from a specified directory. Optionally, it can work recursively on subdirectories. Only those tracks, are opened that actually cross the map view. If available, associated markers are opened as well.

As the plugin may open a number of GPX track layers and GPX marker layers at a time, it also provides a menu option for deleting all GPX layers at a time.

Building from source

Tracks2Map plugin is configured as Eclipse Java project. The project directory must be placed in josm/plugins of the original JOSM source tree for build.xml to work. The location of the JOSM project needs to be specified on the build path. The built plugin Tracks2Map.jar will be found in josm/dist.

Installation

1. Copy the plugin JAR file Tracks2Map.jar into the JOSM plugins directory. Under Linux, the plugins directory should be located at $HOME/.local/share/JOSM/plugins.
2. Launch JOSM and select Edit -> Preferences from the menu bar.
3. In the opened preferences dialog, select the tab Plugins.
4. In the sub-tab Plugins, select radio button option Available.
5. Search for Tracks2Map: [...] in the list of available plugins and select the checkbox.
6. Click the OK button at the bottom.
7. It might be necessary to restart JOSM for the changes to take effect.

Configuration

Preferences dialog

1. From the JOSM menu bar, select Edit -> Preferences.
2. In the opened preferences dialog, select the tab Tracks2Map.
3. Select the directory with your recorded or gathered GPX tracks via the file chooser dialog and check the Recursive option as needed.
4. Click the OK button at the bottom.

Configuration options

Option	Default	Description
GPX Track Directory	null	Path of the directory where the recorded or gathered GPX tracks are located.
Recursive	true	If enabled, the plugin will work on subdirectories recursively.

Usage

File menu actions

Tracks2Map adds two actions to the JOSM file menu:

• Open all tracks in map view: Opens all GPX tracks which cross the current map view from the specified directory and optionally its subdirectories.
• Delete all GPX track and marker layers: Deletes all GPX layers at a time so they do not need to be closed one by one.

Toolbar icons

The two above mentioned menu actions can be added to the toolbar as icons:

1. From the JOSM menu bar, select Edit -> Preferences.
2. In the opened preferences dialog, select the tab Toolbar.
3. In the tree Available on the right, expand the File node and select the Tracks2Map menu actions.
4. Click on the button with the blue arrow to the left which is located in the middle section.
5. The actions are now part of the toolbar list.
6. Use the light blue up and down arrows to adjust the position of the icons in the toolbar as desired.
7. After clicking OK, the icons will be available in the toolbar.

Opening all tracks in the current map view

When executed in a JOSM session for a specified GPX tracks directory for the first time, the action may take some time to finish (depending on the number of GPX files) as all GPX files in the directory (tree) have to be opened and the track bounds have to be determined. The next time that the action is executed, it will run much faster as the track bounds are kept in memory and therefore only new GPX files or GPX files with track bounds intersecting the map bounds will be opened to check if the track actually crosses the map view.

To provide the user a feeling of the time required to finish, a progress dialog is shown each time that the tracks open action is executed.