Junction box: Difference between revisions View history

m (Kentsmith9 moved page Junction Box to Junction box: Title guidelines)
m (→‎Improving data collection: (Timing example) word correction)
 
(65 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{mbox
{{mbox
| type = critical
| type = critical
| text = Junction boxes are currently able to be created and edited in the normal editor by Rank 5+ editors.}}<br>
| text = Currently, junction boxes require rank {{rank|jb}} or higher to create or edit them.}}<br />


[[File:Junction Box 7.png|right]]Junction boxes ''(JBs)'' are used to improve ETA calculations and routing through complicated intersections, and interchanges. Junction boxes are basically a hint editors can give the Waze routing services that “although these few segments are cut in a few places, they generally should be treated as a single point which connects traffic from several sources”. This hint helps the routing service get better ETA calculations and hence select better routes for Wazers.{{clear}}
[[File:Junction Box 7a.png|right]]A '''junction box''' ('''JB''') is a tool used to group separate junction nodes and the segments between them into a single big junction for improved data collection, routing control and navigation instructions. In simple terms, junction boxes tell the routing server, “Although the segments coming into here are connected in a few separate places, they should be treated as if they all connected together at one place." Because of this, junction boxes provide an extra layer of information on top or instead of the information associated with individual nodes, segments and turns.


