Turn Instructions

A turn instruction is the combination of text, images, and speech that Waze provides to the user in providing route guidance, ideally with minimal thought and without confusion.

This page covers the topic of turn instructions generally and includes guidance for modifying all editable aspects of a turn instruction - but not lane guidance.

Overview

Turn instructions tell and show a user where and when to turn, keep, exit, continue, or make a U turn. Editors must take special care to ensure that turn instructions give Wazers clear and useful directions.

By default, a turn instruction will use the street name of the outbound segment for both display and spoken directions. If there is a road shield associated with the primary street name on that outbound segment and that street name is simple and contains the same number as the shield then the turn instruction will display the shield in place of the street name.

Editors can customize turn instructions with road shields, destinations, exit numbers, and more. this enhances the Waze experience and is encouraged.

General principles

Turn instructions should match signage as closely as possible within the limitations of the Waze interface, while remaining sensible.

Visually, the elements of the turn instruction should match the visual order of elements on the sign as closely as possible.

Custom turn instructions should be added any time signage for a particular turn includes more than just the primary street name (or associated shield) of the outbound segment. In particular, custom turn instructions should be added:

• for any numbered exit;
• anywhere a shield is desired but won't be automatically displayed; and
• anywhere else that directional signage shows something other than the primary name (or shield) of the outbound segment such as most exit ramps and onramps, wayfinders, intersections with specialized signage for a turn.

Here are examples of those use cases.

• 

  An exit and wayfinder on Autoroute 40 Ouest in Montreal.

• 

  Turn instructions on a major road in Montreal.

• 

  Turn instructions and a wayfinder on a major road in Montreal. Adding a wayfinder in this case is not recommended, but the turns should be implemented with turn instructions that indicate the cardinal direction.

A good rule of thumb to use is that if there is a big green sign (BGS), then there should be a turn instruction. But that is not an absolute rule.

How to do this

To access the Turn Instructions dialogue, hover your cursor over a turn arrow and click on "Add instructions".

Basic layout

As stated, the goal is to resemble the road signage as much as possible, but the functionality has limitations such as a lack of horizontal display space and a restriction to two lines of information (plus an exit sign).

The best practice is therefore to use the top "Visual instructions" line of the turn instructions for road shields (if there are any) and to put any text below that separated by forward slashes in a "Free text" box in the "Towards" field. The top of the interface displays what the turn instruction will look like in the app. You can see this in action here:

If there are no road shields for a turn instruction, place the first line of text in the "Visual instructions" line with a "Free text" box and put any subsequent text in a "Free text" box in the Towards field, as follows:

Exit signs

If the turn instruction is for an exit, choose the colour of exit polygon appropriate for the accompanying sign. Note that the colour of the polygon is not necessarily the same as the colour of the sign. In the examples from Quebec on this page, the sign is green but the exit polygon is yellow, and so these turn instructions in Quebec use a yellow polygon.

The exit polygon is always displayed in the top right corner of the turn instruction panel.

To use an exit polygon in a turn instruction, choose the correct colour and add the exit number in the box to your choice.

Do not use an exit polygon to indicate the voice prompt for a turn direction such as "keep right", "exit right", etc. The exit polygon is purely a visual effect.

Voice prompt

This is the same option that Waze editors can use in the dialogue box for turns in the WME. You may change it there or in the Turn instructions dialogue. It is an identical choice and will be duplicated from one to the other.

TTS

TTS stands for "text to speech".

If you make no changes here, Waze will speak the default turn instructions. There is rarely a reason to override the default instructions.

What to watch out for

"Towards" field

The "Towards" field is simply the name of the field. It does not add any visual representation of the word "towards" and it does not pronounce the word "towards".

If you require the pronunciation of "towards" in your TTS, please use a guillemet, which is the French quotation mark: »

Towards" field does not pronounce "towards" can use a guillemet for that but no real reason to.

create road shield - no US possible - zoom in and out, creat a temporary segment, put a shield on an existing segment - doesn't need to survive, just to create a shield.

modifiable directions for shields which allows...Small caps

TTS and punctuation and accuracy of sign. squished for space so needs to be as short as possible and that means no punctuation

....

Compass directions should be spelled out using large-and-small-caps (Nᴏʀᴛʜ, Sᴏᴜᴛʜ, Eᴀꜱᴛ, Wᴇꜱᴛ) when they are used to represent a direction of travel.

The word "to" should be included in visual fields if and only if it is actually present on signage.

The auxiliary legends "to", "via", and "jct", where present on signage, should be capitalized using small caps if they are capitalized on the sign (ᴛᴏ, ᴠɪᴀ, ᴊᴄᴛ), and should match the case on the sign if in title case (To, Via, Jct) or lowercase (to, via, jct).

To insert large-and-small-capitals or small capitals as needed:

• You can copy and paste the large and small capitals from this list: Modèle:Nowrapcode Modèle:Nowrapcode Modèle:Nowrapcode Modèle:Nowrapcode Modèle:Nowrapcode Modèle:Nowrapcode Modèle:Nowrapcode.
• If you are a macOS user, you may wish to set up automatic text substitutions in the Text tab of the Keyboard pane in System Preferences.
• If you are a Windows user, you may wish to use AutoHotkey.
• The script WME Road Shield Helper can insert these easily.

