Enhanced TIO: Difference between revisions View history

mNo edit summary
(Updated the page with more information and some of the outcomes of the discussions we've had. Still to finalize though.)
Line 1: Line 1:
'''''Note that this is a draft article. This will either need to be included in a more accessible article once this has been finalized (most likely into [[Junction Arrows]] then) or maybe it is worth being a separate article.'''''
===Turn Instruction Overrides (Turn Guidance)===  
===Turn Instruction Overrides (Turn Guidance)===  
Turn Instruction Overrides (TIO) is a feature in the [[Waze Map Editor|WME]] which allows editors to control the visible instruction and the [[Text to speak|verbal instruction]] given to the driver making that turn through a junction.
Turn Instruction Overrides (TIO) is a feature in the [[Waze Map Editor|WME]] which allows editors to control the visible instruction and the [[Text to speak|verbal instruction]] given to the driver making that turn through a junction.


This allows controlling, for each turn:
This makes it possible to override the following aspects of each turn:
 
* The text of the audible guidance of text-to-speech (TTS) voices (or to disable audible guidance)
* The display of the visual guidance, including which turn instruction you get, the displayed text, road shields and exit signs (or to disable visible guidance)
 
This capability allows generating precise instructions, better aligned with the local signalisation. As such, please avoid using [https://wazeopedia.waze.com/wiki/Global/Junction_Style_Guide/Intersections#Steep_angles_with_exits_and_keep_right_or_left micro-doglegs] (mDL) from now on. This technique, used to alter the turn instruction by modifying the angle, is no longer needed. The mDL technique sometimes causes weird user placements on the map and should therefore be avoided.
 
Instruction overrides allow us to simplify some segment names. Previously, some segments where artificially named in order to generate adequate instructions. '''Before we rename or remove these segments, the feature needs to have gone live to all clients.'''


- the text of the audible guidance (or disabling audible guidance)
Ideally, all road turns for which there are destination signs will receive a turn instruction override to use the information on those signs in the audible and visible instructions. This is a great improvement compared to the current turn instructions that only roughly give an idea of what sort of turn to take and the street name you'll be going to.


- the display of the visual guidance, including road shields and exit signs (or disabling visible guidance)
==== Road shields in turn instruction overrides ====
[[File:Turn instruction override with visual instruction with text.png|thumb|An example of the free text field being used instead of the direction field]]
To add a road shield to an instruction, you select it from a list. That list only includes road shields from streets that are currently visible on the Waze Map Editor screen. So if a shield is missing, zooming out or moving the map will show you more shields in the list. Any changes to that road shield on the street will not change the road shield used in the instruction override as the shield is duplicated. If the shield you want to add doesn't exist yet, you can temporarily create a shield on a nearby street and then use that shield in the instruction override. Don't forget to remove the shield from that street afterwards.


This capability allows generating precise instructions, better aligned with the local signalisation.
Make sure to leave the direction information field for a road shield empty. This field is present for countries that add a cardinal direction to road numbers (e.g. Route 66 North). If you want to add text like a street name behind the road shield, you should add a "Free text" field with the plus button instead.  


When adding a road shield, you have to select it from a list.  The list includes the road shields from streets visible on the WME screen, hence zooming out will show you more shields. Alternatively, you can temporarily assign a shield to a street, use that shield in the instruction, then remove the shield from the street.  
There is no practical use for drivers to get a road shield for a road number that isn't signed. As such '''we do not want to add shields for road numbers that aren't signed with the direction signs'''.  


It allows as well simplifying some segment names. Previously, some segments where artificially named in order to generate adequate instructions.  
==== Exit signs ====
[[File:Instruction Override with Exit sign example Aalter.png|thumb|An example of how we want exit instructions to look with an exit name and listed destinations]]
The instruction overrides feature also allows you to add an exit sign to the instructions. This exit sign shows the exit number in the same way as it is signed alongside the road. The name of the exit should be put as the visual instruction. A road shield may be added to these instructions, if it is signed. If destinations are listed on the advance exit sign, these may be added in the "Towards" field.


Please avoid using [https://wazeopedia.waze.com/wiki/Global/Junction_Style_Guide/Intersections#Steep_angles_with_exits_and_keep_right_or_left micro-dogleg] (mDL), a technique previously used for altering the angle Waze sees at a junction, which affects turn instructions. The mDL technique can cause an incorrect positioning of the user on the map.
As a fallback mechanism, we still want the exit ramps to have a street name as they were before (Afrit/Sortie # > destination). This is fine as the name of ramp segments is not displayed in the app or livemap. This will allow the client to still give proper instructions should we ever forget to add the instruction override.
[[Category:Draft]]

Revision as of 23:54, 26 May 2021

Note that this is a draft article. This will either need to be included in a more accessible article once this has been finalized (most likely into Junction Arrows then) or maybe it is worth being a separate article.

Turn Instruction Overrides (Turn Guidance)

Turn Instruction Overrides (TIO) is a feature in the WME which allows editors to control the visible instruction and the verbal instruction given to the driver making that turn through a junction.

This makes it possible to override the following aspects of each turn:

  • The text of the audible guidance of text-to-speech (TTS) voices (or to disable audible guidance)
  • The display of the visual guidance, including which turn instruction you get, the displayed text, road shields and exit signs (or to disable visible guidance)

This capability allows generating precise instructions, better aligned with the local signalisation. As such, please avoid using micro-doglegs (mDL) from now on. This technique, used to alter the turn instruction by modifying the angle, is no longer needed. The mDL technique sometimes causes weird user placements on the map and should therefore be avoided.

Instruction overrides allow us to simplify some segment names. Previously, some segments where artificially named in order to generate adequate instructions. Before we rename or remove these segments, the feature needs to have gone live to all clients.

Ideally, all road turns for which there are destination signs will receive a turn instruction override to use the information on those signs in the audible and visible instructions. This is a great improvement compared to the current turn instructions that only roughly give an idea of what sort of turn to take and the street name you'll be going to.

Road shields in turn instruction overrides

An example of the free text field being used instead of the direction field

To add a road shield to an instruction, you select it from a list. That list only includes road shields from streets that are currently visible on the Waze Map Editor screen. So if a shield is missing, zooming out or moving the map will show you more shields in the list. Any changes to that road shield on the street will not change the road shield used in the instruction override as the shield is duplicated. If the shield you want to add doesn't exist yet, you can temporarily create a shield on a nearby street and then use that shield in the instruction override. Don't forget to remove the shield from that street afterwards.

Make sure to leave the direction information field for a road shield empty. This field is present for countries that add a cardinal direction to road numbers (e.g. Route 66 North). If you want to add text like a street name behind the road shield, you should add a "Free text" field with the plus button instead.

There is no practical use for drivers to get a road shield for a road number that isn't signed. As such we do not want to add shields for road numbers that aren't signed with the direction signs.

Exit signs

An example of how we want exit instructions to look with an exit name and listed destinations

The instruction overrides feature also allows you to add an exit sign to the instructions. This exit sign shows the exit number in the same way as it is signed alongside the road. The name of the exit should be put as the visual instruction. A road shield may be added to these instructions, if it is signed. If destinations are listed on the advance exit sign, these may be added in the "Towards" field.

As a fallback mechanism, we still want the exit ramps to have a street name as they were before (Afrit/Sortie # > destination). This is fine as the name of ramp segments is not displayed in the app or livemap. This will allow the client to still give proper instructions should we ever forget to add the instruction override.