View source for Interactive junction instruction algorithm View history

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

There will eventually be encyclopedia style illustrations for the various configurations to visually describe the setup. This will formatted as a sequence flow through, to cover (hopefully) all variations.

== Introduction ==
Understanding how and which instructions are provided requires first understanding a few concepts.
* This page is discussing the instruction which will be provided by the Waze server (or not provided) when traveling from one segment, through a [[Glossary#Junction_or_Junction_Point|junction]], and onto a second segment.
* How [[User:PesachZ/algorithm#Best Continuation|''Best Continuations'']] work. Any time the destination segment is the ''Best Continuation'' there will not be an instruction provided.

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 ==
* 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 [[User:PesachZ/algorithm#Definitions|''s-in'']] in the [[User:PesachZ/algorithm#The_algorithm_.2F_list_of_conditions|the algorithm text provided by Waze staff]].
** In terms of navigation, the segment you are being routed <u>from</u> is '''''the origin'''''.
* 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 [[User:PesachZ/algorithm#Definitions|''s-out'']] in the [[User:PesachZ/algorithm#The_algorithm_.2F_list_of_conditions|the algorithm text provided by Waze staff]].
** In terms of navigation, the segment you are being routed <u>on to</u> is '''''the destination'''''.
* Any segments other ''the destination'' which leave the junction at an angle less than 44° will be referred to as '''''other branches''''', and corresponds to [[User:PesachZ/algorithm#Definitions|''s-N'', or ''s-1,2,3,4...'']] in the [[User:PesachZ/algorithm#The_algorithm_.2F_list_o,f_conditions|the algorithm text provided by Waze staff]].
* 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 an '''''overlapping segment'''''.
* Any road typed in Waze as a {{Freeway}}, {{Major Highway}}, or {{Minor Highway}}, will be referred to in this page as a '''[[Road_types/USA#Highways|highway]]'''.
* 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 is 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.
{{NeedInfo|insert turn angle diagram, and illustrations (after determining the absolute threshold between keep and turn instructions in testing now)}}
* 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.<br>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/USA#Understanding_navigation_instructions|roundabouts page]]
[[File:Roundabout 4.jpg|framed|center]]

== Directions ==
To use this interactive flowchart;
:* Start with the [[#01|first question]] in [[#The_interactive_algorithm|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 [[#The_instructions|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''.


== The interactive algorithm ==
(01)

{{anchor|01}}Other than ''the origin'' and ''the destination'', are there any other segments connected to this junction?


[[File:Jct 4 90.png|border|x100px|frameless|intersection]] [[File:Jct at grade keep.png|border|x100px|At Grade Connector]] [[File:Turn right AGC no arrow.JPG|border|x100px|At Grade Connector]]

{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#19|YES]]'''
|}


[[File:Jct dead end ex.png|border|100px|dead end]] 
[[File:Jct cul-de-sac island ex road.png|border|100px|cul-de-sac dead end]] [[File:Jct transition.png|border|x100px|continue junction]] 
[[File:Jct transition 90.png|border|x100px|turn junction]] 


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#No_Instruction|NO => No Instruction]]
|}


----
(19)

{{anchor|19}}Are ''the origin'' or ''the destination'' part of a [[Roundabouts/USA|Roundabout]]?


[[File:FixRAB-07.png|border|100px|frameless|Round about street]] 
[[File:RdAbt MjMj.png|border|100px|frameless|round about MH mH]] 
[[File:Roundabout - all ramps.png|border|100px|frameless|round about ramps]]

{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#27|YES]]'''
|} 


[[File:Jct 4 90.png|border|x100px|frameless|intersection]] 
[[File:Jct bowtie.png|border|x100px|frameless|bowtie]]

{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#02|NO]]'''
|} 


----
(02)

{{anchor|02}}Is the turn angle from ''the origin'' to ''the destination'' between 44.5° and 135°?


[[File:Turn left angle.png|border|100px|frameless]] 
[[File:Turn left agc.png|border|100px|frameless]] 
[[File:Turn right.png|border|100px|frameless]]

{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#03|YES]]'''
|} 


[[File:Keep left ps to ps bc.png|border|100px|frameless]] [[File:Keep right ps to ramp.png|border|100px|frameless]] [[File:Exit right ramp to ramp.png|border|100px|frameless]] 
[[File:Exit left ramp to ramp.png|border|100px|frameless]]

{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#04|NO, the turn angle is less 44.5°]]'''
|} 


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lightgray" | '''[[#03|{{red|NO, the turn angle is greater than 135°}}]]'''
|}

:'''NOTE:''' Turns with angles greater than 135° will follow the same instruction path as [[#03|44.5°-135°]], but the Waze routing server will penalize this turn, and avoid routing through it.


----
(03)

{{anchor|03}}Which direction is the turn?


[[File:Turn left angle.png|border|100px|frameless]] 
[[File:Turn left agc.png|border|100px|frameless]] 

{| border="1" cellpadding="10"
|-
! scope="col" | '''[[#Turn_Left|Left => Turn Left]]'''
|}


[[File:Turn right.png|border|100px|frameless]]
{| border="1" cellpadding="10"
|-
! scope="col" | '''[[#Turn_Right|Right => Turn Right]]'''
|} 


----
(04)

{{anchor|04}}Are there any other ''branches'' with unrestricted turns from ''the origin''?


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#13|YES]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | ''' [[#No_Instruction|NO => No Instruction]]'''
|} 


----
(13)

{{anchor|13}}Is there more than one (1) ''other branch''?


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#05|YES]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#14|NO]]'''
|}


----
(14)

{{anchor|14}}Are the two branches (''the destination'' and the ''other branch'') ''overlapping''?


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#No_Instruction|YES => No Instruction]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#05|NO]]'''
|}


----
(05)

{{anchor|05}}Is the name of ''the origin'' and ''the destination'' identical?


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#06|YES]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#10|NO]]'''
|}


----
(06)

{{anchor|06}}Are ''the origin'' and ''the destination'' the same road type?


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#07|YES]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#09|NO]]'''
|}


----
(07)

{{anchor|07}}Are both the name AND the road type of any of the ''other branches'' identical to ''the origin''?


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#08|YES]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#No_Instruction|NO => No Instruction]]'''
|}


----
(08)

{{anchor|08}}Is there any ''other branch'' to the left of this branch?


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#26|YES]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#20|NO]]'''
|}


----
(20)

{{anchor|20}}Is this an ''overlapping segment'', is it overlapped by any ''other branch''?


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#26|YES]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#25|NO]]'''
|}


----
(25)

{{anchor|25}}Are the segments in a [[RHT|right hand traffic]] country (such as the USA)?


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#Keep.2FStay_Left|YES => Keep/Stay Left]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#21|NO]]'''
|}


----
(21)

{{anchor|21}}Is ''the origin'' a [[Road_types/USA#Highways|highway]]? ({{Freeway}}, {{Major Highway}}, or {{Minor Highway}})


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#22|YES]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#23|NO]]'''
|}


----
(22)

{{anchor|22}}Is ''the destination'' a [[Road_types/USA#Highways|highway]]? ({{Freeway}}, {{Major Highway}}, or {{Minor Highway}})


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#Keep.2FStay_Left|YES => Keep/Stay Left]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#Exit_Left|NO => Exit Left]]'''
|}


----
(23)

{{anchor|23}}Is ''the origin'' a {{ramp}}?


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#24|YES]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#Keep.2FStay_Left|NO => Keep/Stay Left]]'''
|}


----
(24)

{{anchor|24}}Is ''the destination'' a [[Road_types/USA#Highways|highway]] ({{Freeway}}, {{Major Highway}}, or {{Minor Highway}}), or a {{ramp}}?


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#Keep.2FStay_Left|YES => Keep/Stay Left]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#Exit_Left|NO => Exit Left]]'''
|}


----
(09)

{{anchor|09}}Is the name of any of the ''other branches'' identical to ''the origin''?


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#08|YES]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#No_Instruction|NO => No Instruction]]'''
|}


----
(10)

{{anchor|10}}Are ''the origin'' and ''the destination'' the same road type?


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#11|YES]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#08|NO]]'''
|}


----
(11)

{{anchor|11}}Is the name of any of the ''other branches'' identical to ''the origin''?


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#08|YES]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#12|NO]]'''
|}


----
(12)

{{anchor|12}}Is the road type of any of the ''other branches'' identical to ''the origin''?


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#08|YES]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#No_Instruction|NO => No Instruction]]'''
|}


----
(26)

{{anchor|26}}Are the segments in a [[LHT|left hand traffic]] country (like the UK)?


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#Keep.2FStay_Right|YES => Keep/Stay Right]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#15|NO]]'''
|}


