README.md

Traversing the Graph

This example shows how to create a traversable graph from the HERE Optimized Map for Location Library catalog. The routinggraph layer contains information about the connectivity between segments of the HERE Map Content to allow the efficient traversal of the road topology. In the routing graph, a Vertex represents a topology segment in a direction. The routing graph uses Edges for connectivity.

The example implements a basic graph algorithm, breadth-first search.

The start vertex is an arbitrary Vertex.

Source code

Setup

To run the example, you need access to the following catalog.

• HERE Optimized Map for Location Library

To run the example locally, use the following commands:

mvn --projects=:java-standalone compile exec:java \
    -Dexec.mainClass=com.here.platform.example.location.java.standalone.GraphExample

Converting References from HERE Optimized Map for Location Library to HERE Map Content

This example shows how to convert Vertex references into HERE Map Content segment URIs with a direction, and vice versa.

Source code

Setup

To run the example, you need access to the following catalog.

• HERE Optimized Map for Location Library

To run the example locally, use the following commands:

mvn --projects=:java-standalone compile exec:java \
    -Dexec.mainClass=com.here.platform.example.location.java.standalone.HereMapContentToOptimizedMapTranslationExample

Most Probable Path

This example shows how to navigate the graph representing the road network topology, using properties to compute the transition probability between road segments.

Computation of the transition probability depends on the angle between the roads and the difference in the functional class.

Construction of the path follows a pure greedy rule and chooses the most probable next link.

Source code

Setup

To run the example, you need access to the following catalogs.

• HERE Optimized Map for Location Library

To run the example locally, use the following commands:

mvn --projects=:java-standalone compile exec:java \
    -Dexec.mainClass=com.here.platform.example.location.java.standalone.MostProbablePathExample

Path Matching Example

This example creates a path matcher using the geometry layer as a spatial index and routinggraph layer as the topology connectivity layer.

The example creates default emission and transition probability strategies used to initialize the Hidden Markov Model based path matcher.

Source code

Setup

To run the example, you need access to the following catalog.

• HERE Optimized Map for Location Library

To run the example locally, use the following commands:

mvn --projects=:java-standalone compile exec:java \
    -Dexec.mainClass=com.here.platform.example.location.java.standalone.PathMatcherExample

Point Matching Example

The point matcher is a simple point matching implementation for trips, showing how to use the Proximity Search functionality of the library to search for vertices around a location.

This example resolves and loads tiles from the geometry layer in order to cover the area needed to map-match the sample trip coordinates. Every trip element is resolved to the closest segment.

Source code

Setup

To run the example, you need access to the following catalog.

• HERE Optimized Map for Location Library

To run the example locally, use the following commands:

mvn --projects=:java-standalone compile exec:java \
    -Dexec.mainClass=com.here.platform.example.location.java.standalone.PointMatcherExample

Functional Class for a Vertex

This example shows how you can get the functional class for a vertex.

It looks up the vertices around a given location and prints the functional class associated with those vertices.

Source code

Setup

To run the example locally, use the following commands:

mvn --projects=:java-standalone compile exec:java \
    -Dexec.mainClass=com.here.platform.example.location.java.standalone.FunctionalClassExample

Turn Restrictions

This example shows how to check if turns (transitions between adjacent vertices, modeled as Edges) are restricted or not.

It looks up the two start vertices that represent the same road segment, figures out whether turns to their adjacent vertices have restrictions, and prints the turns that are restricted.

Source code

Setup

To run the example, you need access to the following catalog.

• HERE Optimized Map for Location Library

To run the example locally, use the following commands:

mvn --projects=:java-standalone compile exec:java \
    -Dexec.mainClass=com.here.platform.example.location.java.standalone.TurnRestrictionsExample

Generic Range Based Attributes

This example shows how to load a generic attribute that is not available in the HERE Optimized Map for Location Library using a Vertex reference.

Source code

Setup

To run the example, you need access to the following catalog.

• HERE Optimized Map for Location Library

To run the example locally, use the following commands:

