User:Subs5/TIO update for TR UI
WME provides an ability to override the turn instructions provided during navigation so that editors can customize those instructions to better match the reality of the road.
Use a Turn Instruction Override (TIO) whenever the default Waze selected instruction is not the desired instruction for the driver. The TIO replaces the default Waze selected instruction entirely, including the TTS and instruction list.
|Don't worry about replacing existing intersection designs that currently produce the desired instruction (such as micro-doglegs and a virtual stub segment). These intersections can be updated as other changes in that intersection are required in the future.|
- 1 Principles
- 2 How to use
- 3 When not to use
- 4 When to use
- 5 Continue TIO
- 5.1 When not to use
- 5.2 When to use
- 5.2.1 Unannounced roads with legal or financial implications
- 5.2.2 Setting context in the instruction list
- 5.2.3 Supplement a wayfinder
- 5.2.4 Best continuation is not the obvious continuation
The TIO was developed for uncommon situations where Waze's default instructions could confuse the average Wazer. It was not, however, intended as a means to force an alternative instruction style on a broad scale when typical Wazers are already accustomed to and reasonably comfortable with the default style. Also, please keep in mind that it is more time-consuming to analyze and verify junctions that use TIOs. If in doubt whether to add a TIO or rely on realistic, situation-appropriate adjustments to segment geometry, one should generally prefer the geometric solution.
How to use
|Before you set a Turn Instruction Override, It is highly recommended that you consult with a State Manager or other senior editor.|
When in WME and you click on a segment and hover over a green or yellow turn connection/restriction arrow, a grey box will appear with the Voice Prompt (Turn instruction Override (TIO)), the Time-based Turn Restriction (TBTR), and Difficult turn selections. If the turn is red (restricted), then the grey box will not appear.
Click on the Voice Prompt dropdown box to select an override.
When you click on the Voice Prompt dropdown menu, you have the following choices:
|Waze Selected (default)||(this gives the default voice prompt)|
|None||No instruction is given|
|Turn left||The instruction "turn left" is given|
|Turn right||The instruction "turn right" is given|
|Keep left||The instruction "keep left" is given|
|Keep right||The instruction "keep right" is given|
|Continue||The instructio "continue" is given|
|Exit left||The instruction "exit left" is given|
|Exit right||The instruction "exit right" is given|
|U-turn||The instruction "make a U-turn" is given|
When something other than "Waze Selected" is the selected option, the Instruction override will appear in the Voice Prompt display when you hover over a green or yellow turn arrow.
Identifying on the map
- The default way to determine that a turn has an override set is to hover over the turn arrow.
- WME Toolbox helps to make identifying turns with override instructions set.
To remove a TIO, simply set the option back to Waze Selected.
When not to use
Where the improvement over the default instruction is not significant
Consistency of instructions is important both for drivers and for editors diagnosing navigation problems. Therefore, don't add a TIO merely for stylistic reasons where it doesn't significantly reduce driver confusion over the default instruction. When in doubt, keep the default instruction.
Where simple corrections in segment geometry will accomplish the desired instruction
If incorrect geometry at an intersection is causing an undesired instruction, and a change in geometry that more accuractly reflects the path drivers take through the intersection will give a desired instruction, then simply correct the geometry. This is far better than adding an override on top of incorrect geometry. Be aware of angles deliberately constructed for special purposes and make sure to preserve the functionality for which they were intended.
Override is the same as Waze selected
Do not set a TIO if the override would be the same instruction as the Waze-selected one. It just adds work for fellow editors to verify.
An "exit" instruction for common on-ramp departures from surface streets, while not immediately intuitive for many new Wazers, is nevertheless Waze's current default. Overriding this default on a large scale could lead to problems. Meanwhile, our only alternative, the "keep" instruction ("stay" in some voices), is not always significantly clearer. Except for rare cases, overriding the default "exit" instruction for on-ramps is not encouraged.
When to use
This works well for one way segments that have a u-turn only lane. You can post a "u-turn" verbal prompt on the first left turn and "None" on the second one.
Streets meeting at less than 46 degrees
Before Waze introduced override capability, editors forced turn instructions at such intersections by adding "dogleg" geometry nodes to ensure junction angles between 46° and 170° exclusive. When concerned about the display, editors added doglegs at such fine scale as to be nearly invisible; these are called "micro-doglegs". Doglegs and micro-doglegs continue to work properly and there is no present need to replace them with overrides.
Note that doglegs remain a correct and useful technique. They are completely appropriate when they reflect the typical path of drivers as they slow and stop for a turn. Even if drivers tend to approach at very sharp angles, doglegs may be used to widen the junction angle to at least 20° whether or not a TIO is used. This makes it easier for drivers to identify the turn for closure via the app, as well as for editors to select the segment when using limited mobile tools (typically to drop or raise locks by request).
Other pre-override instruction-forcing methods, especially short "segment to nowhere" stubs and deliberately incorrect alternate names, are no longer appropriate. They continue to work, however, and should be updated with care.
Depending on the length and angle of an at-grade connector, it may make sense for Waze to instruct "keep right/left" or "turn right/left". Use a TIO to ensure the most appropriate instruction is given to the driver. An example of an at-grade connector using an instruction override is shown here:
Exit leftBig Green Sign (BGS) indicating an exit left, then add the Exit Left TIO. Some exit left signage might be yellow.
Wayfinderwayfinder is a turn instruction override where an instruction would not normally be voiced. This is most often a "stay to the right" or "stay to the left." A basic example is a roadway with a split where left lanes turn left and right lanes go straight ahead.
To ensure the driver is kept on the correct side of the roadway to stay on the expected route, we create an instruction override to ensure the driver is given enough advance notice to make sure they are on the correct side.
The image here is a composite showing both turns with the override set and which instructions have been applied in this specific case. To drivers continuing straight, the app will give the instruction "stay to the right to El Cajon Blvd." To drivers getting into the on-ramp, the app will say, "turn left to I-8 W."
A complex wayfinder is one where the s-out stubs are named differently than the subsequent segments. The stubs are named for the Big Green Sign (BGS) verbiage for clarity. Before overrides, complex wayfinders used unnatural road types to force instructions, but now these wayfinders should use correct road types and alternate names on the stubs where name continuity is to be preserved, along with TIOs to force instructions. See Wayfinder for further details.
A default surface-road-to-on-ramp "exit" instruction may be overridden with a "keep" in rare cases when either of the following conditions exist:
- The originating highway's continuation path is unclear (such situations often require wayfinders as well).
- The on-ramp's initial departure continues to share direction and pavement with the originating highway, either for an unexpectedly long distance or leading to two or more subsequent distributor on-ramps that are better instructed as exits than the initial departure. The latter application avoids issuing multiple "exit" instructions for what is effectively the same on-ramp.
Aside from the above situations, overriding the default "exit" instruction for surface-road-to-on-ramp departures is not encouraged (see below).
Unlike other Waze instructions, the "Continue" instruction is informational, not instructional; it does not tell the driver to adjust course. Nevertheless, Waze will issue the "Continue" instruction as it would any other, offering multiple advance warnings and a final alert at the location of the override.
As a result, the Continue TIO is a two-edged sword. On the one hand, it is an ideal way to notify the driver of important changes to roadway circumstances. On the other, the driver may receive repeated advisories essentially to do nothing. Before adding a Continue TIO one must, therefore, evaluate several tradeoffs.
Benefits of an informational "Continue" instruction include:
- Surprise management. Alerting the driver to a potentially surprising change in roadway character (for example from a surface street to a freeway onramp) or to an unexpected and possibly problematic change in the roadway's legal/financial status;
- Counterintuitive continue confirmation. Confirming that one should continue ahead even if doing so seems to conflict with roadway, traffic, or signage cues;
- Long-haul transition notification. Advising of transitions to major roadways that the driver may be on for great distances, particularly when transitioning "up" to such roadways from less-significant routes; and
- Exit renumbering notification (controversial). Marking a change in freeway exit numbering.
Severe drawbacks, however, include:
- Instruction blocking. Suppressing a "real" navigation instruction that comes after the Continue, so that the driver receives no warning of a required maneuver until past the Continue;
- Instruction whiplash. When blocked instructions take place immediately after a Continue, the driver may be left with insufficient time to execute the blocked instruction once it issues. The Continue may even contradict signage for the blocked instruction and set the driver up to fail, for example by instructing the Continue even as the driver passes signs advising of a required exit;
- Redundancy/confusion. Confusing drivers by issuing what may appear to be an unnecessary driving instruction when the best continuation seems obvious, especially if no other course is even possible; and
- Repetition/distraction. Distracting drivers with several repetitions of a low-priority, redundant, or unactionable instruction when they would prefer to attend to other things.
The following list of use cases attempts to balance these tradeoffs. These tradeoffs may be balanced differently from region to region, so check your state's page for additional guidelines or contact your State Manager or Regional Coordinator.
In general, when in doubt, do not add a Continue TIO.
When not to use
Keep calm! Our Wazers have a memory better than a goldfish. They don't need to be reminded to Continue straight at every intersection. Wazers are already told when or how far their next turn is after every turn.
Not impactful or unsigned name changes
Keep the turn instructions useful; don't announce simple road name changes such as when a neighborhood road name changes or if the cardinal direction changes.
Similarly, some freeways are unsigned. We do not need to place TIOs when these begin or end, as they provide no value to the Wazer.
Intermediate barrier tolls
In keeping instructions useful, it would be superfluous to inform a Wazer of each and every intermediate toll barrier in a barrier-toll system.
When to use
Unannounced roads with legal or financial implications
Restricted areas (border control point, military base)
When the best continuation is to a restricted area, add a Continue TIO, paired with a named stub segment if necessary, to let users know they will be now entering a restricted area.
When the best continuation is tolled, marked or unmarked (toll roads, bridges, paid entrances into large areas, etc.), add a Continue TIO, paired with a named stub segment if necessary. For barrier-toll systems, only at the beginning of the toll area.
Setting context in the instruction list
Without a Continue TIO, the next instruction could be from an entirely different road or freeway. Adding a Continue TIO would help set the context as to where the instructions are and increase the Wazer's confidence in the instructions given (or not given).
Terminus of a freeway
When possible, do this at a point where the user can use this TIO to make a mental confirmation.
If the continuing freeway is signed before the terminus, place the TIO at the last exit, similar to how a wayfinder is set up today.
If it isn't signed, place the TIO where the freeway merges into the next freeway.Consult with your state manager if the freeway status changes frequently or gradually, or if the freeway itself is insignificant. There could be multiple options as to what would be the best spot for a TIO, or if one is needed at all.
On-ramp to a freewayrest areas) is an on-ramp to a freeway or expressway, add a continue TIO.
Continuing from an off-ramp
Use a Continue TIO when the name of the best continuation at the end of a ramp is not immediately obvious. Here are two scenarios that it's not immediately obvious:
Supplement a wayfinder
Because controlling the turn angles in Waze will never produce a continue instruction, a Continue TIO must be set in places where a wayfinder is warranted for a particular direction, but "keep" or "exit" would be misleading.
Add a continue TIO when:
- All travel lanes are correct—telling a user to "keep" or "exit" would mean an unnecessary lane change to that side of the road out of caution; or,
- Only the center lanes are correct in a 3-way fork.
Best continuation is not the obvious continuation
Many times, when there are many turn lanes, many vehicles turning, and a plethora of signage, and straight ahead doesn't look like the right way to go, the Wazer may be hesitant that Waze is not issuing an instruction. Add a continue TIO to help assure the Wazer that continuing straight is the correct way.
Use selectively, and consult your fellow area managers for consensus.