standalone

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. The example writes the output to GeoJSON.

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:

sbt "runMain com.here.platform.example.location.scala.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:

sbt "runMain com.here.platform.example.location.scala.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.

The example writes the output to a temporary file in GeoJSON format.

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:

sbt "runMain com.here.platform.example.location.scala.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.

The example writes the output to GeoJSON.

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:

sbt "runMain com.here.platform.example.location.scala.standalone.PathMatcherExample"

Path Matching with Restrictions

This example also creates a path matcher but filters the routing graph to exclude road segments that are not traversable by taxis.

The example uses the filtered graph to create a custom CandidateGenerator and TransitionProbabilityStrategy for the path matcher.
All components of the path matcher that use the routing graph must use the same (filtered) view on it.
Otherwise, the path matcher might produce inconsistent results.

The example prints its output to the console.

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:

sbt "runMain com.here.platform.example.location.scala.standalone.PathMatcherWithCustomNetworkFilterExample"

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.

For visualization purposes, the example serializes the output to GeoJSON.

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:

sbt "runMain com.here.platform.example.location.scala.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 produces a GeoJson file containing all these vertices colored by functional class.

Source code

Setup

To run the example locally, use the following commands:

sbt "runMain com.here.platform.example.location.scala.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 produces a GeoJson file containing the start vertices and all vertices that are directly adjacent to a start vertex. The start vertices are shown in blue. An adjacent vertex is shown in red, if turning from a start vertex to that vertex is restricted, in gray otherwise.

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:

sbt "runMain com.here.platform.example.location.scala.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:

sbt "runMain com.here.platform.example.location.scala.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:

sbt "runMain com.here.platform.example.location.scala.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.

The example writes the output to GeoJSON using different colours to highlight the reconstructed segments.

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:

sbt "runMain com.here.platform.example.location.scala.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 commands:

sbt "runMain com.here.platform.example.location.scala.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 commands:

sbt "runMain com.here.platform.example.location.scala.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 commands:

sbt "runMain com.here.platform.example.location.scala.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 commands:

sbt "runMain com.here.platform.example.location.scala.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 commands:

sbt "runMain com.here.platform.example.location.scala.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 commands:

sbt "runMain com.here.platform.example.location.scala.standalone.OlrResolveReferenceToHmcSegmentsExample"