### Build Project with Maven

Source: https://github.com/tomtom-international/openlr/blob/master/README.md

Instructions for building the OpenLR project using Maven. This command cleans the project and installs all modules. It can be run from the project root or individual module folders.

```maven
mvn clean install

```

--------------------------------

### OpenLR Point Along Line Location Reference (XML)

Source: https://github.com/tomtom-international/openlr/blob/master/datex2/src/test/resources/pointalong.txt

This XML snippet demonstrates an OpenLR point along a line location reference. It includes details such as side of road, orientation, positive offset, location reference points with coordinates, and line/path attributes.

```XML
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<d2LogicalModel xmlns="http://datex2.eu/schema/2_0RC2/2_0">
    <payloadPublication xsi:type="SituationPublication" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <situation>
            <situationRecord xsi:type="Accident">
                <groupOfLocations xsi:type="Point">
                    <pointExtension>
                        <OpenlrExtendedPoint>
                            <openlrPointLocationReference>
<openlrPointAlongLine>
    <openlrSideOfRoad>left</openlrSideOfRoad>
    <openlrOrientation>noOrientationOrUnknown</openlrOrientation>
    <openlrPositiveOffset>28</openlrPositiveOffset>
    <openlrLocationReferencePoint>
        <openlrCoordinate>
            <latitude>49.60597</latitude>
            <longitude>6.12829</longitude>
        </openlrCoordinate>
        <openlrLineAttributes>
            <openlrFunctionalRoadClass>FRC2</openlrFunctionalRoadClass>
            <openlrFormOfWay>multipleCarriageway</openlrFormOfWay>
            <openlrBearing>202</openlrBearing>
        </openlrLineAttributes>
        <openlrPathAttributes>
            <openlrLowestFRCToNextLRPoint>FRC2</openlrLowestFRCToNextLRPoint>
            <openlrDistanceToNextLRPoint>92</openlrDistanceToNextLRPoint>
        </openlrPathAttributes>
    </openlrLocationReferencePoint>
    <openlrLastLocationReferencePoint>
        <openlrCoordinate>
            <latitude>49.60521</latitude>
            <longitude>6.12779</longitude>
        </openlrCoordinate>
        <openlrLineAttributes>
            <openlrFunctionalRoadClass>FRC2</openlrFunctionalRoadClass>
            <openlrFormOfWay>multipleCarriageway</openlrFormOfWay>
            <openlrBearing>42</openlrBearing>
        </openlrLineAttributes>
    </openlrLastLocationReferencePoint>
</openlrPointAlongLine>
                            </openlrPointLocationReference>
                        </OpenlrExtendedPoint>
                    </pointExtension>
                </groupOfLocations>
            </situationRecord>
        </situation>
    </payloadPublication>
</d2LogicalModel>
```

--------------------------------

### OpenLR Location Data Structure (XML)

Source: https://github.com/tomtom-international/openlr/blob/master/datex2/src/test/resources/geocoord.txt

This snippet shows an XML structure for representing OpenLR location data within a DATE2 SituationPublication. It details the hierarchical structure for point locations and includes specific latitude and longitude coordinates.

```xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<d2LogicalModel xmlns="http://datex2.eu/schema/2_0RC2/2_0">
    <payloadPublication xsi:type="SituationPublication" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <situation>
            <situationRecord xsi:type="Accident">
                <groupOfLocations xsi:type="Point">
                    <pointExtension>
                        <OpenlrExtendedPoint>
                            <openlrPointLocationReference>
<openlrGeoCoordinate>
    <openlrCoordinate>
        <latitude>49.60728</latitude>
        <longitude>6.12699</longitude>
    </openlrCoordinate>
</openlrGeoCoordinate>
                            </openlrPointLocationReference>
                        </OpenlrExtendedPoint>
                    </pointExtension>
                </groupOfLocations>
            </situationRecord>
        </situation>
    </payloadPublication>
</d2LogicalModel>
```

--------------------------------

### Running OpenLR Sample Tests

Source: https://github.com/tomtom-international/openlr/blob/master/openlr-usage-sample/README.md

Command to compile and run the unit tests for the OpenLR sample project using Maven. This verifies the integration and functionality of the encoder and decoder with a sample map.

```shell
mvn test
```

--------------------------------

### OpenLR Maven Dependencies

Source: https://github.com/tomtom-international/openlr/blob/master/openlr-usage-sample/README.md

Dependencies required to include the OpenLR reference implementation in a Java project. These artifacts provide the core encoder, decoder, and binary format functionalities.

```xml
<dependency>
    <groupId>org.openlr</groupId>
    <artifactId>encoder</artifactId>
    <version>1.4.3</version>
</dependency>
<dependency>
    <groupId>org.openlr</groupId>
    <artifactId>decoder</artifactId>
    <version>1.4.3</version>
</dependency>
<dependency>
    <groupId>org.openlr</groupId>
    <artifactId>binary</artifactId>
    <version>1.4.3</version>
</dependency>
```

--------------------------------

### Load Map Database from SQLite

Source: https://github.com/tomtom-international/openlr/blob/master/HOWTO.md

Demonstrates loading map data into an OpenLR MapDatabase instance using a SQLite loader. It specifies the map file path via DBFileNameParameter and initializes the loader.

```java
MapLoadParameter param = new DBFileNameParameter();
param.setValue("path/to/map");
OpenLRMapLoader loader = new SQLiteMapLoader();
MapDatabase map = loader.load(Arrays.asList(param));
```

--------------------------------

### Maven Dependencies for OpenLR Modules

Source: https://github.com/tomtom-international/openlr/blob/master/HOWTO.md

Essential Maven dependencies required to use various modules of the OpenLR library, including encoder, decoder, map data handling, and different physical format support (binary, protobuf, XML). Replace ${openlr.version} with the desired library version.

```xml
<dependency>
 <groupId>org.openlr</groupId>
 <artifactId>encoder</artifactId>
 <version>${openlr.version}</version>
</dependency>
```

```xml
<dependency>
 <groupId>org.openlr</groupId>
 <artifactId>decoder</artifactId>
 <version>${openlr.version}</version>
</dependency>
```

```xml
<dependency>
 <groupId>org.openlr</groupId>
 <artifactId>map</artifactId>
 <version>${openlr.version}</version>
</dependency>
```

```xml
<dependency>
 <groupId>org.openlr</groupId>
 <artifactId>data</artifactId>
 <version>${openlr.version}</version>
</dependency>
```

```xml
<dependency>
 <groupId>org.openlr</groupId>
 <artifactId>binary</artifactId>
 <version>${openlr.version}</version>
</dependency>
```

```xml
<dependency>
 <groupId>org.openlr</groupId>
 <artifactId>xml</artifactId>
 <version>${openlr.version}</version>
</dependency>
```

```xml
<dependency>
 <groupId>org.openlr</groupId>
 <artifactId>proto</artifactId>
 <version>${openlr.version}</version>
</dependency>
```

--------------------------------

### Decode OpenLR Binary Location Reference in Java

Source: https://github.com/tomtom-international/openlr/blob/master/HOWTO.md

Demonstrates decoding an OpenLR binary location reference string in Java. It initializes the decoder, loads properties, and decodes a Base64 encoded binary string into a map-locatable format. Requires OpenLR libraries and a properties file.

```java
String openlr = "CwmQ9SVWJS2qBAD9/14tCQ==";

OpenLRBinaryDecoder binaryDecoder = new OpenLRBinaryDecoder();
ByteArray byteArray = new ByteArray(Base64.getDecoder().decode(openlr));
LocationReferenceBinaryImpl locationReferenceBinary = new LocationReferenceBinaryImpl("Test location", byteArray);
RawLocationReference rawLocationReference = binaryDecoder.decodeData(locationReferenceBinary);

Configuration decoderConfig = OpenLRPropertiesReader.loadPropertiesFromFile(new File(TestMapStubTest.class.getClassLoader().getResource("OpenLR-Decoder-Properties.xml").getFile()));
OpenLRDecoderParameter params = new OpenLRDecoderParameter.Builder().with(map).with(decoderConfig).buildParameter();

OpenLRDecoder decoder = new openlr.decoder.OpenLRDecoder();

Location location = decoder.decodeRaw(params, rawLocationReference);
```

--------------------------------

### Encode Line Location to OpenLR Binary Format

Source: https://github.com/tomtom-international/openlr/blob/master/HOWTO.md

Shows how to encode a line location, represented by a list of map lines, into the OpenLR binary format. It involves creating a LineLocation, initializing a binary encoder, configuring encoder properties, and generating the final binary data.

```java
//Build the line location
List<Line>  testLocation = Arrays.asList(mapDatabaseAdapter.getLine(1),
                                         mapDatabaseAdapter.getLine(2),
                                         mapDatabaseAdapter.getLine(3),
                                         mapDatabaseAdapter.getLine(4));
Location location = LocationFactory.createLineLocation("Test location", testLocation, 0, 0);

//Initialize the physical format encoder
PhysicalEncoder physicalEncoder = new OpenLRBinaryEncoder();

//Build the encoder configurations
Configuration encoderConfig = OpenLRPropertiesReader.loadPropertiesFromFile(new File("OpenLR-Encoder-Properties.xml"));
OpenLREncoderParameter params = new OpenLREncoderParameter.Builder().with(map).with(encoderConfig)
                .with(Arrays.asList(physicalEncoder))
                .buildParameter();

//Initialize the onpenlr encoder
OpenLREncoder encoder = new openlr.encoder.OpenLREncoder();

//Encode the line location in openlr format
LocationReferenceHolder locationReferenceHolder = encoder.encodeLocation(params, location);

//Generate the binary for the openlr location referencing container
String locationReferenceBinary = ((ByteArray) physicalEncoder.encodeData(locationReferenceHolder.getRawLocationReferenceData()).getLocationReferenceData()).getBase64Data();
```

