OpenLR™ - Software tools
The tooling section provides software applications which can be used in combination with the OpenLR™ reference implementation. These tools are not part of the reference implementation and are not required for using the OpenLR™ method.The following OpenLR™ tools are available:
|The Map Viewer application draws an OpenLR™ map and
provides basic map view functionality. Additionally the user can
select locations in the map and encode them. The location reference
can be analyzed and stored. Location references can also be decoded
and shown in the map.
The application is able to load all maps implementing the OpenLR™ map interface. On startup it searches for implementations of the OpenLRMapLoader interface in the Classpath via Java ServiceLoader.
The MapViewer will provide a selection dialog containing all located loader implementations. After selection and specification of the required parameters the chosen loader implementation is invoked to establish a connection to the specific map in the form of the OpenLR™ map interface. TomTom provides a map loader implementation which can be used to load the sample maps from section Test data.
The MapViewer application can be started provided with this map loader using the following command line scheme:
java -cp mapViewer-<version>-with-dependencies.jar<delimiter>tt-sqlite-<version>-with-dependencies.jar openlr.mapviewer.MapViewer
The Classpath delimiter is ";" for Windows and ":" on Unix-like systems.
To enable access to your own OpenLR™ map you have to implement interface OpenLRMapLoader first. Please read the instructions of the Java ServiceLoader documentation on how to configure your loader then for the MapViewer.
The application can be downloaded as a complete bundle including all required additional packages or you can get it using maven. Both download alternatives are described below. The "Map Viewer" is released under an extended version of the Apache version 2.0 license (see software license). A user guide provides a first impression of the Map Viewer functionalities.
DownloadsThe following table summarizes the Map Viewer related links on this website.
|Links and downloads|
|Complete package including all required packages (recommended)||mapViewer-1.4.2-with-dependencies.jar|
|Compiled package, required packages need to be added manually||mapViewer-1.4.2.jar|
|Source code to rebuild this tool||mapViewer-1.4.2-sources.jar|
|Map Viewer reports generated by Maven||Reports|
|Map Viewer API documentation||API|
Maven accessThe Map Viewer tool can also be retrieved via Maven. You need to connect to our repository (you can find a description in the Maven access section) and to add the following dependency to your POM.
OpenLR™ toolkit (otk)
OTK is a bundle of useful command line tools regarding OpenLR™.
It enables to encode locations or decode location references on OpenLR™ maps, to visualize the data contained in location references and much more. For further information please visit the details site about OTK.
The application can be downloaded as a complete package including all required additional packages or you can get it using maven. Both download alternatives are described below. The OpenLR™ toolkit is released under an extended version of the Apache version 2.0 license (see software license).
DownloadsThe following table summarizes the OpenLR™ toolkit related links on this website.
|Links and downloads|
|Complete bundle including all required packages and start scripts (recommended)||otk-1.4.2.zip|
|Compiled package, required packages need to be added manually||otk-1.4.2.jar|
|Source code to rebuild this tool||otk-1.4.2-sources.jar|
|OpenLR™ toolkit reports generated by Maven||Reports|
|OpenLR™ toolkit API documentation||API|