mvn --projects=:java-standalone compile exec:java \
    -Dexec.mainClass=com.here.platform.example.location.java.standalone.OnTheFlyCompiledPropertyMapExample

ADAS Curvature Attribute

This example shows how to fetch and use ADAS attributes in the HERE Optimized Map for Location Library using a Vertex or an Edge reference.

Source code

Setup

To run the example, you need access to the following catalog.

• HERE Optimized Map for Location Library

To run the example locally, use the following commands:

mvn --projects=:java-standalone compile exec:java \
    -Dexec.mainClass=com.here.platform.example.location.java.standalone.AdasCurvatureAttributeExample

Path Matching Sparse Probe Data

Another example on how to use the path matcher (see also the section Path Matching Example) that shows how to handle the case of sparse probes, and the reconstruction of route segments between distant points.

Source code

Setup

To run the example, you need access to the following catalog.

• HERE Optimized Map for Location Library

To run the example locally, use the following commands:

mvn --projects=:java-standalone compile exec:java \
    -Dexec.mainClass=com.here.platform.example.location.java.standalone.SparsePathMatcherExample

Converting References from TPEG2 to its Binary Representation

In this example we read an OpenLR location reference that has been written in the TPEG2 XML encoding and convert it to its binary representation.

Source code

Setup

The example does not depend on map data.

To run the example locally, use the following command:

mvn --projects=:java-standalone compile exec:java \
    -Dexec.mainClass=com.here.platform.example.location.java.standalone.ConvertTpeg2ContainerExample

Extracting TPEG2 Document

This example demonstrates how to load a TPEG2 document and extract parts of the document that you are interested in. The functions available in TpegExtractors allow you to extract specific application messages, or location references.

Source code

Setup

The example does not depend on map data.

To run the example locally, use the following command:

mvn --projects=:java-standalone compile exec:java \
    -Dexec.mainClass=com.here.platform.example.location.java.standalone.ExtractSpecificTpeg2MessagesExample

Creating and Resolving TMC Reference

An example of how to use the location-referencing module to create a TMC reference and resolve it.

The example searches for a well-known vertex that is covered by TMC to define the input location.

Source code

Setup

To run the example, you need access to the following catalog:

• HERE Optimized Map for Location Library

To run the example locally, use the following command:

mvn --projects=:java-standalone compile exec:java \
    -Dexec.mainClass=com.here.platform.example.location.java.standalone.TmcCreateAndResolveExample

Resolving TMC References in RTTI Message

An example that demonstrates how TMC references in Real Time Traffic Incident (RTTI) messages can be converted to TPEG2 TMC references, and how the location-referencing module can be used to resolve those references.

RTTI messages are commonly found in the HERE Real Time Traffic catalog. The example provides a sample message, so that access to the catalog is not necessary when running it.

Source code

Setup

To run the example, you need access to the following catalog:

• HERE Optimized Map for Location Library

To run the example locally, use the following command:

mvn --projects=:java-standalone compile exec:java \
    -Dexec.mainClass=com.here.platform.example.location.java.standalone.TmcResolveReferencesInRttiMessageExample

Creating OpenLR Reference from Road Segments

This example shows how to take a path given as HERE Map Content references and create an OLR reference from it.

Source code

Setup

To run the example, you need access to the following catalog:

• HERE Optimized Map for Location Library

To run the example locally, use the following command:

mvn --projects=:java-standalone compile exec:java \
    -Dexec.mainClass=com.here.platform.example.location.java.standalone.OlrCreateReferenceFromHmcSegmentsExample

Resolving OpenLR Reference from Road Segments

This example shows how to take an OLR reference given in XML and to resolve this reference to HERE Map Content references.

Source code

Setup

To run the example, you need access to the following catalog:

• HERE Optimized Map for Location Library

To run the example locally, use the following command:

mvn --projects=:java-standalone compile exec:java \
    -Dexec.mainClass=com.here.platform.example.location.java.standalone.OlrResolveReferenceToHmcSegmentsExample