--------------------------------

### OpenLR Linear Location Reference Structure

Source: https://github.com/tomtom-international/openlr/blob/master/datex2/src/test/resources/line.txt

This snippet represents a DATE2 SituationPublication containing an OpenLR linear location reference. It defines a sequence of location reference points, each with coordinates, functional road class, form of way, bearing, and distance to the next point. It also includes offsets for precise location within the line segment.

```XML
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<d2LogicalModel xmlns="http://datex2.eu/schema/2_0RC2/2_0">
    <payloadPublication xsi:type="SituationPublication" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <situation>
            <situationRecord xsi:type="Accident">
                <groupOfLocations xsi:type="Linear">
                    <linearExtension>
                        <OpenlrExtendedLinear>
                            <openlrLineLocationReference>
<openlrLocationReferencePoint>
    <openlrCoordinate>
        <latitude>49.60851</latitude>
        <longitude>6.12683</longitude>
    </openlrCoordinate>
    <openlrLineAttributes>
        <openlrFunctionalRoadClass>FRC3</openlrFunctionalRoadClass>
        <openlrFormOfWay>multipleCarriageway</openlrFormOfWay>
        <openlrBearing>135</openlrBearing>
    </openlrLineAttributes>
    <openlrPathAttributes>
        <openlrLowestFRCToNextLRPoint>FRC3</openlrLowestFRCToNextLRPoint>
        <openlrDistanceToNextLRPoint>561</openlrDistanceToNextLRPoint>
    </openlrPathAttributes>
</openlrLocationReferencePoint>
<openlrLocationReferencePoint>
    <openlrCoordinate>
        <latitude>49.60398</latitude>
        <longitude>6.12838</longitude>
    </openlrCoordinate>
    <openlrLineAttributes>
        <openlrFunctionalRoadClass>FRC3</openlrFunctionalRoadClass>
        <openlrFormOfWay>singleCarriageway</openlrFormOfWay>
        <openlrBearing>227</openlrBearing>
    </openlrLineAttributes>
    <openlrPathAttributes>
        <openlrLowestFRCToNextLRPoint>FRC5</openlrLowestFRCToNextLRPoint>
        <openlrDistanceToNextLRPoint>274</openlrDistanceToNextLRPoint>
    </openlrPathAttributes>
</openlrLocationReferencePoint>
<openlrLastLocationReferencePoint>
    <openlrCoordinate>
        <latitude>49.60305</latitude>
        <longitude>6.12817</longitude>
    </openlrCoordinate>
    <openlrLineAttributes>
        <openlrFunctionalRoadClass>FRC5</openlrFunctionalRoadClass>
        <openlrFormOfWay>singleCarriageway</openlrFormOfWay>
        <openlrBearing>290</openlrBearing>
    </openlrLineAttributes>
</openlrLastLocationReferencePoint>
<openlrOffsets>
    <openlrPositiveOffset>200</openlrPositiveOffset>
    <openlrNegativeOffset>0</openlrNegativeOffset>
</openlrOffsets>
                            </openlrLineLocationReference>
                        </OpenlrExtendedLinear>
                    </linearExtension>
                </groupOfLocations>
            </situationRecord>
        </situation>
    </payloadPublication>
</d2LogicalModel>
```

--------------------------------

### DATECT 2.0 Situation Publication (Accident)

Source: https://github.com/tomtom-international/openlr/blob/master/datex2/src/test/resources/poiaccess.txt

The overall structure of a DATECT 2.0 Situation Publication, specifically detailing an accident. It includes a group of locations which, in this case, uses OpenLR for point-based location referencing.

