This box suggests the current best answer
Prior revisions of answers
Proposal 2
Proposal text
...
Description of changes
<description of the changes>
Comments
Who | What | Decision | |
|---|---|---|---|
| 1 | |||
| 2 | |||
| 3 |
Proposal 1
Proposal text (MS Copilot generated)
Yes, there is comprehensive implementation documentation available for OpenLR. Here are some key resources:
GitHub Repository
The OpenLR GitHub repository contains the reference implementation of OpenLR. It includes modules for encoding and decoding OpenLR locations, as well as tools for map access and data handling [1].
HOWTO.md
The HOWTO.md file in the GitHub repository provides detailed instructions on how to encode and decode OpenLR locations on digital maps [2].
INRIX Documentation
INRIX offers documentation on Dynamic Location Referencing, which includes information on OpenLR. This resource provides insights into the implementation tools available, such as the Java-based encoder/decoder and map access layer [3].
These resources should help you get started with implementing OpenLR in your projects.
References
[1] GitHub - tomtom-international/openlr: Reference implementation of ...
[2] openlr/HOWTO.md at master · tomtom-international/openlr - GitHub
[3] Dynamic Location Referencing - INRIX documentation
Description of changes
<description of the changes>
Comments
Who | What | Decision | |
|---|---|---|---|
| 1 | |||
| 2 | |||
| 3 |
Proposal text (ChatGPTgenerated)
1. Official OpenLR Documentation (by TomTom)
📄 OpenLR White Paper (Core Specification)
The foundational document that explains:
The encoding/decoding process
Location reference types
Binary and XML formats
Algorithms for location matching
📍 Link: https://www.openlr.org/docs/OpenLR-whitepaper.pdf
✅ 2. OpenLR Reference Implementation (Java Library)
📦 Official GitHub Repository
TomTom’s open-source Java implementation of OpenLR
Includes:
Encoding/decoding tools
Sample map and test data
CLI tools
Great for understanding the logic and getting started with your own integration
📍 GitHub: https://github.com/TomTom/openlr
✅ 3. OpenLR Encoder/Decoder Flow Diagrams
The whitepaper and GitHub repo include helpful flow diagrams and pseudo-code for:
Finding candidate locations
Generating location references
Decoding them onto different maps
This helps if you're implementing OpenLR in a language other than Java (e.g., C++, Python, JavaScript).
✅ 4. Community/Examples
While OpenLR isn't widely discussed in public forums, you can find:
Example implementations or forks on GitHub (search "OpenLR").
Occasional integration notes in projects using OpenStreetMap or routing engines like GraphHopper or OSRM.
❗Note: No "Plug-and-Play" Web API
OpenLR is a specification and library, not a hosted API or web service.
You typically:
Integrate the encoder on your side (to generate references).
Transmit the encoded data (binary or base64).
Use the decoder on the recipient side to map-match to their own map data.
Bonus: Alternatives and Extensions
If your use case goes beyond what the core OpenLR offers, you might consider:
OpenLR+ (an extended version used internally by some companies)
Custom adaptations for area locations, GeoCoordinate encoding, etc.
