Turn-by-turn instructions

VERSION 1.5.0
PUBLIC PREVIEW

Navigation SDK for Android is only available upon request. Contact us to get started.

To use a route in a turn-by-turn navigation context, you must include selected options when creating a request. The most impactful parameters are summarized along with an example of routing options as follows:

1val amsterdam = GeoPoint(52.377956, 4.897070)
2val rotterdam = GeoPoint(51.926517, 4.462456)
3val routePlanningOptions = RoutePlanningOptions(
4 itinerary = Itinerary(origin = amsterdam, destination = rotterdam),
5 guidanceOptions = GuidanceOptions(
6 language = Locale.ENGLISH,
7 phoneticsType = InstructionPhoneticsType.Ipa,
8 extendedSections = ExtendedSections.All,
9 ),
10)

Vehicle heading

Once you are driving, it’s important to request a route that goes in a specific direction. For that purpose, the heading parameter should be used. It describes the directional heading of the vehicle, expressed in degrees starting at true North and continuing in a clockwise direction:

  • North is 0 degrees.
  • East is 90 degrees.
  • South is 180 degrees.
  • West is 270 degrees.

Instructions

To obtain guidance instructions, the guidanceOptions needs to be set.

If alternative routes are requested, instructions are generated for each route returned.

Phonetics

The phoneticsType parameter specifies whether to include the phonetic transcription of street names, signpost text, and road numbers in the instructions of the response. In areas where phonetic information is not available, the result is not returned.

Possible values are:

Extended guidance sections

The extendedSections parameter specifies whether to include sections of type lane and roadShield in the response. All other section types are always included.

Possible values are:

Next steps

Since you have learned how to work with turn-by-turn instructions, here are recommendations for the next steps: