createDynamicGuidanceEngine

Creates a DynamicGuidanceEngine.

DynamicGuidanceEngine generates dynamic com.tomtom.sdk.navigation.guidance.Guidance for the com.tomtom.sdk.common.route.instruction.Instructions supplied within com.tomtom.sdk.navigation.NavigationSnapshot.activeRoute.

To generate dynamic com.tomtom.sdk.navigation.guidance.Guidance, DynamicGuidanceEngine takes various parameters into account. These parameters include, but are not limited to:

  • Distance to the next maneuver

  • Current speed of the vehicle

  • Free-flow speed of the road between the current position and the next maneuver

  • Traffic situation ahead

So, unlike StaticGuidanceEngine, DynamicGuidanceEngine does not depend on com.tomtom.sdk.common.route.Announcement information that may or may not be included in the com.tomtom.sdk.common.route.instruction.Instruction. It continuously checks the active route progress to provide up-to-date Guidance information. Once the vehicle reaches an announcement point, the generated Guidance includes the (GuidanceAnnouncement) to be announced.

Another difference between DynamicGuidanceEngine and StaticGuidanceEngine is that DynamicGuidanceEngine uses TomTom's advanced verbal instruction messages to synthesize GuidanceAnnouncements dynamically on the fly. Note that the set of supported languages may differ between different GuidanceEngines.

DynamicGuidanceEngine can be used to provide turn-by-turn navigation with any routing client (offline, online with com.tomtom.sdk.routing.common.options.guidance.GuidanceOptions.guidanceVersion v1 or v2).

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

See also

Parameters

context

Android context.

options

GuidanceEngineOptions used to configure guidance engine.