== Function ==
==Overview==
The junction box enables a complex intersection, or interchange composed and displayed as multiple [[Glossary#Segment|segments]] to be treated by the routing server as a single [[Glossary#Junction|junction node]] with multiple inputs and outputs. Considering a complex intersection as a single point has several beneficial properties:
 
*[[Routing_server#Turn delays|Traffic speed data]] for each path through the junction box can be collected separately.
*[[Glossary#Turn_Restriction|Turn restrictions]] can be separately controlled for each path through the junction box.
*[[Voice prompt|Voice prompts]] can be separately controlled for each path through the junction box.
*[[Turn instruction|Turn instructions]] can be separately controlled for each path through the junction box.
*Additional beneficial features of a junction box will be listed here as they become available.


The junction box enables a complex intersection, or interchange composed and displayed as multiple [[Glossary#Segment|segments]] to be treated by the routing server as a single [[Glossary#Junction|junction node]] with multiple inputs and outputs. Considering a complex intersection as a single point has several beneficial properties:
For [[Glossary#Estimated_Time_of_Arrival|ETA]] purposes, the [[Routing_server|routing server]] does not consider segments wholly within the junction box, but rather treats the junction box as if all the segments which enter or exit the the junction box are connected to a single junction node.
* [[Routing_server#Turn delays|Traffic speed data]] for each path through the junction box can be collected separately.
* [[Glossary#Turn_Restriction|Turn restrictions]] can also be separately controlled for each path through the junction box.
* Additional beneficial features of a junction box will be listed here as they become available.


For [[Glossary#Estimated_Time_of_Arrival|ETA]] purposes, the [[Routing_server|routing server]] does not consider segments wholly within the junction box, but rather treats the junction box as if all the segments which enter or exit the the junction box are connected to at a single junction node.
Junction boxes are considered only by the routing server. Junction boxes have no visibility in the client or on the live map. Junction boxes do not affect the search engine; the origin or destination of a route may be contained in a junction box.


Junction boxes are considered only by the routing server. {{As of|2015|10}}, junction boxes have no effect on navigational prompts. Junction boxes have no visibility in the client or on the live map. Junction boxes do not effect the search engine; the origin or destination of route may be contained in a junction box.
{{mbox
| type = important
| text = Junction boxes are only considered by the routing server when the route fully traverses through the junction box. Routes that start or end inside a junction box will use the underlying segments for routing and instructions. This means that junction box speed data, route restrictions, and instructions that have been overridden by the junction box will not be used by the app in these cases.  
Examples where this could occur are:
*When a route's destination is inside the bounds of a junction box;  
*When a route's origin is inside the bounds of a junction box;
*When a route is recalculated inside the bounds of junction box, such as after a missed turn.}}


==Improving data collection==
===Improving data collection===
<!-- This page, specifcally this entire section was reviewed 2015-11-10 by staff Ohad and confirmed as accurate. Staff quote "it looks really great, comprehensive and correct". -->
<!-- The original page, specifically this entire section was reviewed 2015-11-10 by staff Ohad and confirmed as accurate. Staff quote "it looks really great, comprehensive and correct". -->
[[File:Junction Box 3.png|right|75px]]
[[File:Junction Box 3.png|right|75px]]
Let's look at how a complex intersection can skew [[Routing_server#Turn_delays|turn delay]] transition speed data. Take the following intersection for example. It seems at first glance like a pretty simple intersection, but if it usually experiences heavy traffic this intersection could be collecting bad data.
Waze routing servers use junction box traffic data instead of the underlying segment and node traffic data, though Waze continues to collect both sets of data.  


A complex intersection can skew turn delay transition speed data.  At first glance the following example seems like a pretty simple intersection, but if it usually experiences heavy traffic this intersection could be collecting bad data.


[[File:Junction Box 4.png|right]]
[[File:Junction Box 4.png|right]]
Assume that all the roads are two-way and all turns are enabled. Consider the drivers going from A to E, and from A to F, when there is a traffic jam for the left turn (at point D), but traffic going straight through D is flowing fine.
Assume that all the roads are two-way and all turns are enabled. Consider the drivers going from A to E, and from A to F, when there is a traffic jam for the left turn (at point D), but traffic going straight through D is flowing fine.
 
Without the junction box, the traffic from point A to point C is considered to be the same for both the red and the blue cars. The same statistical data is gathered and the average speed skews the ETA for everyone. The turn delay data is only different for the red and blue cars on the one segment before the turn at D, from C to D.


Without a junction box, the traffic from point A to point C is considered to be the same for both the red and the blue cars. The same statistical data is gathered and the average speed skews the ETA for everyone. The turn delay data is only different for the red and blue cars on the one segment before the turn at D, from C to D.


[[File:Junction Box 5.png|right]]
[[File:Junction Box 5.png|right]]
The junction box solves this problem.
Adding a junction box solves this problem. With a junction box, historical and real time data are collected separately for each one of the possible routes through the intersection - all 12 of them.
 
With the junction box, historical and real time data are collected separately for each one of the possible routes through the intersection - all 12 of them.
{{columns|
{{columns|
* A &#10145; B
* A &#10145; B
Line 47: Line 55:
|4}}
|4}}


Now that the paths of A to F, and A to E are being measured separately, the traffic jam for the red cars turning at D does not have a negative effect on the blue cars going straight through D. Their ETAs are being recorded separately.
With a junction box the paths of A to F, and A to E are being measured separately, the traffic jam for the red cars turning at D does not have a negative effect on the blue cars going straight through D. Their ETAs are being recorded separately.  


{{Anchor|Fixing update request example}}
{{Collapsible section top}}
{{HighlightBar|'''Fixing update request example'''}}
Just click on the expand link to the right ------>
{{Collapsible section content}}
Thus, [[Glossary#Update_Request|URs]] resulting from the inability to distinguish left turn delays from straight through traffic can be dealt with using the junction box. Draw a junction box over the intersection where the straight traffic is being improperly detoured, in order to provide better data collection and hopefully better routing. U-turns that are legal should not be restricted.


Thus, [[Glossary#Update_Request|URs]] resulting from the inability to distinguish left turn delays from straight through traffic can be dealt with using the junction box.
[[File:JBRoutingExample1.png|400px]]</br>
[[File:JBRoutingExample1.png]]
<small>[[#Fixing update request example|Link to fixing update request example]]</small>
{{Collapsible section bottom}}


{{Anchor|Understanding inside a junction box example}}
{{Collapsible section top}}
{{HighlightBar|'''Understanding inside a junction box example'''}}
Just click on the expand link to the right ------>
{{Collapsible section content}}
{{mbox|text=''There are many types of scenarios where a junction box may be indicated, this sample is used just to explain the function of a junction box, and not meant as guidance on where to use them.''}}
[[File:Junction Box 3a.png|right|250px]]
To illustrate the improving data collection concept, let's take a look at this intersection. There are five segments entering/exiting the junction box (segments which are only partially inside the junction box). There is one segment which is wholly inside the junction box. If there were no junction box at this intersection the individual [[Routing server#Turn delays|turn delay]] ''AKA the time it takes to turn from one segment to the next'' data for the outer five segments would be merged together at the inner four segments, and be distorted. The junction box here alleviates the problems with collecting accurate turn delay transition timing caused by the short segments in the middle.</br>
<small>[[#Understanding inside a junction box example|Link to understanding inside a junction box example]]</small>
{{Collapsible section bottom}}


=== Understanding inside a junction box ===
{{Anchor|Timing example}}
{{Collapsible section top}}
{{HighlightBar|'''Timing example'''}}
Just click on the expand link to the right ------>
{{Collapsible section content}}
If a junction box is drawn around these intersections (below left), then when considering a route that would traverse a segment within the junction box, the routing server treats the intersection like one large junction node for the purpose of calculating transition timing ''AKA turn delays'' (below right).


{{mbox|text=''There are many types of scenarios where a junction box may be indicated, this sample is used just to explain the function of a junction box, and not meant as guidance on where to use them.''}}
A route path from point A to point B (westbound Mill Grove Rd to southbound Idlewild Rd to westbound Indian Trail Fairview Rd) is treated as a single transition, even though in actuality it traverses four segments (3 transitions). The green path is the actual junction box route in WME.
[[File:Junction Box A.png|right|250px|thumb]]
To illustrate this concept, let's take a look at this intersection. There are five segments entering/exiting the junction box (segments which are only partially inside the junction box). There are another four segments which are wholly inside the junction box. If there were no junction box at this intersection the individual [[Routing server#Turn delays|turn delay]] ''AKA the time it takes to turn from one segment to the next'' data for the outer five segments would be merged together at the inner four segments, and be distorted. The junction box here alleviates the problems with collecting accurate turn delay transition timing caused by the short segments in the middle.


<center>[[File:Timing_Junction_Box_4e.PNG|300px]] [[File:Junction Box B.png|300px]]</center></br>
<small>[[#Timing example|Link to timing example]]</small>
{{Collapsible section bottom}}
{{clear}}


==== Timing ====
===Turn arrow tooltip on a junction box exit arrow===
[[File:Wme_turn_override_hover5.png|250px|right]] The  turn arrow tooltip has five elements: Voice prompt, Instructions, Restrictions, Switch Route (when applicable), and Difficult turn. Junction boxes have no effect on these elements, unless these elements are changed in the turn arrow tooltip.


If a junction box is drawn around these intersections (below left), then when considering a route that would traverse a segment within the box, the routing server treats the intersection like one large junction for the purpose of calculation transition timing ''AKA turn delays'' (below right).
{{Anchor|Turn instructions example}}
{{Collapsible section top}}
{{HighlightBar|'''Turn instructions example'''}}
Just click on the expand link to the right ------>
{{Collapsible section content}}
Looking back at our timing example path, going from point A to point B (westbound Mill Grove Rd to southbound Idlewild Rd to westbound Indian Trail Fairview Rd), let's analyze how the junction box works with voice prompts. Our path is considered for routing as one transition, and judging by the angles it would be a straight transition making it a [[best continuation]] with no voice prompt. But as we just said 'junction boxes have no effect on voice prompts', therefore the actual voice prompt given for this path (point A to point B) will consider the three junction nodes and produce:


A route path from segment C to segment E is treated as a single transition, even though in actuality it traverses four segments (3 transitions).
*[[File:Big_direction_left.png|25px]] Turn Left onto Idlewild Rd, and then
*[[File:Big_direction_right.png|25px]] Turn right onto Indian Trail Fairview Rd".


<center>[[File:Junction Box C.png|300px]] [[File:Junction Box B.png|300px]]</center>
This is to say that the voice prompts are still controlled by the actual names, types, and angles of the segments within a junction box.
{{Details|How Waze determines turn / keep / exit maneuvers|Waze selected voice prompts}}</br>
<small>[[#Turn instructions example|Link to turn instructions example]]</small>
{{Collapsible section bottom}}


==== Navigation instructions ====
====Voice prompt====
*If a voice prompt is added in the junction box's exit arrow tooltip, then all internal Waze selected voice prompts are removed and the voice prompt is announced at the first junction node using the first named road segment on that route from the first junction node.
*If a voice prompt is added in the junction box's exit arrow tooltip, the voice prompt will be given at the first junction node. Unless there is an editor selected voice prompt (other than Waze selected) on a node along the path, then the editor selected voice prompt on the node will override the junction box's exit arrow voice prompt (junction box's exit arrow voice prompt will not be given).
*If a voice prompt is added in the junction box's exit arrow tooltip, and lane guidance has also been added to the segment entering the junction box at the first node inside the junction box, the lane guidance will be displayed with the voice prompt. This can be undesirable, and it is recommended to check the lane guidance when adding a voice prompt to junction box paths.


However, '''junction boxes have no effect on navigational prompts''' until phase 3 will be released. {{As of|2015|10}} Junction boxes currently only have Phase 1 (transition / ETA timing), & Phase 2 (path restrictions) active.
{{Anchor|Voice prompt example}}
{{mbox|type=speculation|text=When Phase 3 (controlling navigation instructions) is released it will likely only affect paths which are specially marked for a custom prompt.}}
{{Collapsible section top}}
Looking back at our example path, going from C to E, let's analyze how the junction box works with navigation prompts. Our path is considered for routing as one transition, and judging by the angles it would be a straight transition making it a [[best continuation]] with no navigation prompt. But as we just said 'junction boxes have no effect on navigational prompts', therefore the actual navigation prompt given for this path (C to E) will consider the three junctions and produce:
{{HighlightBar|'''Voice prompt example'''}}
* [[File:Big_direction_left.png|25px]] Turn Left onto Idlewild Rd, and then
Just click on the expand link to the right ------>
* [[File:Big_direction_right.png|25px]] Turn right onto Indian Trail Fairview Rd".
{{Collapsible section content}}
In the example below, adding a voice prompt to the junction box’s exit turn arrow tooltip can cause problems with the correct location of the voice prompt and the announced road name.
<center>[[File:OR JB TIO1.png|300px]]&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[File:OR JB TIO3.png|300px]]</center>


This is to say that the navigational prompts are still controlled by the actual names, types, and angles of the segments within a junction box.
Eastbound {{Major Highway|State Hwy 22E}} has a left exit to {{Ramp|OR-99E BUS / Keizer / Portland}}. There is an "exit left" voice prompt[[File:OR_JB_TIO3.PNG|250px|right]] on the junction box's route which exits for that ramp. The junction box's voice prompt overrides all the internal Waze selected voice prompts and the voice prompt is "Exit left to State Hwy 22E" at junction node A in the picture above, which gives the user very bad instructions. The voice prompt is given too early (just before crossing the water) and the wrong road name is announced. This is because the junction box's voice prompt is announced at the route's '''first''' junction node within the junction box and utilizes the '''first''' named road segment after that junction node. If you take off the primary name of the{{Major Highway|State Hwy 22E}}'s two segments between that first junction node and the ramp, then the first named road segment becomes the ramp segment. This does have the desired road name announced, but the announcement will still be just prior to crossing the water.
{{Details|How Waze determines turn / keep / exit maneuvers|how to control navigation instructions}}


== Controlling turns ==
*Moral of this example is, don't put the exit left voice prompt on the junction box exit arrow. Instead, just have it on the major highway's turn arrow tooltip and it should announce the correct ramp name at the correct location.</br>
<small>[[#Voice prompt example|Link to voice prompt example]]</small>
{{Collapsible section bottom}}


[[File:JB turn control.png|right|thumb|200px]]
====Instructions====
Junction boxes permit disabling multi-segment turns that are difficult to control in complex intersections.  Without a junction box, controlling complex turns may require adding artificial segments and/or reducing the intersection to a single point using a [[Bowtie#Bow_tie|bow-tie]] configuration.
[[File:JB Turn instructions panel.png|250px|right]]
Similar to the Instructions on turn arrow tooltip, Instructions is an option on a junction box exit arrow tooltip. The Turn instructions panel has the same options but there are special considerations when the options are used on the junction box exit arrow.


Take this example of a junction between two streets with all turns allowed, but at the next junction with the highway some turns are not allowed depending on which street you originally approached from.
=====Visual instructions=====
Visual instructions can be added to a junction box's exit arrow.
*Just like voice prompts, visual instructions will be given at the first node that the path encounters through the junction box.
*Unlike JB voice prompts, JB visual instructions will work together with subsequent node-based visual instructions inside the junction box. In these cases the junction box's visual instruction will be shown at the first node, and then the node-based visual instruction(s) will be shown at the subsequent node(s) through the junction box.
*When adding visual instructions to a junction box's exit arrow do not add visual instructions directly to the first node of that route, to avoid a conflict between the junction box's visual instruction and the node-based visual instruction on that first node.
*Both node-based and junction-box-based visual instructions require an associated navigation instruction in order to be visible in the app, either resulting from default behavior, a voice prompt or a View and hear lanes override. If the driver is not told to turn, exit, continue, etc. at a node, no visual information can be displayed there.


When leaving {{Street|E Briarwood Cir}} here you may turn right or left onto {{Primary Street|S Havanah St}}, but if you turn right your options are limited at the next junction. However if you were already on {{Primary Street|S Havanah St}} from before E Briarwood, at the junction with {{Major Highway|E Arapahoe RD}} you are allowed to make either turn or go straight.
Adding visual instructions to a junction box route is useful for situations where multiple signs are displayed for a single turn, with each sign pertaining to the next turn. For example, in complex interchanges it's common to have multiple lanes exit the highway together at one place and then split apart a short distance after exiting, with the different lanes marked by different signs. Using a JB visual instruction allows the driver to see only the visual instructions that pertain to their route.


{{Anchor|Visual instructions example}}
{{Collapsible section top}}
{{HighlightBar|'''Visual instructions example'''}}
Just click on the expand link to the right ------>
{{Collapsible section content}}
[[File:WME JB Visual BGS.jpg|300px|thumb|right|At the first node there are signs for I-75 N » Dayton, Exit 1D: US-50 W • River Rd, and Exit 1C: Fifth St]]
The example route is traveling northbound on I-75 to Exit 1D: US-50 W • River Rd where I-75 N and I-71 N fork. At the first node on our route there are signs for {{nowrapcode|I-75 N » Dayton}}, {{nowrapcode|Exit 1D: US-50 W • River Rd}}, and {{nowrapcode|Exit 1C: Fifth St}}. Trying to display all of this visual information information at the first node would be difficult to accomplish in one visual instruction; it would give the driver a lot of information they don’t need; it would also make the verbal instructions unnecessarily long to the point where it could truncate future instructions.
Adding visual instructions to the junction box path we can give the driver instructions only what they need to see and hear for their route to Exit 1D: US-50 W • River Rd.
{{Clear}}
Adding only these instructions will give clear directions for this route
{|style="margin: 0 auto;"
| [[File:WME JB Visual1.jpg|250px|thumb|First, add this on the junction box exit arrow tooltip for the Exit 1D: US-50 W • River Rd route]]
| [[File:WME JB Visual2.jpg|250px|thumb|Then, at the I-75 N / Exit 1C: Fifth St fork add the view only lane guidance on the highlighted segment]]
| [[File:WME JB Visual3.jpg|250px|thumb|Finally, at the fork for I- 75 N add the visual instruction for Exit 1D: US-50 W • River Rd on the turn arrow tooltip]]
|}
This will result in the following instructions in the app
{|style="margin: 0 auto;"
| [[File:JB Visual App1.png|250px|thumb|The first instruction approaching the first node entering the junction box]]
| [[File:JB Visual App2.png|250px|thumb|Followed by a visual only continue instruction at the second node in the junction box]]
| [[File:JB Visual App3.png|250px|thumb|The last instruction will be for Exit 1D: US-50 W • River Rd]]
|}</br>
<small>[[#Visual instructions example|Link to visual instructions example]]</small>
{{Collapsible section bottom}}


Without a junction box here our options to reflect these restrictions on the map would require creating an artificial AGC connecting north from {{Street|E Briarwood Cir}} to the junction of the {{Major Highway|E Arapahoe RD}} layered over {{Primary Street|S Havanah St}} (which is discouraged by waze as layered segments can cause data collection problems), or creating an artificial bypass AGC on {{Primary Street|S Havanah St}} which started from south of {{Street|E Briarwood Cir}} (which can look bad on the map). These options separate the traffic flow of those vehicles approaching on {{Primary Street|S Havanah St}}, from those vehicles approaching from {{Street|E Briarwood Cir}}. In either case we are adding artificial segments which are unnecessary and difficult to maintain on the map.
=====TTS=====
<center>[[File:JB turn control 1.png|300px]]&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[[File:JB turn control 2.png|300px]]</center>
Even though the TTS (text to speech) box will show the name of the exit segment in gray, this name may not actually be what's spoken. If the name of the exit segment is required in TTS, be sure to confirm it by clicking the TTS field, then clicking Apply, before saving the junction box turn instruction.


====Restrictions====
Partial restrictions, including time-based restrictions, can be added to junction box paths just like they are to normal node-based turns. In fact, when a junction box is created, any partial restrictions that existed on segments and turns within the junction box are automatically copied into the applicable junction box paths, making these JB exit arrows yellow. This is similar to how drawing a JB over nodes with full turn restrictions causes applicable JB paths to have red exit arrows. After a junction box is created, all restrictions are controlled by hovering over its exit arrows and making changes there rather than on underlying segments or turns.


[[File:JB turn control C.png|thumb|200px]]
=====Internal turn restriction(s)=====
With a junction box in place, we don't need any extra segments, we don't need to artificially alter any geometry of the segments, or to create a bow-tie. We use just the one segment of S Havanah St, and draw the junction box to include the intersection with the major highway and both approaches. We can then use the connections list in the left panel to select which paths through the junction box should be allowed, and which should be disallowed.
The turn restrictions or time based turn restrictions for junction arrows on segments that enter the junction box are visible on the junction node within the junction box as of January 2020. Selecting that segment displays turn restrictions just like selecting a segment that is not in a junction box. There are also turn restrictions or time based turn restrictions on each exit arrow of a junction box route, this is because the junction box has taken over the exit from the entry segment and this(these) turn restriction(s) is(are) now the turn restriction(s) on the junction box exit. The same is true for time based segment restrictions on segments that enter the junction box.
[[File:JBTR.png|left|300px]][[File:JBTBSR.png|300px]]


In our scenario we want to restrict the two paths starting on {{Street|E Briarwood Cir}}, going north on {{Primary Street|S Havanah St}} and then straight or left at the {{Major Highway|E Arapahoe RD}}.
====Switch Route====
There can only be one route from a specific entrance to a specific exit in a junction box. In cases where there is more than one routing option available, then the '''Switch Route''' option will appear. The switch route option will allow you to select the appropriate route through the junction box. The allowed route through a junction box should always be enabled and shown with the green path. A red exit turn arrow means that any route from the selected entry segment to the selected exit turn arrow will be disabled


With the junction box selected, in the left panel there will be check boxes for each of the possible paths between the segment pairs. clicking on any of these paths on the left will highlight the path in purple on the map. We then uncheck the paths we want to disallow [[File:JB turn control C1.png|75px]].
{{Anchor|Switch Routes example}}
{{clear}}
{{Collapsible section top}}
<center>[[File:JB turn control 3.png|300px]]&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[[File:JB turn control 4.png|300px]]</center>
{{HighlightBar|'''Switch Routes example'''}}
Just click on the expand link to the right ------>
{{Collapsible section content}}
Example of the route selection in a situation where there are some alternate looping routes available. The first picture shows the typical green path for eastbound Franklin St NE as it continues across Rhode Island Ave NE. If the straight path was prohibited by a Jersey barrier and signage, then the editor can select the alternate path of southbound 15th St NE to northeast-bound Rhode Island Ave NE to eastbound Franklin St NE. The second route as shown in the second picture was set by clicking the Switch Route forward button one time.
<center>[[File:DC Route Toggle Example1a.PNG|400px]]&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[[File:DC Route Toggle Example2a.PNG|400px]]</center>


=Effects In Editor=
Using the same example, the first picture below shows the typical green path for eastbound Franklin St NE as it continues across Rhode Island Ave NE. Disabling the path of southbound 15th St NE to northeast-bound Rhode Island Ave NE to eastbound Franklin St NE will disable all paths for eastbound Franklin St NE continuing through the junction box. Which is not the same as allowing the green path for eastbound Franklin St NE as it continues across Rhode Island Ave NE.
Junction boxes can only be edited by editors of at least [[Your_Rank_and_Points#Waze_Map_Editing_Ranks|rank]] 5. Junction boxes appear in the Waze Map Editor when the [[Map_editor_interface#Layers|Junctions layer]] {{AddCode|add layer description to [[Map_editor_interface#Layers]]}} is turned on.  Junction boxes appear as a polygon around all the junction nodes of an intersection.
<center>[[File:DC Route Toggle Example1a.PNG|400px]]&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[[File:Example3a.jpg|400px]]</center></br>
[[File:Junction Box 1.jpg|center]]
<small>[[#Switch Routes example|Link to switch Routes example]]</small>
All segments that enter the junction box are locked.  Selecting a segment that is part of a junction box results in a message: "You cannot edit this segment.  This segment is part of a junction and cannot be edited.  Delete the junction to edit it." 
{{Collapsible section bottom}}


Selecting the junction box causes the left pane to display the junction box properties. The properties show the editor that created the junction box and the date and editor of the last update to the junction box.  If changes are needed to the junction box or segments associated with the junction box contact the identified editor or other rank 5 editor in your area.
====Difficult turn====
Difficult turns and time based difficult turns are available on junction box routes the same way they are used on segment turn arrows.
*Junction box difficult turns may be useful for paths that are legal but directly contradict guide signs and/or require quick weaving through multiple lanes of traffic, such as entering a highway from the right and then quickly exiting to the left.


[[File:Junction Box 2.jpg|600px|center]]
===Controlling turns===
Each entry to the junction box is labeled with a letter in a green circle. Each exit from the junction box is labeled with a letter in yellow circle. Hovering the cursor over the letter circle will show the routes through the junction box that use the selected entry or exit.  The left pane shows potential entry/exit pairs with a check box ticked for each pair enabled for routing. Note that only entry/exit pair paths which are fully visible on screen are displayed. So make sure you can see the whole boundary of the JB to be sure you're getting a full list of entry/exit pair connections in the left pane.
Junction boxes permit disabling multi-segment turns that are difficult to control in complex intersections. Without a junction box, controlling complex turns may require adding artificial segments and/or reducing the intersection to a single point using a [[Bowtie#Bow_tie|bow-tie]] configuration.


Routes through the junction box that pass through a single junction node are not considered. Such routes are controlled by turn restrictions in place when the junction box is created. Thus the route from A to G is controlled by a turn restriction and does not show in the list of entry/exit pairs.
{{Anchor|Controlling turns example}}
{{Collapsible section top}}
{{HighlightBar|'''Controlling turns example'''}}
Just click on the expand link to the right ------>
{{Collapsible section content}}
Take the intersection of (Leesburg Pike & Fairfax Sq/Fashion Blvd, Tysons Corner, VA) as an example. There, some turns are not allowed based upon on which street it was originally approached from. Additionally U-turns are prevented in both directions.


Routes through the junction box that are prohibited by turn restrictions in place when the junction box is created are not considered.  In the above example, the left turns from the southbound {{Major Highway}} use the dedicated turn lane. The left turn from the main lanes of the southbound {{Major Highway}} to the {{Minor Highway}} is restricted by an existing turn restriction. Thus, the junction box does not consider routes from the southbound {{Major Highway}} to exits G or H.
When traveling northwest on {{Major Highway|Leesburg Pike}}, it appears that you may turn right using the at-grade connector (AGC) to {{Street|Fashion Blvd}} or left onto {{Street|Fairfax Sq}} or continue on {{Major Highway|Leesburg Pike}}. If you were already traveling northwest on {{Major Highway|Leesburg Pike}} before {{Ramp|Exit 47A: SR-7 W / Leesburg Pike / Tysons Corner}} or if it was entered from {{Street|Mervis Way}} to {{Primary Street|Towers Crescent Dr}}, then you are allowed to make either turn or go straight. But if you entered Leesburg Pike from I-495 S regular lanes' Exit 47A ramp, then the left turn is prohibited to Fairfax Sq; you can only turn right or go straight. The left is prohibited by a sign at the ramp.
[[File:Ramp no left turn at light.png|center|200px]]


From the southbound {{Major Highway}}, routes to exits E and F pass through only a single junction node and routes to exits G and H are prevented by a turn restriction. The junction box thus considers no routes for the traffic entering from the main lanes of the southbound {{Major Highway}}. For this reason, this entry is not lettered.
Without a junction box here our options to reflect these restrictions on the map would require creating artificial parallel segments connecting north from {{Ramp|Exit 47A: SR-7 W / Leesburg Pike / Tysons Corner}} to its junction node with {{Street|Fairfax Sq}} with the connections from {{Street|Mervis Way}} to {{Primary Street|Towers Crescent Dr}} that don't turn onto this artificial parallel road. This option separates the traffic flow of those vehicles approaching on {{Major Highway|Leesburg Pike}}, from those vehicles approaching from {{Street|Marvis Way}} and visually disrupts the map with the parallel segments. Another option for other areas is to layer the segments, which is discouraged by Waze since layered segments can cause data collection problems. In either case we are adding artificial segments which are unnecessary and difficult to maintain on the map.
<center>[[File:Tysons Corner Parallel Segments.png|300px]]&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[[File:Tysons Corner Layered.png|300px]]</center>


=Editing=
With a junction box in place, we don't need to add any extra segments, to artificially alter any segment's geometry, or to create a bow-tie. We use just the one segment of {{Major Highway|Leesburg Pike}}, and draw the junction box to include the junction nodes with the ramp/major highway all the way to the major highway/left and right local streets. We can then use the junction box's turn restrictions to select which paths through the junction box should be allowed, and which should be disallowed.
Junction boxes are created by selecting Junction box from the [[Map_Editor_Interface_and_Controls#Draw_segments_menu|draw segments menu]] (Shortcut key {{key press|J}}). Click at one vertex of the junction box.  Continue click to at each vertex of the box until the box surrounds all the junctions nodes of the intersection. Double click to complete the box.  The boundaries of the box cannot be changed once created.
[[File:Tysons Corner JB.png|center|600px]]


Before creating a junction box at an intersection, make sure that there are no incorrect turn restrictions. Routes through the junction box that are prevented by existing turn restrictions cannot be enabled in the junction box.
Have the entire junction box within the editing screen, then select the junction box. The available entrances show up as a list to the left of the editing screen. Small white arrows appear on the junction box boundary to indicate a segment entering the junction box. If the entire junction box is not selected then all of the entrances or even no entrances may appear in the list.
[[File:Tysons Corner JB w Entrances.png|center|600px]]


When a junction box is selected it can be edited.  To select a Junction Box, click on it.
Click on either an entrance from the list to the left or the appropriate small white arrow. This displays the routes from that entrance. The initial selection from the {{Ramp|Exit 47A: SR-7 W / Leesburg Pike / Tysons Corner}} shows seven (7) Green Turn restrictions and one (1) Red Turn restriction. The exits from this segment are listed to the left. All routes are initially enabled as a Green Turn restriction '''UNLESS''' there is a simple two segment intersection that has a Red Turn restriction. In this example nw bound Leesburg Pike's right turn to Fashion Blvd is prohibited because of the At grade connector; therefore the initial junction box has that TR as red. Also note that the selected entrance segment is colored a light blue, the long green route along the allowed paths, and the very short red "non-route" on the one prohibited path. The list on the left shows the same colored Turn restriction as is on the segment. Clicking the list to the left or the actual junction box exit arrow will toggle the Turn restriction. Hovering over a junction box exit arrow shows the turn arrow tooltip.
[[File:Initial_TRs_on_JB_ramp.png|center|600px]]


When the junction box is selected, the left pane will show the potential conection paths through the junction box as illustrated above.  Clicking the check box next to each connection path toggles between enabling or disabling routing between the indicated entry/exit pair.
Now we will restrict the left turn from northwest-bound Leesburg Pike to Fairfax Sq, based on the restriction sign at the ramp. Click on the green arrow, and it turns to a red arrow. After clicking save '''we have the prohibited turn easily and simply mapped'''! Both the turn restriction on the junction box and the junction exit list to the left are displaying the prohibited restriction. Also there is a long red "non-route" on the prohibited route. [[File:Tysons_Corner_JB_ramp_left_only_restricted.png|center|600px]]</br>
<small>[[#Controlling turns example|Link to controlling turns example]]</small>
The left pane includes a button to "Select included segments." Clicking this button will select all the segments with both ends in the junction box (these are the segments that are not considered for ETA routing purposes).
{{Collapsible section bottom}}


The left pane includes a name box and an address. A name can be added to the name box and the address may be edited. However, currently the name and address of a junction box has no effect.
==Where to use==
Junction boxes are suitable only where their functions are required. If problems are easily solved with other features such as [[Glossary#Turn_Restriction|turn restrictions]], a junction box should not be used. Appropriate reasons to use a junction box:
*To prohibit a route on the same exit path when there are two different entrances, where using a regular turn restriction would also prohibit other routes that should be allowed.
*To prohibit U-turns in one or more directions on median segments between divided roads at H or # intersections
*To collect more granular data on traffic that backs up unequally across different lanes of a road through multiple junction nodes, due to conditions like heavy weaving between entrances and exits on a freeway, or busy left turns through an intersection with long cycle times
*To ensure proper routing and data collection through intricate intersections containing multiple short segments
*To provide more appropriate voice prompts for movements through intersections, where segment geometry and node-based voice prompts would provide improper navigation instructions
*To provide more accurate turn instructions for a turn with multiple signs for different destinations past the turn
*To correct routing issues or improper turn instructions in [[Roundabout#Junction box|roundabouts]]


To delete a junction box, select the junction box and click the [[Map_Editor_Interface_and_Controls#Delete_button|delete button]]&nbsp;[[File:Wme_button_delete.png|25px]] (Shortcut key {{key press|Del}}).
===Drawbacks===
Certain things cannot be done to segments and nodes that are part of a junction box without first deleting the junction box. These include:
*Changing a segment's direction between two way and one way
*Moving a junction node across the boundary of a junction box
*Adding or deleting a junction node inside a junction box
*Adding, deleting, connecting or disconnecting a segment inside a junction box


Changes to junction boxes (and adding new junction boxes) require a [[Tile_update#Updates|tile update]] to affect routing.
For these reasons, junction boxes should not be used for every intersection. Where they are used, turn information should be applied to node-based turns rather than junction box paths, if possible, to avoid rework if the junction box needs to be deleted in the future.


==Errors When Editing==
Note that for many years it had been impossible to cut or merge a segment, even if only an end of it was part of a junction box; the junction box had to be deleted first. This is no longer true.
* '''No roundabouts''' - Junction boxes do not support [[Roundabout|roundabouts]]. Do not create junction boxes over roundabouts.  


* '''Max size''' - The size of a junction box cannot exceed 1 kilometer. This is a linear 1 km limit north-south or east-west. If you draw an imaginary 1 km² box around the junction box, if the junction box pokes out at any point, then it's too big.
==Editing==
A Junction box is created by selecting Junction box from the [[Map_Editor_Interface_and_Controls#Draw_segments_menu|draw segments menu]] (Shortcut key {{key press|J}}). Click at one vertex of the junction box. Continue to click at each vertex of the box until the box surrounds all the junction nodes of the intersection. Double click to complete the box.
*The boundaries of the box cannot be changed once created. If you need to change the shape of the junction box, you must delete it and create it again.
*Before creating a junction box at an intersection, make sure that there are no incorrect turn restrictions including U-turns. Routes through the junction box that are prevented by existing turn restrictions cannot be enabled in the junction box.
*The routes through a junction box can be edited when it is selected. To select a junction box, click on it.
*When the junction box is selected, the left pane will show the potential connection paths through the junction box as illustrated above. Clicking the check box next to each connection path toggles between enabling or disabling routing between the indicated entry/exit pair.
*The left pane includes a button to "Select included segments." Clicking this button will select all the segments with both ends in the junction box (these are the segments that are not considered for ETA routing purposes).
*The left pane includes a name box and an address. A name can be added to the name box and the address may be edited. However, currently the name and address of a junction box has no effect.
*To delete a junction box, select the junction box and click the [[Map_Editor_Interface_and_Controls#Delete_button|delete button]]&nbsp;[[File:Wme_button_delete.png|25px]] (Shortcut key {{key press|Del}}).
*Changes to junction boxes (and adding new junction boxes) require a [[Tile_update#Updates|tile update]] to affect routing.
*If a junction box is deleted and then recreated using the same segments before too much time passes, the Waze routing servers can use the previously stored junction box data for any segment IDs that have not been deleted.


* '''Two junction node minimum''' - A junction box must include at least two junction nodes. Two junction nodes within the junction box must be connected by a segment.  A junction box with only one junction node cannot be saved.
===Effects In Editor===
Junction boxes can only be edited by editors of at least [[Your_Rank_and_Points#Waze_Map_Editing_Ranks|rank]] {{rank|jb}}. Junction boxes appear in the Waze Map Editor when the [[Map_editor_interface#Layers|Junction Boxes layer]] is turned on; the two pieces of paper in the upper right of the map editing area. Junction boxes appear as a polygon around all the junction nodes of an intersection.


* '''No overlapping''' - A junction node cannot be included in multiple junction boxes.
All segments that enter the junction box are only partially editable. Selecting a segment that is part of a junction box results in a message: "Some attributes cannot be edited. This segment is part of a junction box. Use the junction box to edit this segment's restrictions." For further details on which attributes can be edited and which cannot, see [[#When to use|when to use]].


* '''One connection per pair''' - A junction box must have only one connection for every entry/exit pair. If there are multiple routes available over the segments within the junction box between an entry/exit pair, the box is invalid and cannot be saved.
[[File:Tysons_Corner_JB_w_Entrances_2021.png|500px|right]]Selecting the junction box causes the left pane to display the junction box properties. The properties show the editor that created the junction box with the date and the editor of the last update to the junction box. If changes are needed to the junction box or segments associated with the junction box, contact the identified editor or other rank {{rank|jb}} or higher editor in your area.


* '''Sixteen paths max''' - No more than 16 controllable entry/exit paths can pass through '''a single node''' within a junction box. A save error stating "The highlighted node cannot have more than 16 connections" occurs if a node has more than 16 connections.
The left pane shows potential entry/exit pairs with a check box ticked for each pair enabled for routing. Note that only entry/exit pair paths which are fully visible on screen are displayed. So make sure you can see the whole boundary of the JB to be sure you're getting a full list of entry/exit pair connections in the left pane.
{{Clear}}
*Routes through the junction box that pass through a single junction node (and do not cross any JB internal segments) are not controlled by the JB. Instead, they are controlled by turn restrictions in place when the junction box is created.
*Routes through the junction box that are prohibited by red turn restrictions between segments within the junction box are not considered.  
*Difficult turns can be set on the junction box's turn restrictions and do affect routing in the server if the user has the appropriate setting selected.
*Any green or yellow turn restriction on a junction box can have the difficult turn attribute added for either 24/7 coverage or with time/day/date restrictions. Please refer to the [[Partial_restrictions#Adding.2Fediting_a_difficult_turn|Difficult turn]] section for editing directions.
{{clear}}


===Eliminating entry/exit pair connections===
===Switch route selection===
Entry/exit pairs may be unchecked as appropriate so that there is only one connection between an entry and an exit.
[[File:WME_JB_Switch_Route.png|250px|right]]
[[File:JBEE1.png|600px|center]]
*Select the '''entry segment''' of the junction box that you want to compare routes on.
*Hover over the appropriate '''exit turn arrow''' that you want to select the desired route.
*The switch route selection will appear between the restrictions and difficult turn options in the turn arrow tooltip box.
*Click the forward or back arrow to cycle thru the allowable routes.
*For a route that you wish to allow, always select the green route from the entry segment to the exit turn arrow. In other words do not select a route that should be disabled, select the route that should be allowed.
*A red arrow on the exit turn arrow means that any route from the selected entry segment to the selected exit turn arrow will be disabled


<br>
If there is only one route available in the junction box then the switch route selection will not appear. Note it may take several clicks to get to the desired route.


[[File:JBEE2.png|300px|right]]
===Errors when editing===
[[File:JBEE3.png|300px|right]]
*'''Max size''' - The length of a junction box cannot exceed 0.01° latitude and 0.01° longitude. In terms of distance, the north-south linear limit is always 1110m (0.01°), while the maximum east-west linear limit varies depending on your latitude, because the length of a longitudinal degree decreases as you travel further from the equator. In the southernmost part of the continental US, 0.01° longitude translates to about 1010 m; along the Canadian border (49° N), however, 0.01° longitude is about 730 m. So the max size of a JB in Key West is about 1110 m x 1010 m (N-S "height" × E-W "width"), but along the Canadian border the max size of a JB is 1110 m x 730 m (N-S "height" × E-W "width").


For the above junction box there are two paths from entry A to exit H. In this case to save the junction box, the longer path shown in the upper illustration has been unchecked.
*'''Two junction node minimum''' - A junction box must include at least two junction nodes. Two junction nodes within the junction box must be connected by a segment. A junction box with only one junction node cannot be saved.


Unchecking entry/pairs will also reduce the number of paths that pass through a node within the junction box.  In this case, there are fourteen entry/exit pairs that pass through the upper left junction node:
*'''No overlapping''' - A junction node cannot be included in multiple junction boxes.
{{columns|
* A &#10145; F
* A &#10145; H
* A &#10145; I
* A &#10145; J
* B &#10145; F
* B &#10145; H
* B &#10145; I
* B &#10145; J
* C &#10145; F
* C &#10145; G
* C &#10145; J
* D &#10145; G
* E &#10145; G
* E &#10145; J
|3}}
The direct u-turns from B to G and C to H are disabled.


[[File:JBEE4.png]]
*'''Sixteen paths max''' - No more than 16 controllable entry/exit paths can pass through '''a single-junction node''' within a junction box. A save error occurs if a junction node has more than 16 connections. This also counts the adjacent connections not displayed in the routing box list that do not cross any of the internal segments like A to G, D to J, etc.


Thus, the internal routes from B to G and C to H are available. In this example these u-turns through the junction box are unchecked. If these paths were checked, there would be 16 paths through the upper left junction node and the junction box would not save.
*'''Enabled U-turn on a two-way segment''' - Note that having U-turn(s) enabled on a two-way segment inside the junction box will increase the number of paths and can lead to the saving error message.
{{clear}}
*'''Non-navigable segments''' - Junction nodes within a junction box can't be connected to [[Road types#Non-drivable roads|non-drivable road types]] unless connected by a virtual node. Connected non-drivable road types will generate a save error and should be disconnected from the junction within the junction box.


===Adding complexity===
===Adding complexity===
Adding segments or junction nodes to an intersection to workaround the "one connection for every entry/exit pair" and "no more than 16 connections per node" limitations is not recommended. If such a workaround is required, please consult with your [[Country_Manager#Coordinators|country]] manager or [[Regional_Coordinator|regional]] coordinator.
Adding segments or junction nodes to an intersection to workaround the "one connection for every entry/exit pair" and "no more than 16 connections per node" limitations is not recommended. If such a workaround is required, please consult with your [[Country_Manager#Coordinators|country]] manager or [[Regional_Coordinator|regional coordinator]].
 
=When To Use=
Junction boxes are suitable only for specific locations where the above listed functions of junction boxes are required. If problems with data collection or turn restrictions are experienced then, a junction box may be use to solve the problem. If problems are easily solved with other features such as [[Glossary#Turn_Restriction|turn restrictions]] or [[Routing penalties/Controlling U-turn penalties|U-turn penalties]], then a junction box should not be used.
 
Junction boxes create other limitations that should be considered:
* They require more space to store all the data involved.
* The routing server takes longer to analyze junction boxes and thus to provide routes through junction boxes.
* Segments connected to junction boxes cannot be edited without first deleting the junction box.


For these reasons, junction boxes should not be used for every intersection.
===Final Checks===
*For the final configuration, if there is not an allowed path from the entrance segment to the exit segment then there needs to be a red turn restriction arrow and red route/path.
*For the final configuration, if there is an allowed path then there needs to be a green (or yellow) turn restriction arrow and a green route/path.
*It is recommended to save the final configuration of the junction box, then either soft or hard refresh the map. After these steps recheck every route from every possible entry segment to each exit segment. This is recommended because occasionally during the save process WME will set an incorrect route and rechecking each route through the junction box will catch these errors.

Latest revision as of 04:46, 19 October 2022

Currently, junction boxes require rank 4 or higher to create or edit them.


A junction box (JB) is a tool used to group separate junction nodes and the segments between them into a single big junction for improved data collection, routing control and navigation instructions. In simple terms, junction boxes tell the routing server, “Although the segments coming into here are connected in a few separate places, they should be treated as if they all connected together at one place." Because of this, junction boxes provide an extra layer of information on top or instead of the information associated with individual nodes, segments and turns.

Overview

The junction box enables a complex intersection, or interchange composed and displayed as multiple segments to be treated by the routing server as a single junction node with multiple inputs and outputs. Considering a complex intersection as a single point has several beneficial properties:

  • Traffic speed data for each path through the junction box can be collected separately.
  • Turn restrictions can be separately controlled for each path through the junction box.
  • Voice prompts can be separately controlled for each path through the junction box.
  • Turn instructions can be separately controlled for each path through the junction box.
  • Additional beneficial features of a junction box will be listed here as they become available.

For ETA purposes, the routing server does not consider segments wholly within the junction box, but rather treats the junction box as if all the segments which enter or exit the the junction box are connected to a single junction node.

Junction boxes are considered only by the routing server. Junction boxes have no visibility in the client or on the live map. Junction boxes do not affect the search engine; the origin or destination of a route may be contained in a junction box.

Junction boxes are only considered by the routing server when the route fully traverses through the junction box. Routes that start or end inside a junction box will use the underlying segments for routing and instructions. This means that junction box speed data, route restrictions, and instructions that have been overridden by the junction box will not be used by the app in these cases.

Examples where this could occur are:

  • When a route's destination is inside the bounds of a junction box;
  • When a route's origin is inside the bounds of a junction box;
  • When a route is recalculated inside the bounds of junction box, such as after a missed turn.

Improving data collection

Waze routing servers use junction box traffic data instead of the underlying segment and node traffic data, though Waze continues to collect both sets of data.

A complex intersection can skew turn delay transition speed data. At first glance the following example seems like a pretty simple intersection, but if it usually experiences heavy traffic this intersection could be collecting bad data.

Assume that all the roads are two-way and all turns are enabled. Consider the drivers going from A to E, and from A to F, when there is a traffic jam for the left turn (at point D), but traffic going straight through D is flowing fine.

Without a junction box, the traffic from point A to point C is considered to be the same for both the red and the blue cars. The same statistical data is gathered and the average speed skews the ETA for everyone. The turn delay data is only different for the red and blue cars on the one segment before the turn at D, from C to D.

Adding a junction box solves this problem. With a junction box, historical and real time data are collected separately for each one of the possible routes through the intersection - all 12 of them.

  • A ➡ B
  • A ➡ E
  • A ➡ F
  • B ➡ A
  • B ➡ E
  • B ➡ F
  • E ➡ A
  • E ➡ B
  • E ➡ F
  • F ➡ A
  • F ➡ B
  • F ➡ E

With a junction box the paths of A to F, and A to E are being measured separately, the traffic jam for the red cars turning at D does not have a negative effect on the blue cars going straight through D. Their ETAs are being recorded separately.

 Fixing update request example  Just click on the expand link to the right ------>

Thus, URs resulting from the inability to distinguish left turn delays from straight through traffic can be dealt with using the junction box. Draw a junction box over the intersection where the straight traffic is being improperly detoured, in order to provide better data collection and hopefully better routing. U-turns that are legal should not be restricted.


Link to fixing update request example

 Understanding inside a junction box example  Just click on the expand link to the right ------>

There are many types of scenarios where a junction box may be indicated, this sample is used just to explain the function of a junction box, and not meant as guidance on where to use them.

To illustrate the improving data collection concept, let's take a look at this intersection. There are five segments entering/exiting the junction box (segments which are only partially inside the junction box). There is one segment which is wholly inside the junction box. If there were no junction box at this intersection the individual turn delay AKA the time it takes to turn from one segment to the next data for the outer five segments would be merged together at the inner four segments, and be distorted. The junction box here alleviates the problems with collecting accurate turn delay transition timing caused by the short segments in the middle.
Link to understanding inside a junction box example

 Timing example  Just click on the expand link to the right ------>

If a junction box is drawn around these intersections (below left), then when considering a route that would traverse a segment within the junction box, the routing server treats the intersection like one large junction node for the purpose of calculating transition timing AKA turn delays (below right).

A route path from point A to point B (westbound Mill Grove Rd to southbound Idlewild Rd to westbound Indian Trail Fairview Rd) is treated as a single transition, even though in actuality it traverses four segments (3 transitions). The green path is the actual junction box route in WME.


Link to timing example

Turn arrow tooltip on a junction box exit arrow

The turn arrow tooltip has five elements: Voice prompt, Instructions, Restrictions, Switch Route (when applicable), and Difficult turn. Junction boxes have no effect on these elements, unless these elements are changed in the turn arrow tooltip.

 Turn instructions example  Just click on the expand link to the right ------>

Looking back at our timing example path, going from point A to point B (westbound Mill Grove Rd to southbound Idlewild Rd to westbound Indian Trail Fairview Rd), let's analyze how the junction box works with voice prompts. Our path is considered for routing as one transition, and judging by the angles it would be a straight transition making it a best continuation with no voice prompt. But as we just said 'junction boxes have no effect on voice prompts', therefore the actual voice prompt given for this path (point A to point B) will consider the three junction nodes and produce:

  • Turn Left onto Idlewild Rd, and then
  • Turn right onto Indian Trail Fairview Rd".

This is to say that the voice prompts are still controlled by the actual names, types, and angles of the segments within a junction box.

For more details on Waze selected voice prompts, see How Waze determines turn / keep / exit maneuvers.

Link to turn instructions example

Voice prompt

  • If a voice prompt is added in the junction box's exit arrow tooltip, then all internal Waze selected voice prompts are removed and the voice prompt is announced at the first junction node using the first named road segment on that route from the first junction node.
  • If a voice prompt is added in the junction box's exit arrow tooltip, the voice prompt will be given at the first junction node. Unless there is an editor selected voice prompt (other than Waze selected) on a node along the path, then the editor selected voice prompt on the node will override the junction box's exit arrow voice prompt (junction box's exit arrow voice prompt will not be given).
  • If a voice prompt is added in the junction box's exit arrow tooltip, and lane guidance has also been added to the segment entering the junction box at the first node inside the junction box, the lane guidance will be displayed with the voice prompt. This can be undesirable, and it is recommended to check the lane guidance when adding a voice prompt to junction box paths.

 Voice prompt example  Just click on the expand link to the right ------>

In the example below, adding a voice prompt to the junction box’s exit turn arrow tooltip can cause problems with the correct location of the voice prompt and the announced road name.

          
Eastbound  State Hwy 22E  has a left exit to  OR-99E BUS / Keizer / Portland . There is an "exit left" voice prompt
on the junction box's route which exits for that ramp. The junction box's voice prompt overrides all the internal Waze selected voice prompts and the voice prompt is "Exit left to State Hwy 22E" at junction node A in the picture above, which gives the user very bad instructions. The voice prompt is given too early (just before crossing the water) and the wrong road name is announced. This is because the junction box's voice prompt is announced at the route's first junction node within the junction box and utilizes the first named road segment after that junction node. If you take off the primary name of the State Hwy 22E 's two segments between that first junction node and the ramp, then the first named road segment becomes the ramp segment. This does have the desired road name announced, but the announcement will still be just prior to crossing the water.
  • Moral of this example is, don't put the exit left voice prompt on the junction box exit arrow. Instead, just have it on the major highway's turn arrow tooltip and it should announce the correct ramp name at the correct location.

Link to voice prompt example

Instructions

Similar to the Instructions on turn arrow tooltip, Instructions is an option on a junction box exit arrow tooltip. The Turn instructions panel has the same options but there are special considerations when the options are used on the junction box exit arrow.

Visual instructions

Visual instructions can be added to a junction box's exit arrow.

  • Just like voice prompts, visual instructions will be given at the first node that the path encounters through the junction box.
  • Unlike JB voice prompts, JB visual instructions will work together with subsequent node-based visual instructions inside the junction box. In these cases the junction box's visual instruction will be shown at the first node, and then the node-based visual instruction(s) will be shown at the subsequent node(s) through the junction box.
  • When adding visual instructions to a junction box's exit arrow do not add visual instructions directly to the first node of that route, to avoid a conflict between the junction box's visual instruction and the node-based visual instruction on that first node.
  • Both node-based and junction-box-based visual instructions require an associated navigation instruction in order to be visible in the app, either resulting from default behavior, a voice prompt or a View and hear lanes override. If the driver is not told to turn, exit, continue, etc. at a node, no visual information can be displayed there.

Adding visual instructions to a junction box route is useful for situations where multiple signs are displayed for a single turn, with each sign pertaining to the next turn. For example, in complex interchanges it's common to have multiple lanes exit the highway together at one place and then split apart a short distance after exiting, with the different lanes marked by different signs. Using a JB visual instruction allows the driver to see only the visual instructions that pertain to their route.

 Visual instructions example  Just click on the expand link to the right ------>

At the first node there are signs for I-75 N » Dayton, Exit 1D: US-50 W • River Rd, and Exit 1C: Fifth St

The example route is traveling northbound on I-75 to Exit 1D: US-50 W • River Rd where I-75 N and I-71 N fork. At the first node on our route there are signs for I-75 N » Dayton, Exit 1D: US-50 W • River Rd, and Exit 1C: Fifth St. Trying to display all of this visual information information at the first node would be difficult to accomplish in one visual instruction; it would give the driver a lot of information they don’t need; it would also make the verbal instructions unnecessarily long to the point where it could truncate future instructions. Adding visual instructions to the junction box path we can give the driver instructions only what they need to see and hear for their route to Exit 1D: US-50 W • River Rd.

Adding only these instructions will give clear directions for this route

First, add this on the junction box exit arrow tooltip for the Exit 1D: US-50 W • River Rd route
Then, at the I-75 N / Exit 1C: Fifth St fork add the view only lane guidance on the highlighted segment
Finally, at the fork for I- 75 N add the visual instruction for Exit 1D: US-50 W • River Rd on the turn arrow tooltip

This will result in the following instructions in the app

The first instruction approaching the first node entering the junction box
Followed by a visual only continue instruction at the second node in the junction box
The last instruction will be for Exit 1D: US-50 W • River Rd

Link to visual instructions example

TTS

Even though the TTS (text to speech) box will show the name of the exit segment in gray, this name may not actually be what's spoken. If the name of the exit segment is required in TTS, be sure to confirm it by clicking the TTS field, then clicking Apply, before saving the junction box turn instruction.

Restrictions

Partial restrictions, including time-based restrictions, can be added to junction box paths just like they are to normal node-based turns. In fact, when a junction box is created, any partial restrictions that existed on segments and turns within the junction box are automatically copied into the applicable junction box paths, making these JB exit arrows yellow. This is similar to how drawing a JB over nodes with full turn restrictions causes applicable JB paths to have red exit arrows. After a junction box is created, all restrictions are controlled by hovering over its exit arrows and making changes there rather than on underlying segments or turns.

Internal turn restriction(s)

The turn restrictions or time based turn restrictions for junction arrows on segments that enter the junction box are visible on the junction node within the junction box as of January 2020. Selecting that segment displays turn restrictions just like selecting a segment that is not in a junction box. There are also turn restrictions or time based turn restrictions on each exit arrow of a junction box route, this is because the junction box has taken over the exit from the entry segment and this(these) turn restriction(s) is(are) now the turn restriction(s) on the junction box exit. The same is true for time based segment restrictions on segments that enter the junction box.

Switch Route

There can only be one route from a specific entrance to a specific exit in a junction box. In cases where there is more than one routing option available, then the Switch Route option will appear. The switch route option will allow you to select the appropriate route through the junction box. The allowed route through a junction box should always be enabled and shown with the green path. A red exit turn arrow means that any route from the selected entry segment to the selected exit turn arrow will be disabled

 Switch Routes example  Just click on the expand link to the right ------>

Example of the route selection in a situation where there are some alternate looping routes available. The first picture shows the typical green path for eastbound Franklin St NE as it continues across Rhode Island Ave NE. If the straight path was prohibited by a Jersey barrier and signage, then the editor can select the alternate path of southbound 15th St NE to northeast-bound Rhode Island Ave NE to eastbound Franklin St NE. The second route as shown in the second picture was set by clicking the Switch Route forward button one time.

          

Using the same example, the first picture below shows the typical green path for eastbound Franklin St NE as it continues across Rhode Island Ave NE. Disabling the path of southbound 15th St NE to northeast-bound Rhode Island Ave NE to eastbound Franklin St NE will disable all paths for eastbound Franklin St NE continuing through the junction box. Which is not the same as allowing the green path for eastbound Franklin St NE as it continues across Rhode Island Ave NE.

          

Link to switch Routes example

Difficult turn

Difficult turns and time based difficult turns are available on junction box routes the same way they are used on segment turn arrows.

  • Junction box difficult turns may be useful for paths that are legal but directly contradict guide signs and/or require quick weaving through multiple lanes of traffic, such as entering a highway from the right and then quickly exiting to the left.

Controlling turns

Junction boxes permit disabling multi-segment turns that are difficult to control in complex intersections. Without a junction box, controlling complex turns may require adding artificial segments and/or reducing the intersection to a single point using a bow-tie configuration.

 Controlling turns example  Just click on the expand link to the right ------>

Take the intersection of (Leesburg Pike & Fairfax Sq/Fashion Blvd, Tysons Corner, VA) as an example. There, some turns are not allowed based upon on which street it was originally approached from. Additionally U-turns are prevented in both directions.

When traveling northwest on  Leesburg Pike , it appears that you may turn right using the at-grade connector (AGC) to  Fashion Blvd  or left onto  Fairfax Sq  or continue on  Leesburg Pike . If you were already traveling northwest on  Leesburg Pike  before  Exit 47A: SR-7 W / Leesburg Pike / Tysons Corner  or if it was entered from  Mervis Way  to  Towers Crescent Dr , then you are allowed to make either turn or go straight. But if you entered Leesburg Pike from I-495 S regular lanes' Exit 47A ramp, then the left turn is prohibited to Fairfax Sq; you can only turn right or go straight. The left is prohibited by a sign at the ramp.

Without a junction box here our options to reflect these restrictions on the map would require creating artificial parallel segments connecting north from  Exit 47A: SR-7 W / Leesburg Pike / Tysons Corner  to its junction node with  Fairfax Sq  with the connections from  Mervis Way  to  Towers Crescent Dr  that don't turn onto this artificial parallel road. This option separates the traffic flow of those vehicles approaching on  Leesburg Pike , from those vehicles approaching from  Marvis Way  and visually disrupts the map with the parallel segments. Another option for other areas is to layer the segments, which is discouraged by Waze since layered segments can cause data collection problems. In either case we are adding artificial segments which are unnecessary and difficult to maintain on the map.

          

With a junction box in place, we don't need to add any extra segments, to artificially alter any segment's geometry, or to create a bow-tie. We use just the one segment of  Leesburg Pike , and draw the junction box to include the junction nodes with the ramp/major highway all the way to the major highway/left and right local streets. We can then use the junction box's turn restrictions to select which paths through the junction box should be allowed, and which should be disallowed.

Have the entire junction box within the editing screen, then select the junction box. The available entrances show up as a list to the left of the editing screen. Small white arrows appear on the junction box boundary to indicate a segment entering the junction box. If the entire junction box is not selected then all of the entrances or even no entrances may appear in the list.

Click on either an entrance from the list to the left or the appropriate small white arrow. This displays the routes from that entrance. The initial selection from the  Exit 47A: SR-7 W / Leesburg Pike / Tysons Corner  shows seven (7) Green Turn restrictions and one (1) Red Turn restriction. The exits from this segment are listed to the left. All routes are initially enabled as a Green Turn restriction UNLESS there is a simple two segment intersection that has a Red Turn restriction. In this example nw bound Leesburg Pike's right turn to Fashion Blvd is prohibited because of the At grade connector; therefore the initial junction box has that TR as red. Also note that the selected entrance segment is colored a light blue, the long green route along the allowed paths, and the very short red "non-route" on the one prohibited path. The list on the left shows the same colored Turn restriction as is on the segment. Clicking the list to the left or the actual junction box exit arrow will toggle the Turn restriction. Hovering over a junction box exit arrow shows the turn arrow tooltip.

Now we will restrict the left turn from northwest-bound Leesburg Pike to Fairfax Sq, based on the restriction sign at the ramp. Click on the green arrow, and it turns to a red arrow. After clicking save we have the prohibited turn easily and simply mapped! Both the turn restriction on the junction box and the junction exit list to the left are displaying the prohibited restriction. Also there is a long red "non-route" on the prohibited route.

Link to controlling turns example

Where to use

Junction boxes are suitable only where their functions are required. If problems are easily solved with other features such as turn restrictions, a junction box should not be used. Appropriate reasons to use a junction box:

  • To prohibit a route on the same exit path when there are two different entrances, where using a regular turn restriction would also prohibit other routes that should be allowed.
  • To prohibit U-turns in one or more directions on median segments between divided roads at H or # intersections
  • To collect more granular data on traffic that backs up unequally across different lanes of a road through multiple junction nodes, due to conditions like heavy weaving between entrances and exits on a freeway, or busy left turns through an intersection with long cycle times
  • To ensure proper routing and data collection through intricate intersections containing multiple short segments
  • To provide more appropriate voice prompts for movements through intersections, where segment geometry and node-based voice prompts would provide improper navigation instructions
  • To provide more accurate turn instructions for a turn with multiple signs for different destinations past the turn
  • To correct routing issues or improper turn instructions in roundabouts

Drawbacks

Certain things cannot be done to segments and nodes that are part of a junction box without first deleting the junction box. These include:

  • Changing a segment's direction between two way and one way
  • Moving a junction node across the boundary of a junction box
  • Adding or deleting a junction node inside a junction box
  • Adding, deleting, connecting or disconnecting a segment inside a junction box

For these reasons, junction boxes should not be used for every intersection. Where they are used, turn information should be applied to node-based turns rather than junction box paths, if possible, to avoid rework if the junction box needs to be deleted in the future.

Note that for many years it had been impossible to cut or merge a segment, even if only an end of it was part of a junction box; the junction box had to be deleted first. This is no longer true.

Editing

A Junction box is created by selecting Junction box from the draw segments menu (Shortcut key J). Click at one vertex of the junction box. Continue to click at each vertex of the box until the box surrounds all the junction nodes of the intersection. Double click to complete the box.

  • The boundaries of the box cannot be changed once created. If you need to change the shape of the junction box, you must delete it and create it again.
  • Before creating a junction box at an intersection, make sure that there are no incorrect turn restrictions including U-turns. Routes through the junction box that are prevented by existing turn restrictions cannot be enabled in the junction box.
  • The routes through a junction box can be edited when it is selected. To select a junction box, click on it.
  • When the junction box is selected, the left pane will show the potential connection paths through the junction box as illustrated above. Clicking the check box next to each connection path toggles between enabling or disabling routing between the indicated entry/exit pair.
  • The left pane includes a button to "Select included segments." Clicking this button will select all the segments with both ends in the junction box (these are the segments that are not considered for ETA routing purposes).
  • The left pane includes a name box and an address. A name can be added to the name box and the address may be edited. However, currently the name and address of a junction box has no effect.
  • To delete a junction box, select the junction box and click the delete button  (Shortcut key Del).
  • Changes to junction boxes (and adding new junction boxes) require a tile update to affect routing.
  • If a junction box is deleted and then recreated using the same segments before too much time passes, the Waze routing servers can use the previously stored junction box data for any segment IDs that have not been deleted.

Effects In Editor

Junction boxes can only be edited by editors of at least rank 4. Junction boxes appear in the Waze Map Editor when the Junction Boxes layer is turned on; the two pieces of paper in the upper right of the map editing area. Junction boxes appear as a polygon around all the junction nodes of an intersection.

All segments that enter the junction box are only partially editable. Selecting a segment that is part of a junction box results in a message: "Some attributes cannot be edited. This segment is part of a junction box. Use the junction box to edit this segment's restrictions." For further details on which attributes can be edited and which cannot, see when to use.

Selecting the junction box causes the left pane to display the junction box properties. The properties show the editor that created the junction box with the date and the editor of the last update to the junction box. If changes are needed to the junction box or segments associated with the junction box, contact the identified editor or other rank 4 or higher editor in your area.

The left pane shows potential entry/exit pairs with a check box ticked for each pair enabled for routing. Note that only entry/exit pair paths which are fully visible on screen are displayed. So make sure you can see the whole boundary of the JB to be sure you're getting a full list of entry/exit pair connections in the left pane.

  • Routes through the junction box that pass through a single junction node (and do not cross any JB internal segments) are not controlled by the JB. Instead, they are controlled by turn restrictions in place when the junction box is created.
  • Routes through the junction box that are prohibited by red turn restrictions between segments within the junction box are not considered.
  • Difficult turns can be set on the junction box's turn restrictions and do affect routing in the server if the user has the appropriate setting selected.
  • Any green or yellow turn restriction on a junction box can have the difficult turn attribute added for either 24/7 coverage or with time/day/date restrictions. Please refer to the Difficult turn section for editing directions.

Switch route selection

  • Select the entry segment of the junction box that you want to compare routes on.
  • Hover over the appropriate exit turn arrow that you want to select the desired route.
  • The switch route selection will appear between the restrictions and difficult turn options in the turn arrow tooltip box.
  • Click the forward or back arrow to cycle thru the allowable routes.
  • For a route that you wish to allow, always select the green route from the entry segment to the exit turn arrow. In other words do not select a route that should be disabled, select the route that should be allowed.
  • A red arrow on the exit turn arrow means that any route from the selected entry segment to the selected exit turn arrow will be disabled

If there is only one route available in the junction box then the switch route selection will not appear. Note it may take several clicks to get to the desired route.

Errors when editing

  • Max size - The length of a junction box cannot exceed 0.01° latitude and 0.01° longitude. In terms of distance, the north-south linear limit is always 1110m (0.01°), while the maximum east-west linear limit varies depending on your latitude, because the length of a longitudinal degree decreases as you travel further from the equator. In the southernmost part of the continental US, 0.01° longitude translates to about 1010 m; along the Canadian border (49° N), however, 0.01° longitude is about 730 m. So the max size of a JB in Key West is about 1110 m x 1010 m (N-S "height" × E-W "width"), but along the Canadian border the max size of a JB is 1110 m x 730 m (N-S "height" × E-W "width").
  • Two junction node minimum - A junction box must include at least two junction nodes. Two junction nodes within the junction box must be connected by a segment. A junction box with only one junction node cannot be saved.
  • No overlapping - A junction node cannot be included in multiple junction boxes.
  • Sixteen paths max - No more than 16 controllable entry/exit paths can pass through a single-junction node within a junction box. A save error occurs if a junction node has more than 16 connections. This also counts the adjacent connections not displayed in the routing box list that do not cross any of the internal segments like A to G, D to J, etc.
  • Enabled U-turn on a two-way segment - Note that having U-turn(s) enabled on a two-way segment inside the junction box will increase the number of paths and can lead to the saving error message.
  • Non-navigable segments - Junction nodes within a junction box can't be connected to non-drivable road types unless connected by a virtual node. Connected non-drivable road types will generate a save error and should be disconnected from the junction within the junction box.

Adding complexity

Adding segments or junction nodes to an intersection to workaround the "one connection for every entry/exit pair" and "no more than 16 connections per node" limitations is not recommended. If such a workaround is required, please consult with your country manager or regional coordinator.

Final Checks

  • For the final configuration, if there is not an allowed path from the entrance segment to the exit segment then there needs to be a red turn restriction arrow and red route/path.
  • For the final configuration, if there is an allowed path then there needs to be a green (or yellow) turn restriction arrow and a green route/path.
  • It is recommended to save the final configuration of the junction box, then either soft or hard refresh the map. After these steps recheck every route from every possible entry segment to each exit segment. This is recommended because occasionally during the save process WME will set an incorrect route and rechecking each route through the junction box will catch these errors.