Although the large and small caps above render somewhat strangely on the web, and especially in the fixed-width copy-paste boxes, rest assured: they look good in the app.

Guidance

Exit signs

Use the right exit sign if the exit is to the right of continuing lanes, or the left exit sign if the exit is to the left of continuing lanes.

We’ve requested exit sign options without an arrow, which will be useful in cases where (we hope) inheritance will take you down an "exit right, then keep left" path or similar. For the time being, [don’t add turn instructions yet at all/add the one that fits best and leave yourself a map comment or other note to come back].

Type the exit number into the field as it appears on the sign (numbers, letters, with or without spaces and hyphens; but remove spaces if necessary to fit within the character limit).

Visual instructions and toward

The “Visual instructions” and “Toward” components contain most of the visual elements of a turn instruction, including road names, shields, control cities, and other destinations (but not exit numbers).

Think of the “Visual instructions” field as line 1 of the visual instruction, and of the “Toward” field as line 2 of the visual instruction.

Exit ramps, entrance ramps, wayfinders, and where there is a Big Green Sign

This subsection applies to all instructions onto, off of, or between freeways, exit ramps, onramps, or similar, and wherever there is a Big Green Sign.

The principal goal of mapping turn instructions is to match the layout of any Big Green Sign as best we can, and to match non-BGS signage in a consistent way.

Which signs to use

Where there is a Big Green Sign assembly for the movement you're mapping (like a typical freeway exit sign), use information from the last Big Green Sign assembly before or at the location of the movement.

Where there is not a Big Green Sign (which is often the case at the foot of an exit ramp or before entering an onramp), combine shield elements from the Directional Assembly and text elements from the Destination Sign [see pages 149-165 of MUTCD 2009 edition].

Shields

Guidance	Example
Generally, shield elements should be placed in the “visual instructions” field (i.e., on line 1).
Rarely, shield elements may be placed in the “toward” field (i.e., on line 2) only when the shield is near the bottom of a multi-line sign.
Add shields in the order they appear on the sign assembly.
Any shield that is preceded by “ᴛᴏ” on the sign should be preceded by “ᴛᴏ” (using small caps) in free text in Waze as well.
If two or more adjacent shields have the same direction, omit the direction from all but the last such shield (they “share” this direction)—unless there is a compelling reason not to do so.
Do not include text separators between shields, shield directions, or auxiliary legends (“ᴛᴏ”, “ᴠɪᴀ”, “ᴊᴄᴛ”).

Text elements (street names and destinations)

If there are no shields

Guidance	Example
If the instruction contains only one text element (and no shields), include that text element as free text in the "visual instructions" field.
If the instruction contains two text elements, include the first text element as free text in the "visual instructions" field, and the second text element in the "toward" field.
If the instruction contains three text elements, include the first text element as free text in the "visual instructions" field, and the second and third text elements in the "toward" field with the appropriate separator.
If the instruction contains four or more text elements, use your judgment, and spread them between "visual instructions" and "toward" as appropriate with the proper separators.

In conjunction with shields

Guidance	Example
If the instruction (in addition to shields) contains only one text element, place the text element in the "toward" field (except in the rare instance that the shield and text are on the same line on the same sign, in which case the text element can be added as free text in the "visual instructions" field).
If the instruction (in addition to shields) contains two or more text elements, generally, place all text elements in the "toward" field with the appropriate separators. Exception: if the first text element(s) in order, but not all of the text elements, are alternative names for the shielded road, add the first text element(s) as free text following the shield (with separators if there are more than one), and the subsequent text element(s) in the "toward" field.	In this case, "Airline Dr" and "Tulane Ave" are alternate names for US-61.

Surface intersections

This subsection applies to instructions at intersections that do not involve freeways, exit ramps, or onramps, and that do not have a Big Green Sign.

The principal goal of mapping turn instructions is to match signage in a consistent way.

If the only signage visible when approaching the intersection matches the primary street name of the outbound segment, there is no need to change the turn instructions.

If signage visible when approaching the intersection contains either additional or different information,

• Shields and road names should generally be in the “Visual instructions” field, with shields before the road name.

• If both shields and a road name are present, omit the direction (even if signage includes the direction).
• If only road shields are present, include the direction when signage includes the direction.
• Include any destinations and control cities in the “Toward” field (with appropriate separators).

Where a shield is used (often with a “ᴛᴏ” auxiliary legend) to show that the immediate turn will take you toward another road or highway, you can include that shield in the “Toward” field (together with any auxiliary legend present). Such signage may often be found on frontage roads that provide freeway access.

Voice prompt

See Voice prompt.

TTS

The TTS box can be used to override the street name component of the instruction.

Follow the same general principles as with road names. Abbreviations and acronyms work here, but you can also use this field to spell things out to be sure they are pronounced correctly.

Feel free to make small adjustments to make Waze talk conversationally. For example, add “the” before the name of a destination that would normally be preceded by “the” (e.g., “Poydras St » the Superdome” or “US-90 BUS W » the Westbank”)

Interface

[more to come. watch this space!]