File:MapRaidColumbia.jpg View history

(→‎Definitions: caption of 37 makes readers think 37 is a magic angle. Really "< 45" is the important point.)
(No difference)

Revision as of 14:07, 1 April 2015

Template:Construction

A somewhat simplified description of this is covered in the Junction Style Guide. Additional routing information is covered in the article Routing server.

The original text provided by Waze staff which inspired this page was proven slightly inaccurate, and was difficult to comprehend it was replaced on 06/22/2014.

A simplified easy to understand interactive version of this page is available here.

Definitions

To better be able to put the algorithm into words, we have to name each of the road segments that connect to a junction. These are subjective names, they are relative to which segment the junction is being approached from, and which segment the routing server wants to navigate to after passing through the junction.

Start with the junction in the middle.

  • s-in: The segment the vehicle is on as it approaches the junction will be called s-in.
  • s-out: The segment the vehicle is being routed onto after it passes through the junction will be called s-out. This can be any of the other segments connected to the junction, which will also be one of the segments named below as s1, s2, ... etc..
  • s1, s2, s3, s4, etc.: All the segments connected to the same junction, (including s-out) will each be named consecutively as s1, s2, etc., for as many segments as there are… sN. One of these numbered segments will also be s-out.
  • Best Continuation: One of the segments leaving the junction will be considered the 'Best Continuation'. This is the segment that Waze determines is what drivers would consider the "no turning path" or "going straight" through the intersection. This segment will get a 'continue' instruction, which is ignored by the client app. The criteria Waze uses to determine which segment is the 'Best Continuation' is explained below.
  • Primary road: refers to a highway segment ( Motorway ,  Major Highway , or  Minor Highway ), not a  Primary Street .

  • The angle is the angle from the origin to the destination. A perfectly straight road with a junction in the middle would have a turn angle of 0°. The angle then gets wider as you turn to either side. A perfect left or right turn would be 90°. A U-turn at a junction between two segments would represent a 180° turn.
    (A turn less than How Waze determines turn / keep / exit maneuvers/Stay threshold will give a keep/stay instruction, vs. a turn more than How Waze determines turn / keep / exit maneuvers/Turn threshold which gives a turn instruction.)
    • In technical terms: The angle between the linear segment between the last geometry node of s-in and the junction and the linear segment between the junction and the first geometry node of sN is the supplementary angle to the angle of sN.
Angles
Standard Angles Less than 45° Angle 90° Dogleg Geometry Node
  • A Normal Roundabout is one which has
    1. Four (4) or less junction nodes,
    2. All exits leave the roundabout (from the perspective of s-in) at a normal angle.
      • A Normal Angle is 0° or 90° to either side, ±15°. (See roundabout angle for more information)
  • A Non-Normal Roundabout is one which has
    1. Five (5) or more junction nodes,
    2. At least one exit leaves the roundabout (from the perspective of s-in) at a non-normal angle.
      • A Non-Normal Angle is anything other than; 0° or 90° to either side, ±15°. (See roundabout angle for more information)


Visualize how segments are subjectively named in the 'Best Continuation' Algorithm
Visualize how segments are subjectively named in the 'Best Continuation' Algorithm

Best Continuation

In order to determine if s-out is the 'real' continuation of s-in, Waze does the following:

If the angle between s-in and s-out is less than How Waze determines turn / keep / exit maneuvers/Stay threshold, it is selected as the real continuation, unless one of the following are present.
  • There is another segment (s1, s2, ...sN) with an angle less than How Waze determines turn / keep / exit maneuvers/Stay threshold which has a better matching segment name & segment type to s-in than s-out does. (e.g. it has the same segment name and type as s-in and s-out doesn't; it has the same segment name as s-in and s-out doesn't; it has the same segment type as s-in, and s-out doesn't.) Segment name is more important than segment type.
Template:As of This algorithm was changed to also factor in alternate names. This algorithm is still correct when none of the segments have alternate names. If there are alternate names on any of the segments there are a few modifications (in bold).
  • The order of preference for Best Continuation is;
  1. Primary name + Type match
  2. Alt name + Type match
  3. Primary name match, OR Primary name <=> Alt name Cross-match
  4. Alt name match
  5. Type match
  • City names have no affect on matches.

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

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

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

  • It will not work if all three segments at a split have a matching Primary name.
  • It will work even the OUT segment (the one leaving the split) has no Primary name.

To see the current algorithm flow (in text) open this Google sheet Template:ForumLink

~Template:Username

If a 'best continuation' is determined, Waze will not give an instruction going onto that segment.

Flowchart defining the steps the algorithm runs through.
Flowchart defining the steps the algorithm runs through.

Exceptions

A junction with more than one segment leaving it at an angle less than How Waze determines turn / keep / exit maneuvers/Stay threshold can give an instruction to all the segments, or none of the segments. Some of these scenarios are listed below:

  • If, of all the segments leading out at less than How Waze determines turn / keep / exit maneuvers/Stay threshold, no one segment is a better match than any other for name or segment type, all segments will all get instructions. This applies even if one of those has a departure angle of 0° from s-in. (This is also touched upon in the wayfinder section.)
  • There will not always be a best continuation.
    • When s-out has the same segment name and segment type as s-in, but another s-N also has the same segment name and type as s-in, neither will be considered the best continuation.
  • A segment (s1, s2, ...sN) leaving the junction at less than a How Waze determines turn / keep / exit maneuvers/Stay threshold angle, which has the turn into it from s-in restricted in WME will not be considered in this algorithm as a 'best continuation', or as a sN, even if it has a departure angle of 0° from s-in.
  • A segment with no name (the "none" check-box for street name is checked) is considered to have "no-name" as a name for the Best Continuation algorithm. So two segments with no name, will be considered to have identical names, even if they would inherit different names for TTS.

The algorithm

The description below fits a right turn in a Right-hand traffic country (e.g. the USA). Left turns are symmetrical to right turns.

The algorithm iterates over a list of conditions. As soon as a condition is met, the relevant instruction is determined, and the algorithm terminates.

The list of conditions

  1. If the junction has only 2 segments, the instruction is: 'CONTINUE'.
    By design the client does not give this instruction.
  2. If s-out is determined to be the best continuation of s-in (see explanation on 'best continuation' above), the instruction is: 'CONTINUE', which implies that the driver is not turning (i.e., going straight through the junction).
    By design the client does not give this instruction.
  3. If the angle between s-out and a straight line is larger than 45 degrees, the instruction is: 'TURN RIGHT'.
    • This is because we assume that on primary roads ( freeways ,  major highways , and  minor highways ), turn angles are less than 45 degrees (no sharp turns on higher-throughput roads). Therefore, you never have something called an "exit" that has such an angle, and the instruction should be TURN, not EXIT.
  4. If s-in is a primary road ( FW ,  MH ,  mH ) and s-out is not a primary road ( FW ,  MH ,  mH ), the instruction is: 'EXIT RIGHT'.
  5. If s-in is a Template:Ramp and s-out is neither a primary road ( FW ,  MH ,  mH ), nor a Template:Ramp, the instruction is: 'EXIT RIGHT'.
  6. If none of the above conditions are met, the instruction is: 'KEEP RIGHT'.

Graphic flowchart

This is a static graphic flowchart starting from a junction point and flowing through (all) the possible configuration options, to hopefully cover any scenario. It culminates in all the possible navigation instructions. This chart includes roundabouts, Left Hand Traffic, and Right Hand Traffic. For an interactive version with more descriptions and illustrations see the interactive page.

Graphic flowchart for algorithm how waze determines turn, keep, and exit instructions. For Junctions, and roundabouts. (click to enlarge)

Special considerations

  • In some cases, a junction node could have more than two segments, but the routing server will only consider two of them as valid and therefore, the maneuver will be 'Continue straight'. This happens when turns into some of the segments are restricted, the routing server then skips those segments and ignores them when determining the 'Best Continuation'.
  • Turns can be restricted or unrestricted. In specific scenarios you may not be able to see this in WME - see RevCons for more information. There are external scripts which show this information (and some allow it to be easily corrected).
  • The original text mentions special behavior for locked nodes. For example, in this case (image below) - assuming the node is locked - heading south, the right turn will be considered 'Continue straight' as the routing server has no other option and there's only one possible segment to be s-out.
    • If the node was not locked, it is most likely that Waze would tell you to turn right. Driving against the direction is a high penalty, and so is a left turn where a turn is not allowed. However, it would still have been an option, which is why the routing server would have called it 'turn right'.

    • This could be confusing, especially since there's no external indication on whether or not a node is locked at the moment.
    • The author and those involved in the discussion have never experienced a locked node which didn't follow the algorithm for determining the instruction.

File history

Click on a date/time to view the file as it appeared at that time.

Date/TimeThumbnailDimensionsUserComment
current10:13, 30 November 2015Thumbnail for version as of 10:13, 30 November 20151,024 × 683 (103 KB)Maintenance script (talk | contribs)Importing file

The following file is a duplicate of this file (more details):

There are no pages that use this file.

Metadata