----
(15)

{{anchor|15}}Is ''the origin'' a [[Road_types/USA#Highways|highway]]? ({{Freeway}}, {{Major Highway}}, or {{Minor Highway}})


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#16|YES]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#17|NO]]'''
|}


----
(16)

{{anchor|16}}Is ''the destination'' a [[Road_types/USA#Highways|highway]]? ({{Freeway}}, {{Major Highway}}, or {{Minor Highway}})


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#Keep.2FStay_Right|YES => Keep/Stay Right]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#Exit_Right|NO => Exit Right]]'''
|}



----
(17)

{{anchor|17}}Is ''the origin'' a {{ramp}}?

{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#18|YES]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#Keep.2FStay_Right|NO => Keep/Stay Right]]'''
|}


----
(18)

{{anchor|18}}Is ''the destination'' a [[Road_types/USA#Highways|highway]] ({{Freeway}}, {{Major Highway}}, or {{Minor Highway}}), or a {{ramp}}?


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#Keep.2FStay_Right|YES => Keep/Stay Right]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#Exit_Right|NO => Exit Right]]'''
|}


----
(27)

{{anchor|27}}Are there five (5) or more segments ([[Glossary#Junction|junctions]]) connected to the roundabout?


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#At the Roundabout Take the #xx Exit|YES => At the Roundabout Take the #xx Exit]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#28|NO]]'''
|}


----
(28)

{{anchor|28}}From the perspective of ''the origin'', are the ''roundabout angles'' to all the other segments between 0°-15°, or 75°-105°?


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="lawngreen" | '''[[#29|YES]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" bgcolor="orangered" | '''[[#At the Roundabout Take the #xx Exit|NO => At the Roundabout Take the #xx Exit]]'''
|}


----
(29)

{{anchor|29}}What direction is ''the destination'' relative to ''the origin''?


{| border="1" cellpadding="10"
|-
! scope="col" | '''[[#At the Roundabout Turn Left|Left => At the Roundabout Turn Left]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" | '''[[#At the Roundabout Continue Straight|Straight => At the Roundabout Continue Straight]]'''
|}


{| border="1" cellpadding="10"
|-
! scope="col" | '''[[#At the Roundabout Turn Right|Right => At the Roundabout Turn Right]]'''
|} 


----

== The instructions ==
=== No Instruction ===


There will be '''No instruction''' given passing through this junction.
This can be caused by several factors including
* ''Best Continuation''
* Certain cases with an ''overlapping segment''
* The instruction would be Continue Straight (this doesn't yet exist in the client application)


{| class="Wikitable" style="text-align:center; border: 1px solid darkgray;" cellpadding="5" border="1"
! scope="col" colspan=2 | Displayed Icons
|-
| Livemap<br>& WME
| Client App
|-
| [[File:Big_direction_forward.png|50px]]
| Not<br/>Available<br/>in Client<br/>App
|}

<br />
<br />
<br />


----


=== Turn Right ===


{| class="Wikitable" style="text-align:center; border: 1px solid darkgray;" cellpadding="5" border="1"
! scope="col" colspan=2 | Displayed Icons
|-
| Livemap<br>& WME
| Client App
|-
| [[File:Big_direction_right.png|50px]]
| [[File:Nav icon turn right.JPG|50px]]
|}

<br />
<br />
<br />


----


=== Keep/Stay Right ===


{| class="Wikitable" style="text-align:center; border: 1px solid darkgray;" cellpadding="5" border="1"
! scope="col" colspan=2 | Displayed Icons
|-
| Livemap<br>& WME
| Client App
|-
| [[File:Big_direction_exit_right.png|50px]]
|[[File:Nav icon keep right.JPG|50px]]
|}

<br />
<br />
<br />


----


=== Exit Right ===


{| class="Wikitable" style="text-align:center; border: 1px solid darkgray;" cellpadding="5" border="1"
! scope="col" colspan=2 | Displayed Icons
|-
| Livemap<br>& WME
| Client App
|-
| [[File:Big_direction_exit_right.png|50px]]
| [[File:Nav icon keep right.JPG|50px]]
|}


:::<small>'''NOTE:
:::* In a [[LHT|left hand traffic]] country this instruction does not exist''', and will instead give a [[#Keep/Stay_Right|Keep/Stay_Right]] instruction.
:::* You will only get an Exit instruction on a turn angle less than 45°, because it is assumed no true exit would have a turn sharper than 45°.</small>

<br />
<br />
<br />

----


=== Turn Left ===


{| class="Wikitable" style="text-align:center; border: 1px solid darkgray;" cellpadding="5" border="1"
! scope="col" colspan=2 | Displayed Icons
|-
| Livemap<br>& WME
| Client App
|-
| [[File:Big_direction_left.png|50px]]
| [[File:Nav icon turn left.JPG|50px]]
|}

<br />
<br />
<br />


----


=== Keep/Stay Left ===


{| class="Wikitable" style="text-align:center; border: 1px solid darkgray;" cellpadding="5" border="1"
! scope="col" colspan=2 | Displayed Icons
|-
| Livemap<br>& WME
| Client App
|-
| [[File:Big_direction_exit_left.png|50px]]
| [[File:Nav icon keep left.JPG|50px]]
|}

<br />
<br />
<br />


----


=== Exit Left ===


{| class="Wikitable" style="text-align:center; border: 1px solid darkgray;" cellpadding="5" border="1"
! scope="col" colspan=2 | Displayed Icons
|-
| Livemap<br>& WME
| Client App
|-
| [[File:Big_direction_exit_left.png|50px]]
| [[File:Nav icon keep left.JPG|50px]]
|}


:::<small>'''NOTE:
:::* In a [[RHT|right hand traffic]] country this instruction does not exist''', and will instead give a [[#Keep/Stay_Left|Keep/Stay_Left]] instruction.
:::* You will only get an Exit instruction on a turn angle less than 45°, because it is assumed no true exit would have a turn sharper than 45°.</small>

<br />
<br />
<br />


----


=== At the Roundabout Take the #xx Exit ===


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


{| class="Wikitable" style="text-align:center; border: 1px solid darkgray;" cellpadding="5" border="1"
! scope="col" colspan=8 | Displayed Icons
|-
| Livemap<br>& WME
| colspan=7 | Client App
|-
| [[File:Big_directions_roundabout.png|50px]]
| [[File:Nav icon roundabout x.JPG|50px]]
| [[File:Nav icon roundabout 1.JPG|50px]]
| [[File:Nav icon roundabout 2.JPG|50px]]
| [[File:Nav icon roundabout 3.JPG|50px]]
| [[File:Nav icon roundabout 4.JPG|50px]]
| [[File:Nav icon roundabout 5.JPG|50px]]
| [[File:Nav icon roundabout 6.JPG|50px]]
|}

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

<br />
<br />
<br />


----

=== At the Roundabout Turn Left ===


{| class="Wikitable" style="text-align:center; border: 1px solid darkgray;" cellpadding="5" border="1"
! scope="col" colspan=2 | Displayed Icons
|-
| Livemap<br>& WME
| Client App
|-
| [[File:Big_directions_roundabout_l.png|50px]]
| [[File:Nav icon roundabout left.JPG|50px]]
|}


<br />
<br />
<br />


----


=== At the Roundabout Turn Right ===


{| class="Wikitable" style="text-align:center; border: 1px solid darkgray;" cellpadding="5" border="1"
! scope="col" colspan=2 | Displayed Icons
|-
| Livemap<br>& WME
| Client App
|-
| [[File:Big_directions_roundabout_r.png|50px]]
| [[File:Nav icon roundabout right.JPG|50px]]
|}


<br />
<br />
<br />


----


=== At the Roundabout Continue Straight ===


{| class="Wikitable" style="text-align:center; border: 1px solid darkgray;" cellpadding="5" border="1"
! scope="col" colspan=2 | Displayed Icons
|-
| Livemap<br>& WME
| Client App
|-
| [[File:Big_directions_roundabout_s.png|50px]]
| [[File:Nav icon roundabout straight.JPG|50px]]
|}


<br />
<br />
<br />


----
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />this space intentionally left blank
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />