com.tomtom.sdk.navigation:navigation-engines/com.tomtom.sdk.navigation.horizon

Package-level declarations

Types

data class ExplicitDistancePolicy(val searchDistance: PathSearchDistance = PathSearchDistance( maxHorizonLength = DEFAULT_MAX_HORIZON_LENGTH )) : PathSearchDistancePolicy

Main path search distance policy that specifies a search distance. When this search policy is enabled, the horizon engine only searches within a subscription-specified distance when extending the main path. It does not search along the entire route. If the search distance is not specified, a default value corresponding to a maximum horizon length of 2 km will be used.

HorizonEngine

interface HorizonEngine : AutoCloseable

Defines the interface to the horizon engine. The horizon engine generates virtual horizon data based on previously registered horizon subscription options, which define the length of the horizon paths and what map data is collected for these paths. The client of the horizon engine can register multiple sets of horizon subscription options and request the engine to provide horizon data for all or some of these sets of options. The client of the engine can also update the subscription by registering a new set of subscription options or unregistering a previously registered set.

HorizonOptions

data class HorizonOptions(val elementTypes: List<HorizonElementType>, val mainPathSearchOptions: MainPathSearchOptions, val subPathSearchOptions: List<SubPathSearchOptions> = listOf(), val numberOfPaths: Int = 1)

Horizon subscription configuration. The client uses subscription options to define the extent of the paths in the horizon and the map attributes that are collected for these paths. A subscription configuration consists of four types of search options:

HorizonPath

class HorizonPath(val pathId: Int, val parentPathId: Int, val offsetOnParentPath: <Error class: unknown class>?, val geometry: List<PathGeometry>, elements: Map<HorizonElementType, List<HorizonElement>>)

Path in the horizon. The length of the path as well as which types of horizon elements it contains are determined by the horizon subscription options.

HorizonPosition

data class HorizonPosition(val pathId: Int, val offset: <Error class: unknown class>, val isOnRoad: Boolean, val location: <Error class: unknown class>)

The best map-matched position on the horizon. It can be either on-road or off-road. If off-road, it can be either:

HorizonResult

data class HorizonResult(val options: HorizonOptions, val snapshot: HorizonSnapshot, val position: HorizonPosition)

Output of the horizon engine, consisting of one horizon snapshot and a list of vehicle positions per each set of previously registered horizon subscription options.

HorizonSnapshot

class HorizonSnapshot(val paths: List<HorizonPath>, val state: HorizonSnapshotState, mainPathId: Int?)

Snapshot of the horizon provided by the horizon engine, based on a set of previously registered horizon subscription options. Subscription options define the extent of the paths in the horizon as well as which map attributes are collected for those paths.

HorizonSnapshotState

data class HorizonSnapshotState(val extensionCounter: Int)

State of the horizon snapshot provided by the horizon engine based on a set of previously registered horizon subscription options.

MainPathSearchOptions

data class MainPathSearchOptions(val searchTime: <Error class: unknown class> = 0.seconds, val searchDistancePolicy: PathSearchDistancePolicy)

Horizon search options for the main path. The search distance policy and the search time define the extent of the paths in the horizon.

PathSearchDistance

data class PathSearchDistance(val maxHorizonLength: <Error class: unknown class> = Distance.ZERO)

Horizon path search distance configuration. It specifies the maximum horizon length.

PathSearchDistancePolicy

interface PathSearchDistancePolicy

Interface to the path search policy. The path search policy specifies whether the horizon engine must search along the entire route or within a user-defined distance.

RouteLengthPolicy

object RouteLengthPolicy : PathSearchDistancePolicy

Main path search distance policy that is based on the route length. When this policy is enabled, the horizon engine searches along the entire route when extending the main path.

SubPathSearchOptions

data class SubPathSearchOptions(val searchTime: <Error class: unknown class> = 0.seconds, val searchDistance: PathSearchDistance = PathSearchDistance( maxHorizonLength = DEFAULT_MAX_HORIZON_LENGTH ))

Horizon search options for a sub-path level. Search distance and the search time, define the extent of the paths in the horizon.