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 to use the OpenLR™ method.
The following OpenLR™ tools are available:Map Viewer
| The Map Viewer application draws an OpenLR™ map and
provides basic map view functionalities. 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 can load all maps based on the OpenLR™ map interface but needs to find an implementation of the map loader interface. Such an implementation is called to load a specific map so that the application does not need to know how the map is stored and accessed. For a complete documentation of the requirements please see the software API. TomTom provides a map loader implementation which can be used to load the TomTom map samples (see test data). The application can be downloaded as a complete package including all required additonal 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 GPL version 2 (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.2.2-with-dependencies.jar |
| Compiled package, required packages need to be added manually | mapViewer-1.2.2.jar |
| User guide | MapViewer-UserGuide.pdf |
| API documentation | mapViewer-1.2.2-javadoc.jar |
| Source code to rebuild this tool | mapViewer-1.2.2-sources.jar |
| Map Viewer reports generated by Maven | Reports |
| Map Viewer API documentation | API |
Maven access
The Map Viewer tool can also be accessed using 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>Binary Data Viewer
The "Binary Data Viewer" is able to read binary or Base64-encoded location reference data and to generate a human-readable information describing the content of the binary data.
This tool can be used on the command line but also within a Java application. The output can be customized using Velocity templates (http://velocity.apache.org) and the tool can read binary location references as a bitstream (from file or bytes array) or as a Base64-encoded string (also from file or as a string).
The application can be downloaded as a complete package including all required additonal packages or you can get it using maven. Both download alternatives are described below. The "Binary Data Viewer" is released under an extended version of the GPL version 2 (see software license).
Downloads
The following table summarizes the Binary Data Viewer related links on this website.| Links and downloads | |
|---|---|
| Complete package including all required packages (recommended) | binaryDataViewer-1.2.2-with-dependencies.jar |
| Compiled package, required packages need to be added manually | binaryDataViewer-1.2.2.jar |
| API documentation | binaryDataViewer-1.2.2-javadoc.jar |
| Source code to rebuild this tool | binaryDataViewer-1.2.2-sources.jar |
| Binary Data Viewer reports generated by Maven | Reports |
| Binary Data Viewer API documentation | API |
| Output templates | Text
file KML file |
Maven access
The Binary Data Viewer tool can also be accessed using 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>binaryDataViewer</artifactId>
<version>add-version-here</version>
</dependency>
...
</dependencies>
...
</project>Physical Format Converter
The Physical Format Converter can be used to convert an OpenLR™ physical format into another OpenLR™ physical format. This format provides a mechanism to convert e.g. a binary location reference into a Xml location reference.
This tool suppports the physical formats binary, binary (Base64-encoded), XML, and Datex2.
The application can be downloaded as a complete package including all required additonal packages or you can get it using maven. Both download alternatives are described below. The "Physical Format Converter" is released under an extended version of the GPL version 2 (see software license).
Downloads
The following table summarizes the Physical Format Converter related links on this website.| Links and downloads | |
|---|---|
| Complete package including all required packages (recommended) | physFormatConverter-1.2.2-with-dependencies.jar |
| Compiled package, required packages need to be added manually | physFormatConverter-1.2.2.jar |
| API documentation | physFormatConverter-1.2.2-javadoc.jar |
| Source code to rebuild this tool | physFormatConverter-1.2.2-sources.jar |
| Physical Format Converter reports generated by Maven | Reports |
| Physical Format Converter API documentation | API |
Maven access
The Physical Format Converter tool can also be accessed using 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>physFormatConverter</artifactId>
<version>add-version-here</version>
</dependency>
...
</dependencies>
...
</project>