1. Home
  2. Documents
  3. Software
    1. Projects
    2. Download
    3. Maven
    4. API
    5. Tools
      1. OTK
  4. Test data
  5. FAQ
  6. Newsletter
  7. Users
  8. Contact

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:

Map Viewer

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.

Downloads
The 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
User guide MapViewer-UserGuide.pdf
API documentation mapViewer-1.4.2-javadoc.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 access

The 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.

  <project>
    ...
    <dependencies>
      ...
      <dependency>
        <groupId>openlr-tools</groupId>
        <artifactId>mapViewer</artifactId>
        <version>add-version-here</version>
      </dependency>
      ...
    </dependencies>
    ...
  </project>


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).

Downloads

The 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
API documentation otk-1.4.2-javadoc.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

Maven access

The OpenLR™ toolkit 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.

  <project>
    ...
    <dependencies>
      ...
      <dependency>
        <groupId>openlr-tools</groupId>
        <artifactId>otk</artifactId>
        <version>add-version-here</version>
      </dependency>
      ...
    </dependencies>
    ...
  </project>