```XML
<d2LogicalModel xmlns="http://datex2.eu/schema/2_0RC2/2_0">
    <payloadPublication xsi:type="SituationPublication" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <situation>
            <situationRecord xsi:type="Accident">
                <groupOfLocations xsi:type="Point">
                    <pointExtension>
                        <OpenlrExtendedPoint>
                            <openlrPointLocationReference>
                                <openlrPoiWithAccessPoint>
                                    <openlrSideOfRoad>left</openlrSideOfRoad>
                                    <openlrOrientation>noOrientationOrUnknown</openlrOrientation>
                                    <openlrPositiveOffset>28</openlrPositiveOffset>
                                    <openlrLocationReferencePoint>
                                        <openlrCoordinate>
                                            <latitude>49.60597</latitude>
                                            <longitude>6.12829</longitude>
                                        </openlrCoordinate>
                                        <openlrLineAttributes>
                                            <openlrFunctionalRoadClass>FRC2</openlrFunctionalRoadClass>
                                            <openlrFormOfWay>multipleCarriageway</openlrFormOfWay>
                                            <openlrBearing>202</openlrBearing>
                                        </openlrLineAttributes>
                                        <openlrPathAttributes>
                                            <openlrLowestFRCToNextLRPoint>FRC2</openlrLowestFRCToNextLRPoint>
                                            <openlrDistanceToNextLRPoint>92</openlrDistanceToNextLRPoint>
                                        </openlrPathAttributes>
                                    </openlrLocationReferencePoint>
                                    <openlrLastLocationReferencePoint>
                                        <openlrCoordinate>
                                            <latitude>49.60521</latitude>
                                            <longitude>6.12779</longitude>
                                        </openlrCoordinate>
                                        <openlrLineAttributes>
                                            <openlrFunctionalRoadClass>FRC2</openlrFunctionalRoadClass>
                                            <openlrFormOfWay>multipleCarriageway</openlrFormOfWay>
                                            <openlrBearing>42</openlrBearing>
                                        </openlrLineAttributes>
                                    </openlrLastLocationReferencePoint>
                                    <openlrCoordinate>
                                        <latitude>49.60728</latitude>
                                        <longitude>6.12699</longitude>
                                    </openlrCoordinate>
                                </openlrPoiWithAccessPoint>
                            </openlrPointLocationReference>
                        </OpenlrExtendedPoint>
                    </pointExtension>
                </groupOfLocations>
            </situationRecord>
        </situation>
    </payloadPublication>
</d2LogicalModel>
```

--------------------------------

### OpenLR Poi With Access Point

Source: https://github.com/tomtom-international/openlr/blob/master/datex2/src/test/resources/poiaccess.txt

Represents a Point of Interest (POI) with an access point, including side of road, orientation, positive offset, and the location reference point. This structure is used to pinpoint specific locations along a road.

```XML
<openlrPoiWithAccessPoint>
    <openlrSideOfRoad>left</openlrSideOfRoad>
    <openlrOrientation>noOrientationOrUnknown</openlrOrientation>
    <openlrPositiveOffset>28</openlrPositiveOffset>
    <openlrLocationReferencePoint>
        <openlrCoordinate>
            <latitude>49.60597</latitude>
            <longitude>6.12829</longitude>
        </openlrCoordinate>
        <openlrLineAttributes>
            <openlrFunctionalRoadClass>FRC2</openlrFunctionalRoadClass>
            <openlrFormOfWay>multipleCarriageway</openlrFormOfWay>
            <openlrBearing>202</openlrBearing>
        </openlrLineAttributes>
        <openlrPathAttributes>
            <openlrLowestFRCToNextLRPoint>FRC2</openlrLowestFRCToNextLRPoint>
            <openlrDistanceToNextLRPoint>92</openlrDistanceToNextLRPoint>
        </openlrPathAttributes>
    </openlrLocationReferencePoint>
    <openlrLastLocationReferencePoint>
        <openlrCoordinate>
            <latitude>49.60521</latitude>
            <longitude>6.12779</longitude>
        </openlrCoordinate>
        <openlrLineAttributes>
            <openlrFunctionalRoadClass>FRC2</openlrFunctionalRoadClass>
            <openlrFormOfWay>multipleCarriageway</openlrFormOfWay>
            <openlrBearing>42</openlrBearing>
        </openlrLineAttributes>
    </openlrLastLocationReferencePoint>
    <openlrCoordinate>
        <latitude>49.60728</latitude>
        <longitude>6.12699</longitude>
    </openlrCoordinate>
</openlrPoiWithAccessPoint>
```

--------------------------------

### OpenLR Location Reference Point

Source: https://github.com/tomtom-international/openlr/blob/master/datex2/src/test/resources/poiaccess.txt

Details the structure for an OpenLR location reference point, including coordinates, line attributes, and path attributes. This is crucial for defining segments of a road network.

```XML
<openlrLocationReferencePoint>
    <openlrCoordinate>
        <latitude>49.60597</latitude>
        <longitude>6.12829</longitude>
    </openlrCoordinate>
    <openlrLineAttributes>
        <openlrFunctionalRoadClass>FRC2</openlrFunctionalRoadClass>
        <openlrFormOfWay>multipleCarriageway</openlrFormOfWay>
        <openlrBearing>202</openlrBearing>
    </openlrLineAttributes>
    <openlrPathAttributes>
        <openlrLowestFRCToNextLRPoint>FRC2</openlrLowestFRCToNextLRPoint>
        <openlrDistanceToNextLRPoint>92</openlrDistanceToNextLRPoint>
    </openlrPathAttributes>
</openlrLocationReferencePoint>
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.