Interactive junction instruction algorithm: Difference between revisions Discussion View history

(added TIO stuff in intro)
mNo edit summary
Line 7: Line 7:
* This page discusses the instruction which will be provided (or not provided) by the Waze server when traveling from one segment, through a [[Glossary#Junction_or_Junction_Point|junction]], and onto a second segment.
* This page discusses the instruction which will be provided (or not provided) by the Waze server when traveling from one segment, through a [[Glossary#Junction_or_Junction_Point|junction]], and onto a second segment.
* How [[How_Waze_determines_turn_/_keep_/_exit_maneuvers#Best Continuation|''best continuations'']] work. Any time the destination segment is the ''best continuation'' no instruction will be provided by default.
* How [[How_Waze_determines_turn_/_keep_/_exit_maneuvers#Best Continuation|''best continuations'']] work. Any time the destination segment is the ''best continuation'' no instruction will be provided by default.
* The lack of an instruction to the best continuation, as well as other default behaviors, can be overridden by the use of [[Turn instruction override|turn instruction overrides]].
* The lack of an instruction to the best continuation, as well as other default behaviors, can be overridden by the use of [[turn instruction override]]s.


While the illustrations displayed by each question may not represent every possible variation, they do represent the difference between the two options in that question. Please choose the most appropriate answer.
While the illustrations displayed by each question may not represent every possible variation, they do represent the difference between the two options in that question. Please choose the most appropriate answer.

Revision as of 17:49, 19 February 2018

This is a clickable interactive guide to determine what instruction, if any, will be given at the junction between any 2 segments.

A text version of this information is available here.

Introduction

Understanding how and which instructions are provided requires first understanding a few concepts.

  • This page discusses the instruction which will be provided (or not provided) by the Waze server when traveling from one segment, through a junction, and onto a second segment.
  • How best continuations work. Any time the destination segment is the best continuation no instruction will be provided by default.
  • The lack of an instruction to the best continuation, as well as other default behaviors, can be overridden by the use of turn instruction overrides.

While the illustrations displayed by each question may not represent every possible variation, they do represent the difference between the two options in that question. Please choose the most appropriate answer.

Definitions

  • Origin: The segment you are on before going through the junction, in other words the segment you are coming from will be referred to as the origin, and corresponds to s-in in the the algorithm text provided by Waze staff.
    • In terms of navigation, the segment you are being routed from is the origin.
  • Destination: The segment you will be on after the junction, in other words the segment you are going to will be referred to as the destination, and corresponds to s-out in the the algorithm text provided by Waze staff.
    • In terms of navigation, the segment you are being routed on to is the destination.
  • Branch: Any segments other than the destination which leave the junction at an angle less than 45.04° will be referred to as other branches, and corresponds to s-N, or s-1,2,3,4... in the the algorithm text provided by Waze staff.
  • Overlapping: When the beginning portion two segments are directly on top of each other, meaning they both leave the junction at the exact same angle as each other, they will be referred to as overlapping segments.
  • Highway: Any road typed in Waze as a  Freeway ,  Major Highway , or  Minor Highway , will be referred to in this page as a highway.
  • Turn angle: The turn angle is the angle from the origin to the destination. A perfectly straight road with a junction in the middle would have a turn angle of 0°. The angle then gets wider as you turn to either side. A perfect left or right turn would be 90°. A U-turn at a junction between two segments would represent a 180° turn.
Turn Angles
Standard turn angle 37° angle 90° dogleg
  • No-name segments: A segment with no name (the "none" check-box for street name is checked) is considered to have "no-name" as a name for the Best Continuation algorithm. So two segments with no name, will be considered to have identical names, even if they would inherit different names for TTS.
  • Roundabout angle: The roundabout angle is the angle of any segment connected to the roundabout from the perspective of the origin. The actual turn angle of the segments is irrelevant.
    To explain;
    • Draw an imaginary line straight through the roundabout to the other side of the roundabout from junction node where the origin joins the roundabout. This will represent a 0° roundabout angle, any deviation to the right or left will increase the angle.
    • Draw another imaginary line across the roundabout exactly perpendicular to the first imaginary line. This will represent a 90° roundabout angle to either side.
    • For more info see the roundabouts page
Roundabouts
Normal Non-Normal

All other segments are within the allowed ±15° from either 0° or 90°. Not all other segments are within the allowed ±15° from either 0° or 90°.

Directions

To use this interactive flowchart;

  • Start with the first question in the interactive algorithm.
  • Click on the appropriate answer which best matches your situation. A new question will jump to the top of the screen
  • Continue answering the questions until an instruction is displayed at the top of the screen.
  • This is the instruction that the Waze server should give when transversing this junction between the two segments you described as the origin and the destination.
As of September 2014 This algorithm was changed to also factor in alternate names. This algorithm is still correct when none of the segments have alternate names. If there are alternate names on any of the segments there are a few modifications (in bold).
  • The order of preference for Best Continuation is;
  1. Primary name + Type match
  2. Alt name + Type match
  3. Primary name match, OR Primary name <=> Alt name Cross-match
  4. Alt name match
  5. Type match
  • City names have no affect on matches.

A Cross-match is when the primary name of one segment is identical to the alternate name of an adjacent segment. It had the same priory as a Primary name match.

  • In order for a Cross match to work there must be at least one alt name on both involved segments (even though they don't necessarily match each other).
  • It will work even if the are no Primary names on those segments.
  • It will not work if all three segments at a split have a matching Primary name or a matching Alternate name.

An Alt match is when two adjacent segments have an identical alternate name (regardless of city name).

  • It will not work if all three segments at a split have a matching Primary name.
  • It will work even the OUT segment (the one leaving the split) has no Primary name.
Bring up comments or questions on this page in this forum .
~PesachZ (PM [Help])  

The interactive algorithm

(31)

Is voice prompt set to Waze Selected?


YES


NO: A turn instruction override is set. See the navigation instructions



(30)

Is the turn angle from the origin to the the destination greater than 170°?


YES => Make a U-turn


NO



(01)

Other than the origin and the destination, are there any other segments connected to this junction?


intersection At Grade Connector At Grade Connector

YES


dead end cul-de-sac dead end continue junction turn junction


NO => No instruction



(19)

Do the origin and the destination meet at a roundabout?


Round about street round about MH mH round about ramps

YES


intersection bowtie

NO



(02)

Is the turn angle from the origin to the destination between 45.14° and 150°?


YES


NO, the turn angle is less 45.04°


NO, the turn angle is greater than 150°
Speculation note: This is unconfirmed Turns with angles greater than 150° will follow the same instruction path as 45.14°-150°, but the Waze routing server will penalize this turn, and avoid routing through it.



(03)

Which direction is the turn?


Left => Turn left


Right => Turn right



(04)

Are there any other branches with unrestricted turns from the origin?


YES


NO => No instruction



(13)

Is there more than one (1) other branch?


YES


NO



(14)

Are the two branches (the destination and the other branch) overlapping?


YES => No instruction


NO



(05)

Is the name of the origin and the destination identical?


YES


NO



(06)

Are the origin and the destination the same road type?


YES


NO



(07)

Are both the name AND the road type of any of the other branches identical to the origin?


YES


NO => No instruction



(08)

Is there any other branch to the left of the destination branch?


YES


NO



(20)

Is this an overlapping segment, is it overlapped by any other branch?


YES


NO



(25)

Are the segments in a right hand traffic country (such as the USA)?


YES


NO => Keep/stay right



(21)

Is the origin a highway? ( Freeway ,  Major Highway , or  Minor Highway )


YES


NO



(22)

Is the destination a highway? ( Freeway ,  Major Highway , or  Minor Highway )


YES => Keep/stay left


NO => Exit left



(23)

Is the origin a  Ramp ?


YES


NO => Keep/stay left



(24)

Is the destination a highway ( Freeway ,  Major Highway , or  Minor Highway ), or a  Ramp ?


YES => Keep/stay left


NO => Exit left



(09)

Is the name of any of the other branches identical to the origin?


YES


NO => No instruction



(10)

Are the origin and the destination the same road type?


YES


NO



(11)

Is the name of any of the other branches identical to the origin?


YES


NO



(12)

Is the road type of any of the other branches identical to the origin?


YES


NO => No instruction



(26)

Are the segments in a left hand traffic country (like the UK)?


YES


NO => Keep/stay left



(15)

Is the origin a highway? ( Freeway ,  Major Highway , or  Minor Highway )


YES


NO



(16)

Is the destination a highway? ( Freeway ,  Major Highway , or  Minor Highway )


YES => Keep/stay right


NO => Exit right



(17)

Is the origin a  Ramp ?

YES


NO => Keep/stay right



(18)

Is the destination a highway ( Freeway ,  Major Highway , or  Minor Highway ), or a  Ramp ?


YES => Keep/stay right


NO => Exit right



(27)

Are there five (5) or more segments (junctions) connected to the roundabout?

more than 4 nodes not normal angles more than 4 nodes

YES => At the roundabout take the #xx exit


4 nodes

NO



(28)

From the perspective of the origin, are the roundabout angles to all the other segments between 0°-15°, or 75°-105°?


YES


NO => At the roundabout take the #xx exit



(29)

What direction is the destination relative to the origin?


Left => At the roundabout turn left


Straight => At the roundabout continue straight


Right => At the roundabout turn right


U Turn, Back => At the roundabout make a U-turn



The navigation instructions

No instruction

There will be no instruction given passing through this junction. This can be caused by the best continuation or certain cases with an overlapping segment. It may also be set using the turn instruction override None.






Continue straight

This must be manually set by the turn instruction override Continue and is never automatically selected.

Displayed Icons
Livemap
& WME
Client App






Turn right

This may be manually set by a turn instruction override.

Displayed Icons
Livemap
& WME
Client App







Keep/stay right

This may be manually set by the turn instruction override Keep right.

Displayed Icons
Livemap
& WME
Client App







Exit right

This may be manually set by a turn instruction override and is never automatically selected in left hand traffic countries.

Displayed Icons
Livemap
& WME
Client App







Turn left

This may be manually set by a turn instruction override.

Displayed Icons
Livemap
& WME
Client App







Keep/stay left

This may be manually set by the turn instruction override Keep left.

Displayed Icons
Livemap
& WME
Client App







Exit left

This may be manually set by a turn instruction override and is never automatically selected in right hand traffic countries.

Displayed Icons
Livemap
& WME
Client App






At the roundabout take the #xx exit

The "#xx" will be 1st, 2nd, 3rd, etc.. The counting starts from the origin.


Displayed Icons
Livemap
& WME
Client App

NOTE: In the client app there will be a digit inside the circle representing which number exit you must take (starting from the origin).

If the roundabout is not formed correctly (more than one entering/exiting segment connected to same roundabout node), you may get an instruction "at the roundabout, exit number 0" with a partial verbal instruction.







At the roundabout turn left

Displayed Icons
Livemap
& WME
Client App








At the roundabout turn right

Displayed Icons
Livemap
& WME
Client App







At the roundabout continue straight

Displayed Icons
Livemap
& WME
Client App







At the roundabout make a U-turn

Displayed Icons
Livemap
& WME
Client App

NOTE: Currently this is only displayed in the client, but there is no verbal instruction (due to a bug).







Make a U-turn

This may be manually set by the turn instruction override U-turn.

Displayed Icons
Livemap
& WME
Client App
























this space intentionally left blank