MainPathSearchOptions

constructor(searchTime: Duration = DEFAULT_MAIN_PATH_SEARCH_TIME, searchDistancePolicy: PathSearchDistancePolicy = ExplicitDistancePolicy( searchDistance = PathSearchDistance( maxHorizonLength = DEFAULT_MAIN_PATH_MAX_HORIZON_LENGTH, ), ), minDistanceAhead: Distance)

Horizon search options for the main path.

These options specify the search distance policy and the search time for the main path. The main path is the path the user currently follows, extending along the most likely trajectory. The search distance policy and the search time define the extent of the main path.

To specify horizon options for the main path, create an instance of this class:

val mainPathSearchOptions = MainPathSearchOptions(
searchTime = 10.minutes,
searchDistancePolicy = ExplicitDistancePolicy(
searchDistance = PathSearchDistance(
maxHorizonLength = Distance.kilometers(5)
)
)
)

For more information on horizon paths see HorizonEngine.

For more information on horizon options see HorizonOptions.

The search distance policy determines whether the horizon engine must search along the entire route (see RouteLengthPolicy) or within an explicitly specified distance (see ExplicitDistancePolicy).

The main path will be extended until search time and search distance have both reached their limits.

Important: This is a Public Preview API. It may be changed or removed at any time.

Throws

if one of the following occurs:

  • searchTime is negative.

  • minDistanceAhead is negative.


constructor(searchTime: Duration = DEFAULT_MAIN_PATH_SEARCH_TIME, searchDistancePolicy: PathSearchDistancePolicy = ExplicitDistancePolicy( searchDistance = PathSearchDistance( maxHorizonLength = DEFAULT_MAIN_PATH_MAX_HORIZON_LENGTH, ), ))