The new Waze Wiki, aka Wazeopedia, is now live at Wazeopedia.waze.com! While this legacy wiki will remain accessible for the time being, it is no longer updated by the community. For the most up-to-date guidance, please visit your local Wazeopedia.

Please do not make any more updates to these legacy wiki pages, all future updates should be made in your country's local Wazeopedia.

Clock over a larger globe

Difference between revisions of "Best map editing practice"

From waze
Jump to: navigation, search
(When to Use Ramps in an Intersection)
m (New Roads)
 
(188 intermediate revisions by 49 users not shown)
Line 1: Line 1:
<center>[[Area_Manager#Area_Manager_FAQ|Back to Area Manager FAQ]]</center>
+
<!--if the section parameter is defined, do not place the visible banner, only as the code block for the top of a section-->{{GlobalMark/visible}}
 +
<!--
 +
#####-----#####-----#####-----#####-----#####-----#####-----#####-----#####-----
 +
####    This page has been curated  ####
 +
####    to be included in the new    ####
 +
####    Wazeopedia - GLOBAL Wiki.  ####
 +
####    Please do not make any      ####
 +
####    edits on this page without  ####
 +
####    PRIOR CONSENSUS in the Wiki  ####
 +
####    Updates and Discussions      ####
 +
####    forum thread for this page.  ####
 +
####    If a specific forum thread  ####
 +
####    for this page doesn't exist  ####
 +
####    please start one.            ####
 +
####        www.waze.com/forum/      ####
 +
####        viewforum.php?f=276      ####
 +
#####-----#####-----#####-----#####-----#####-----#####-----#####-----#####-->
  
Like Waze, this page is a community effort and a work in progress.  Many helpful pages already exist on the responsibilities of an [[Area Manager]], how to use [[Cartouche_-_Update_map|Cartouche]], identify and solve [[How_to_fix_scan_problems_(problems_1-31)|map]] [[How_to_fix_merger_problems_%28problems_50-60%29|problems]], set standards for [[How_to_label_and_name_roads|labeling roads]], and a general [[FAQ]].  The purpose of this page is to help Area Managers & others design maps that work best for the end-user--the driving public--while minimizing the amount of (re)work you have to do because of common mistakes or subtle limitations of the tools.
+
{{ReturnTo | Editing manual | the editing manual}}
  
At the moment, I am [http://www.waze.com/forum/ucp.php?i=pm&mode=compose&u=962545 taking suggestions via PM] for content for this page: topic suggestions are good, but links to insightful forum conversations, or even links to other Wiki pages, would be better.  I won't be able to incorporate every suggestion, but I will appreciate all of them.
+
The purpose of this page is to help all map editors design maps that work best for the end-user--the driving public--while minimizing the amount of (re)work you have to do because of common mistakes or subtle limitations of the tools. For those who are an [[Area Manager]], many helpful pages already exist on your  responsibilities, including how to use [[Waze Map Editor]], identify and solve [[Map problems]] and  [[Update requests]], set standards for [[Road types and names|labeling roads]], and a general [[FAQ]]. These same sources are incredibly useful for newer editors as well and should be reviewed to become familiar with the various elements of Waze map editing before getting too deep with your edits.
 +
 
 +
If you find something missing from this page or any page of the Wiki, either be bold and edit the page to add or modify the information (if you are confident that is how it works), or you can post a comment in the [http://www.waze.com/forum/viewforum.php?f=276 Wiki improvement forum].
 +
 
 +
{{LocalGuidance}}
 +
<br/>
 +
{{TOC}}
  
 
== Overall Goals ==
 
== Overall Goals ==
  
 
=== Usability ===
 
=== Usability ===
When it comes to the map, the first & foremost goal of editing is to provide the driver with a map that is easy to follow on a small display, and to produce sensible verbal instructions when (and only when) they are needed.
+
When it comes to the map, the first and foremost goal of editing is to provide the driver with a map that is easy to follow on a small display, and to produce sensible verbal instructions when (and only when) they are needed.
  
 
=== Simplicity ===
 
=== Simplicity ===
Line 14: Line 36:
  
 
=== Retention ===
 
=== Retention ===
As a result of people driving over them, road segments retain certain information (e.g., average speed) that is used in route optimization. When a segment is deleted, that information is discarded. Given a choice between deleting a tangle of segments and creating new ones in their place, vs. untangling them and reusing them, it is often better to "recycle".
+
Because Waze users drive over them, road segments retain certain information (e.g., average speed) that is used in route optimization. When a segment is deleted, the information in the segment is discarded. Given a choice between deleting a tangle of segments and creating new ones in their place, vs. untangling them and reusing them, it is better to "recycle".
  
 
== In Practice ==
 
== In Practice ==
  
=== When (Not) to Split a Two-Way Road ===
+
=== Dividing and un-dividing divided highways ===
It is rarely a good idea to split anything short of a freeway or major highway--which use nothing but ramps to enter/exit--into two one-way roads.  If two roads cross at an intersection, don't even think about splitting either of them into two one-way roads.  Intersections become [http://www.waze.com/cartouche/#?zoom=7&lat=42.24864&lon=-71.00372&layers=BTFTFFFFFFFFFFFFFTTTT needlessly complicated]--which means the client display gets cluttered, and the verbal prompts become confusing and nonsensical.
+
==== {{anchor|When (Not) to Split a Two-Way Road|When to Split a Two-Way Road (and when not to)|When to divide a TwoWay Road (and when not to)}}When to divide a two-way road (and when not to) ====
 +
<!-- After this anchor is updated to the new term, update the glossary to link back here for the entry [[Glossary#Dual carriageway]] -->
 +
Generally, a road should be un-divided unless it meets any of the requirements for dividing a road. When initially reviewing whether to divide or "un-divide" (merge back together) a roadway, consider these points first:
  
When you have a surface road--even a multi-lane surface road with a curb or a divider in the middle--turn on the "Separating line" checkbox, and use connectivity to prevent Waze from trying to send people on left turns across the center divider.
+
# The default representation for any roadway is a single 2-way segment, even if the physical roadway is divided. Dividing a roadway carries with it the burden of proof that the change will improve the usability and/ or simplicity of the Waze map.
 +
# If a road is currently working with no problem reports, consider leaving it as is.
 +
# If the area has an Area Manager, consult with them before dividing/un-dividing. If the area does not have an Area Manager and after reviewing the formal guidelines below you are unsure which way to go, consider sending a [[Waze Map Editor#Permalink|permalink]] of the road to the [http://www.waze.com/forum/viewforum.php?f=8 map editing forums] to get additional feedback from other editors.
 +
# Try to avoid switching roads back and forth between being divided and 2-way. For example, if most of the road is clearly divided and only parts would be considered a single two-way road, consider leaving it all divided. If only a small portion seems better off divided, consider keeping it all 2-way.
 +
<br/>
  
Some more formal guidelines - '''A road should be split if:'''
+
'''A road may be divided when <u>any</u> of the following conditions are met:'''
  
* There is at least 5 meters of non-drivable surface between directions of travel. (This means a median of some type like cement, planter boxes, trees, or just grass.
+
* It is an Interstate Highway (USA) or other Limited Access Highway using the "Freeway" road type,
* GPS tracks show a clearly definable gap/blank area between the color-by-azimuth arrows at the 100m zoom level.
+
* GPS tracks show a clearly definable and continuous gap (blank area) between the [[colour-by-azimuth]] arrows at the 100m/500ft [[Map_Editor_Interface_and_Controls#Scale|zoom level]],
 +
* multiple houses or businesses with no off-street parking are located directly on the street but are not accessible from the opposite direction of travel due to lengthy median, obstruction, or traffic control signage, or
 +
* U-turns are required to properly make turns from public drivable road types that are blocked by a median.
  
'''A road should not be split because:'''
 
* There is a curb or non-drivable media less than 5m wide between lanes of travel. This means a turn lane, even a wide one, between directions of travel, does not count because it is drivable.
 
* There are a lot of roads intersecting which can only turn onto the nearest direction of travel.
 
* Google Maps or other mapping source show it as a split road
 
  
(I strongly believe that, for every mile of road that an AM wants to split into one-way roads, he should first  merge a mile of split roads back into a two-way road. [[Best_map_editing_practice#How_to_.22Un-Split.22_two_One-Way_Roads|Check out what's involved]]. It builds character.)
+
'''A road should <u>not</u> be divided when:'''
 +
* There is a curb or non-drivable median less than 5m wide between lanes of travel (see exceptions above).
 +
* The non-drivable median is interrupted by a cross segment at most intersections.
 +
* There is a center turn lane (any width) between directions of travel. Dividing this type of road creates problems when people turn from the middle lane because there is no road for the navigation to follow.
 +
* It is possible and legal to make a driver side turn/u-turn everywhere along the road
 +
* The objective is solely for visual appearance or to make the road match another visual source like Google Maps.
 +
{{clear}}
  
=== How to "Un-Split" two One-Way Roads ===
+
Remember that dividing and un-dividing roads each comes with its own set of problems. Each situation is unique and some issues may be more manageable with a single two-way road, and some may work fine with a divided road. Consider every aspect of routing, and carefully examine each junction before dividing or un-dividing. Regardless of whether you're dividing or un-dividing, remember that you might cause more problems than you solve and you might have to put it back the way it was beforeAlso remember that dividing and un-dividing each cause  loss of some traffic data, which can result in poor Waze routing.
Sorry to say it, but there is no easy way to merge two one-way roads back into a two-way road--which is why you should always give a lot of thought before splitting a road in the first placeAnd then think some more.
+
  
When you come across a road in your area that has been split but shouldn't have been--just look for the highest concentration of problem reports, and you'll find them!--you have some major map surgery ahead of you.  Basically, for the length of the road, you're going to:
+
==== {{anchor|How to "Un-Split" two One-Way Roads|How to "Un-divide" two One-Way Roads}}How to un-divide two one-way roads ====
 +
Unfortunately there is no easy way to merge two one-way roads back into a two-way road--which is why you should always give a lot of thought before dividing a road in the first place. And then think some more.
  
# delete road segments on one side or the other*, including segments that connect the two sides;
+
When you come across a road in your area that has been divided but shouldn't have been, you have some major map surgery ahead of you. Because of this high complexity in this process, it is recommended NOT to merge the two one-way roads UNLESS there are Update Requests related to the road caused by it being divided.
# remove all "orphaned" junctions;
+
# change the direction of the preserved segments to two-way, and check the "Separating line" box;
+
# check/fix the connectivity of all the roads already connect to the side you kept;
+
# connect (and set connectivity) of all the roads that used to be connected to the other side;
+
# make sure all the new two-way segments are connected; and
+
# adjust the geometry to move the two-way road segments to the middle of the road.
+
  
'*' It usually saves time to preserve whichever side is already connected to more roads, so you may want to delete one side in some places, and the other side in other places. Just remember to re-connect them later.
+
{{Red|The process to un-divide a road (convert from two one-way roads to one two-way road) written below has been specifically designed to preserve the underlying address information embedded in the street segments. It is very important that you do not simply delete one of the two roads because that deletes the house address data on that part of the road. They would have to be looked up and manually added back to the new road.}}
  
It isn't difficult once you have gone through the process a couple times.
+
The steps below show how to properly merge two one-way roads and preserve the underlying house numbers.
  
'''Caveat:''' if you decide to be clever and edit the road properties of multiple segments at a time, familiarize yourself with the [[Best_map_editing_practice#Editing_Multiple_Segments|known problems with mass-editing]] first.  It can be done--but if you're not careful, you'll find that all the road segments have reverted to Streets...in Alabama...and any alternate road names will be lost.  I wish I were kidding.
+
This is our example road segment.  For the entire length of the road you need to:
 +
 
 +
[[File:undivideRd1.jpg]]
 +
 
 +
1. Select the two segments to be merged and set them both to two-way.
 +
 
 +
[[File:undivideRd2.jpg]]
 +
 
 +
2. Disconnect both segments from one side of the section being un-divided. It is best to disconnect alternate ends of each segment as shown.
 +
 
 +
[[File:undivideRd3.jpg]]
 +
 
 +
3. Bring the two disconnected ends together in the middle (and realign the roads as necessary). You can remove the junction point you just created by selecting it and using the Delete key. Please note that the 2 aligned sections must have matching road information (name, type, direction, speed limit, elevation and lock) or the junction point will not allow removal!
 +
 
 +
[[File:undivideRd4.jpg]]
 +
 
 +
The following video was recorded by an editor merging two one-way roads so the addresses were preserved. This video follows the described steps above, but may help seeing it happening in real time. Press the "enlarge button in the lower right corner to see it full screen.
 +
 
 +
{{#ev:youtube|6blRMtGwaYA}}
 +
 
 +
 
 +
After BOTH sides are merged into one, you need to re-align house number to the street so that it lines up with driveway/entrance of the building the bubble is over.
 +
# With the street/road selected, click ‘Edit house numbers’.
 +
# From the house number editing view, you need to select each house number one-by-one.
 +
# With the house number selected, you see the dashed line is attached to a circle on the street.
 +
# Select the circle and move it along the road closest to the entrance of the driveway to the building.
 +
 
 +
Also be sure to check the following:
 +
# Remove all "orphaned" junctions.
 +
# Change the direction of the preserved segments to two-way.
 +
# Check/fix the connectivity of all the roads already connect to the side you kept.
 +
# Connect (and set connectivity) of all the roads that used to be connected to the other side.
 +
# Make sure all the new two-way segments are connected.
 +
# Adjust the geometry to move the two-way road segments to the middle of the road.
 +
 
 +
 
 +
Now repeat the entire process for the remaining segments matching the two opposite from each other.
 +
 
 +
It isn't difficult once you have gone through the process a couple of times.
 +
 
 +
'''Caveat:''' If you decide to be clever and edit the road properties of multiple segments at a time, first familiarize yourself with the known problems with mass-editing.  It can be done -- but if you're not careful, you'll find that all the road segments have reverted to Streets...in Alabama...and any alternate road names are lost.
  
 
=== Highways and Ramps ===
 
=== Highways and Ramps ===
  
Useful long-range navigation is impossible with Waze if the highways are broken.  Since limited-access roads--typically Freeways & Major Highways--offer more to think about (and more opportunities to mess them up) than typical surface-road work, this section is very important.
+
Useful long-range navigation is impossible with Waze if the highways are broken.  Because limited-access roads -- typically Freeways &amp; Major Highways -- offer more to think about (and more opportunities to mess them up) than typical surface-road work, this section is very important.
  
 
==== Roads ====
 
==== Roads ====
  
The term "limited-access road" here refers to a road that is multi-laned in each direction, with a physical barrier between directions, and which can be entered & exited solely by ramps.  Such roads almost always should be mapped as separate one-way segments--and other roads almost never should be.
+
The term "limited-access road" here refers to a road that is multi-laned in each direction, with a physical barrier between directions, and which can be entered and exited solely by ramps.  Such roads should almost always be mapped as separate one-way segments -- and other roads should almost never be.
  
 
==== Ramps ====
 
==== Ramps ====
  
As stated elsewhere, off-ramps should be named according to their exit number if they have one, as well as whatever is on the actual exit sign; e.g., "Exit 7: Rte 3 S / Braintree / Cape Cod".  On-ramps should be named "to" whatever they lead to; e.g., "to I-93 S / Quincy / Providence RI".  Ramps should always be locked to preserve directionality, since they often run especially close to other ramps that flow in the opposite direction.  (Not locking ramps means you will end up coming back later to fix a ramp that has become two-way--and has started directing traffic accordingly.)  Remember to check connectivity and turn restrictions while you're there.
+
As stated elsewhere, off-ramps should be named according to their exit number if they have one, as well as whatever is on the actual exit sign; e.g., "Exit 7: Rte 3 S / Braintree / Cape Cod".  On-ramps should be named "to" whatever they lead to; e.g., "to I-93 S / Quincy / Providence RI".  Because ramps often run especially close to other ramps that flow in the opposite direction, a ramp should be locked to preserve directionality<!-- ((This bug has been fixed:))(Not locking ramps means you will end up coming back later to fix a ramp that has become two-way--and has started directing traffic accordingly.) -->  
  
Be sure to understand the difference between ramps and [[At-Grade Connectors]].
+
Remember to check connectivity and turn restrictions while you're there.
  
==== Overpasses & Underpasses ====
+
*There is a more detailed description of [[Road names/USA#Exit ramps and Entrance ramps (on-ramps)|How to label Exit ramps and Entrance ramps]].
  
Recent experience has changed my thinking regarding road levels.  Given the current editor limitations, I have found that it is more important to know that road level is an issue for a particular segment (e.g., a mile-long stretch of highway that extends well beyond the screen boundaries), than what its actual value is, or of maintaining a consistent level across multiple segments of the same road.
+
*Be sure to understand the difference between ramps and [[at-grade connectors]].
  
I use level 0 as a "sentinel value" that signifies that a segment has no overpasses or underpasses.  When editing an over/underpass, if either segment is at level 0, set it to a non-zero value that reflects its relative level.  If both levels are already non-zero, either they are already correct--in which case no further action is required--or they are incorrect, in which case the area needs to be studied carefully, so as not to "break" other intersections that have already been evaluated and assigned.
+
==== Overpasses &amp; Underpasses ====
  
In many cases, the conflict can be resolved simply by adjusting one segment's level, or perhaps several segments will need to be adjusted. Proceed with caution. In really complicated situations, it might help to draw a picture, or to start by looking for the top-most or bottom-most segment.  Or perhaps take a course in Topology at your local community college.
+
Setting the road elevation can be tricky. Sometimes it is more important to know that road elevation is an issue for a particular segment (e.g., a mile-long stretch of highway that extends well beyond the screen boundaries), than what its actual value is, or of maintaining a consistent elevation across multiple segments of the same road.
  
Occasionally you will run into a situation in which no set of values will work. For example, three segments named A, B and C: A crosses over B, B crosses over C, and C crosses over A.  So A > B > C > A... now what?  Either pretend that one of the segments crosses over both of the others, or add a junction to one of the segments so that it can have two different levels as needed--and hope nobody deletes that "unnecessary" junction without investigating why it might be there. (In this example it might even make sense to add junctions to all three segments, just to make it clearer to the next AM what you're trying to accomplish.)
+
Ground level should be considered as a "sentinel value" that signifies a segment has no overpasses or underpasses. When editing an over/underpass, if either segment is at ground level, set the other one to a non-zero value that reflects its relative elevation to the one marked at ground level. If both elevations are already non-zero, either they are already correct (in which case no further action is required) or they are incorrect in which case the area needs to be studied carefully so as not to "break" other intersections that have already been evaluated and assigned.
  
==== Caveat re. Levels ====
+
In many cases, the conflict can be resolved simply by adjusting the elevation of one segment, or perhaps of several segments. Proceed with caution. In really complicated situations, it might help to draw a picture, or to start by looking for the top-most or bottom-most segment.
  
No matter what levels road segments are assigned, if you pin a junction through them, they now form a navigable intersection, and Waze '''will''' instruct people to turn off of bridges and onto the cross-streets below. If you are looking at an over/underpass, and there is a junction where the roads cross, get rid of it. First, make sure the levels of the road segments are correct, and that all the other info. of each pair of road segments match. At that point, deleting the junction will most likely work. If not (perhaps because a ramp or another road segment prevents you from deleting it), you can try:
+
Occasionally you run into a situation in which no set of values will work. For example, three segments named A, B, and C: A crosses over B, B crosses over C, and C crosses over A. So A > B > C > A... now what?  Either pretend that one of the segments crosses over both of the others, or add a junction to one of the segments so that it can have two different elevations as needed and hope nobody deletes that "unnecessary" junction without investigating why it might be there. In this example it might even make sense to add junctions to all three segments, just to make it clearer to the next AM what you're trying to accomplish.
 +
 
 +
==== Caveat re. Elevation ====
 +
 
 +
No matter what elevation road segments are assigned, if you pin a junction through them, they now form a navigable intersection, and Waze '''will''' instruct people to turn off of bridges and onto the cross-streets below. If you are looking at an over/underpass, and there is a junction where the roads cross, get rid of it. First, make sure the elevations of the road segments are correct, and that all the other information of each pair of road segments match. At that point, deleting the junction will most likely work. If that does not work, refer to [[Map Editing Quick-start Guide#Delete a Junction|deleting a junction]] for more information.
 +
 
 +
See also [[Creating and editing road segments#Road elevation|Road Elevation]].
  
 
==== Bridging Roads ====
 
==== Bridging Roads ====
  
Select the two segments that cross over/under the intersection, then click on the "Bridge" link.  If all goes well, the selected segments will be separated from the underlying junction, consolidated into a single segment, and their level increased by 1.  Failing that, you may have to disconnect both sides of the over/underpassing road from the junction, make sure their levels are correct, and then re-connect them.
+
Select the two segments that cross over/under the intersection, then click on the "Bridge" link.  If all goes well, the selected segments will be separated from the underlying junction, consolidated into a single segment, and their elevation increased by 1.  Failing that, you may have to disconnect both sides of the over/underpassing road from the junction, make sure their elevations are correct, and then re-connect them.
  
 
==== Handling Restricted Lanes ====
 
==== Handling Restricted Lanes ====
At this time, Waze does not have a facility to handle restricted lanes; e.g., high-occupancy/"car pool" lanes, lanes that are open (or change direction) at certain times of day, etc..  This is important because these lanes sometimes have their own ramps that the regular lanes do not have, and they often run alongside the main road, so that GPS has a hard time discriminating between the two.  The result is driving instructions that can range from incorrect to deadly.
+
At this time, Waze does not have a facility to handle restricted lanes; e.g., high-occupancy/"car pool" lanes.  This is important because these lanes sometimes have their own ramps that the regular lanes do not have, and they often run alongside the main road, so that GPS has a hard time discriminating between the two.  The result is driving instructions that can range from incorrect to deadly.
 +
 
 +
The most direct solution might appear to be omitting/deleting these lanes from the map.  Please '''do not''' delete these lanes. As Waze implements more features, it helps (in terms of testing and making the feature available) if these lanes are already mapped.
 +
 
 +
The best partial solution the community has come up with is described in detail on the [[Carpool, HOV, Transit lanes]] page. The lanes should be set with the appropriate road type for the road they are part of, and the entrance (and in some cases exit) ramps set with the appropriate restrictions for vehicle type (and time). If the lanes are reversible then they will have to be set with separate timed restrictions for each direction on the lanes themselves as well.
 +
 
 +
This "solution" gives routing onto these special lanes a very high [[Routing penalties|penalty]] when they being enforced, and reduce the likelihood that Waze will create a route over them. It does not prevent Waze from snapping a driver to the segments if it determines they are on such a lane, and any recalculation of the route from these segments is correct as well. However, as noted above, the fact that these lanes are usually quite close to the normal/open freeway or highway, makes it unlikely Waze will automatically recognize their true location due to GPS inaccuracy and margin of error.
 +
 
 +
{{details|Carpool, HOV, Transit lanes}}
 +
 
 +
==== High Occupancy Toll (HOT) Roads/Lanes (USA) ====
 +
The United States DOT has been working with local governments to introduce a new type of roadway called High Occupancy Toll (HOT) lanes/roads. In many cases these roads replace existing [[Carpool%2C_HOV%2C_Transit_lanes|HOV lanes]] and run in the median between different directions of non-toll traffic along a freeway.
 +
 
 +
[[Image:I-15-express-lanes.jpg]]
 +
 
 +
HOT roadways have the following features:
 +
* These lanes/roads allow both toll traffic and HOV traffic to traverse the same lanes.
 +
* There are no toll plazas or booths for paying by cash. All tolls are paid electronically to maintain traffic speed.
 +
* Entrances and exits to the HOT lanes are limited to help maintain high speeds.
 +
* There are no entrance/exit combinations where the toll fare rules don't apply.
 +
* Tolls are discounted or waived for users that meet High Occupancy Vehicle (HOV) requirements. These requirements may change based on time of day.
 +
 
 +
HOT lanes are often marketed as "Express Lanes"; however, the term "Express Lanes" is also used by various regional governments for non-HOT lanes. In order to be considered a HOT lane for Waze purposes, a road needs to meet all criteria listed above.
 +
 
 +
The entrances to HOT lanes should be marked with the toll flag. This prevents Waze from routing those wishing to avoid tolls onto the HOT lanes, while allowing Waze to use the HOT lanes for routing for those willing to pay a toll for a faster commute.
 +
 
 +
The lanes of the HOT itself should not be flagged as a toll road, to prevent Waze from trying to route HOV users out of the HOT lanes if they have toll avoidance active in the client.
 +
 
 +
Because Waze does not currently support HOV lanes, HOV users with toll avoidance turned on are not routed onto the HOT lanes. Just as with the current HOV best practices, those that meet the HOV requirements and wish to use the HOT lanes need to navigate themselves to the HOT lanes; they are not be routed onto them by the Waze client. As with standard HOV lanes, HOV users need to recalculate the route for Waze to snap them to the HOT lane.
 +
 
 +
Because HOT lanes are still considered "experimental" there may be some variation in local implementation. If the HOT lane does not meet all the requirements listed above, check with an experienced local editor or Country Manager before making any changes. When in doubt seek advice on the forum; a change to the guidelines or an exception may need to be made for the local variation.
 +
 
 +
 
 +
=== Toll roads ===
 +
:''For other uses see [[Toll (disambiguation)]].''
 +
 
 +
Roads with tolls can be indicated by checking the '''Toll road''' box on the [[Creating and editing road segments#Road Properties|road segment properties]] tab. Mark a segment as a toll road only if:
 +
*there is a toll booth, transponder reader, or other tolling device within, or at either end of the segment
 +
 
 +
Do not check the toll box setting for segments that lead up to the final toll segment even if they have no other exit except the final toll segment.
 +
 
 +
In the case of a bridge that is tolled in only one direction, divide the road where the toll is collected and mark only the segment with the toll booth as a toll road.
 +
 
 +
* ''see advanced topic on [[Time-based Tolls]] for mapping tolls that do not charge all the time.''
 +
 
 +
=== Time Restricted Turns ===
 +
The Waze Map Editor and routing engine supports scheduled restrictions (time of day, day of week, turns, traffic flow direction, vehicle type, etc.).
  
The most direct solution might appear to be omitting/deleting these lanes from the map.  Please '''don't'''; as Waze implements more features, it will help (in terms of testing and making the feature available) if these lanes are already mapped.
+
Please see the [[Partial restrictions]] page for full documentation on this feature.
  
The best compromise thus far, as outlined in [http://www.waze.com/forum/viewtopic.php?f=11&t=10093 this forum thread], is to set the direction of the segments to "no entrance", lock them, and establish turn restrictions at each end to prevent Waze from routing traffic over them.  In this way, the lanes will be on the map, Waze won't route people onto them incorrectly--and yet if someone does drive onto them, Waze won't be completely lost.
 
  
 
=== When to Use Ramps in an Intersection ===
 
=== When to Use Ramps in an Intersection ===
Please see the discussion on [[At-Grade Connectors]].
+
Please see the discussion on [[at-grade connectors]].
 +
 
  
 
=== When to Create a Roundabout ===
 
=== When to Create a Roundabout ===
In the author's editing and driving experience, once you learn [[How_to_create_a_roundabout|how to create a roundabout]] in Cartouche, it is '''always''' the right time to replace an ''ad hoc'' traffic circle (built from regular road segments) with a proper roundabout.  The voice cues produced by an ad-hoc circle can be terribly misleading, and the client display almost always looks unprofessionally sloppy.  Replacing this with a roundabout is an instant, orders-of-magnitude improvement on both counts.
+
In the author's editing and driving experience, once you learn [[Creating and Editing a roundabout|how to create a roundabout]], it is '''always''' the right time to replace an ''ad hoc'' traffic circle (built from regular road segments) with a proper roundabout.  The voice cues produced by an ad-hoc circle can be terribly misleading, and the client display almost always looks unprofessionally sloppy.  Replacing this with a roundabout is an instant, orders-of-magnitude improvement on both counts.
  
== Cartouche Caveats ==
+
'''''Note:''' A roundabout should never be used in place of an end-node on dead-end or cul-de-sac street. See: [[Junction_Style_Guide#Cul-de-sacs|Junction Style Guide]]''
Every tool, however good, has its limitations, and Cartouche is no exception.  For general editing, what you see is usually what you get, and if you read the copious online documentation in advance, you will be able to make sense of (and extricate yourself from) most situations that you run into when editing the map.  But there are a few things to watch out for, that can result in a lot of extra work for you if you miss them.
+
  
=== Road Geometry and Alternate Names ===
 
Simply put: when you edit the geometry of a road, any Alternate names assigned to it are gone.  It makes no sense, people have been aware of this for ages and it has not been fixed.  Perhaps it will be addressed in the next incarnation of Cartouche.  Until then: Nothing to see here, move along.  (Just remember to go back and restore the Alt names after the geometry is set.  Copy & paste are your friends...)
 
  
Note that this only affects the segment whose geometry is actually being modified, and ''not'' any roads that might be connected to it via junctions.  So if you have a road with an Alt name (e.g., a minor highway), you may be able to adjust its geometry without disturbing its Alt name assignment by editing the geometry of adjoining roads instead.
+
=== Locking Segments ===
 +
In some regions there are locking rank standards applied based on road type. In these regions all roads of a certain type are locked to a minimum rank, and should be locked even in residential areas. Check [[Template:Countries|your local wiki]] for your local standards to see if these apply in your editing area. Locking should otherwise be used on high-value roads and complicated junctions to prevent inexperienced lower rank editors from making changes.
  
=== Editing Multiple Segments ===
+
NEVER lock a segment unless you are sure that it and everything that touches it (junctions, turn restrictions, and other segments) is 100% complete and correct.
  
=== Directionality & Locking ===
+
If you run into a segment or junction that is locked by someone at a higher editing rank than you, refer to the page on [[Editing restrictions#Unlocking an object above your rank|unlocking an object above your rank]] for more information.
If Waze sees enough people driving along a road in a certain direction, it will conclude that travel in that direction is allowed, and update the map accordingly.  The problem is, client GPS signals can be inaccurate, and Waze can mistakenly think that you are on one road when you are really on another.  When this happens, one-way roads suddenly become two-way.  When this happens on a highway or one of its ramps, it can have far-reaching effects on navigation.
+
  
According to the [[FAQ#What_is_a_locked_road_in_Cartouche.3F|FAQ]], locking a road segment has three effects, one of which is to lock directionality.  Whenever you work on a major highway, make sure that each of your carefully-placed and connected road/ramp sections are locked, so that you don't have to come back later and fix what a few messy GPS tracks broke.
+
'''Locking should be used sparingly and carefully.'''
  
  
 +
=== Junction Style Guide ===
 +
When creating or editing a junction, it is very important to understand the nuances of how the Waze routing engine looks at the map segments and junctions. The [[Junction Style Guide]] provides the best practices with the many different types of junctions.
  
'''UPDATE:''' Waze has changed its heuristics to make it more difficult for road directionality to change as described above, once it has been set via the editor.  Therefore, in order to allow automatic geometry adjustments, it is now better to leave roads unlocked after assigned them to be one-way.
 
  
=== The Turn Restrictions Layer is Broken ===
 
Until they fix it, just leave this layer off and use the [[Cartouche_-_Update_map#Highlight_Connectivity:|Highlight Connectivity]] feature instead.
 
  
=== Connectivity ===
+
=== Parking Lots ===
Just because two roads are touching where there is a junction, don't assume they are connected.  Because you have "Highlight Connectivity" turned on (see above), you should notice pretty quickly that a segment is not connected.  To fix, either:
+
* Highlight the disconnected segment and the one to which it needs to connect, in from-to order where one-way roads are involved, and use "Connect roads in order of selection" (or the 'c' keyboard shortcut)
+
or
+
* add a junction on top of the existing junction.  The new one will replace the old one.  Most of the time you will want the "Allow all turns" mode on, but sometimes when working with one-way roads it is easier to turn that option off and enable turns individually.
+
  
=== Reducing Junctions / Consolidating Segments ===
+
Mapping a [[Road types/USA#Parking Lot Road|parking lot road]] serves three purposes:
You will often see junctions in the middle of roads, where there is no intersection.  These "extra" junctions are often the result of editing attempts gone awry, and seem to be a magnet for ill-connected and incorrectly-named roads.  They multiply the number of segments that you need to maintain, and I'm sure they're not helpful to the routing servers.  In short, unnecessary junctions indicate problems, and should almost always be eliminated.  (The only exceptions are when they mark a change of city, or when you know that you will be connecting a road there very soon.)
+
  
When deleting a junction, remember that the segments on either side of the junction have to match road type, name, city, state, and have compatible directions.  If both segments are two-way, or one-way in the same directions, it will work.  If they are both "no entrance", it will fail. IMO this is a bug; just remember to change them to two-way beforehand, and then change the consolidated segment back to "no entrance" afterward.
+
*it allows Waze to provide door-to-door directions within the lot;
 +
*it allows Waze to recognize that the client is off the main road, avoiding erroneous traffic reports.
 +
*using the special type prevents Waze from routing traffic through the parking lot.
  
After the junctions are removed, you may need to adjust the consolidated segment's geometry to account for the missing junctions.
+
For marking parking lots with places see the information on the [[Places/Parking lot|Parking Lot Place type]].  Parking lot roads are not limited to use with the parking lot place type, though they are often used together.
  
Please note that there are currently [[bugs can occur when deleting junctions]].
+
The Parking Lot Road type exists to allow the mapping of parking lots, while discouraging the routing server from using them for through navigation. Waze applies a [[Routing penalties|transition penalty]] for leaving a Parking Lot Road segment to enter another road type. This penalty decreases the chance that Waze will route through a parking lot as a shortcut but allows better navigation in and out of a parking lot. It is advised not to mix road types within a parking lot to avoid triggering the transition penalty unnecessarily.
  
=== How to Remove Multiple Junctions ===
+
==== Shopping Centers ====
During the interval after pressing the 'y' key (to confirm removing a junction) and before Cartouche returns control to the Edit Panel, it ''is'' possible to click on additional junctions and use the 'y' key to delete them as well.  This often results in faster deletions because Cartouche is effectively deleting them in parallel; '''However,''' there is one known bug and one suspected bug associated with this practice, so its use is highly discouraged:
+
  
#Deleting adjacent junctions in this manner often causes nearby road segments to vanish, and need to be re-created.  I suspect this is due to a race condition. Deleting adjacent junctions means you are deleting the junctions at both ends of a segment. If the first junction is deleted, and then before the segment can be merged with its neighbor, the second junction is deleted, the road segment between them ends up being deleted.
+
When mapping a large parking lot (e.g., at a shopping center) consider mapping only the following:
#:''The workaround for this bug is to make sure you never multi-delete adjacent junctions.  However, I have started to suspect another bug that has sworn me off of multi-deleting junctions at all, adjacent or not:''
+
#Also probably due to a race condition, I believe that using this technique may corrupt the segment IDs of the road segments involved, causing route highlighting problems when using the Waze client to navigate.
+
  
== New Roads ==
+
*Main entrances from the roads outside the parking lot
 +
*Lanes that run along storefronts
 +
*Lanes at the edge of the lot which run alongside public roads (prevents Wazers in the parking area from "snapping" to the public road, and then sending it incorrect speed information)
 +
*Primary travel lanes that serve to get people from one area of the lot to another
  
 +
Remember, the goals here are usability and simplicity. When in doubt, imagine yourself in a car in the lot at various points, and ask yourself what the most efficient way would be to get to a store at the other end of the lot, or to exit the lot and get back on a main road, with as few convolutions as possible. The lanes that are used the most in this thought experiment should be mapped, with the rest being omitted. You can turn on the GPS points layer ([[Shortcut key]] Shift-G) to see where traffic is concentrated to get a sense of what needs mapping.<br/>[[File:ParkingLotRoad ShoppingCenter.png|714px]]
 +
 +
In particular, '''do not''' map every single lane, and especially not every single parking space (it has been done!). This serves no purpose but to clutter the map, confuse directions, and put an unnecessary burden on both the client and server hardware. Remember usability and simplicity are #1. Your editing time and expertise can be better used elsewhere in the map.
 +
 +
==== Small Parking Lots ====
 +
 +
Parking lots that serve a small number of businesses should be minimal: enough to give the driver correct directions into and out of the lot, and navigate to a particular business. Very small lots with one entrance and one exit could even be represented by a single segment running through the parking area (either a diagonal across the lot if it connects to roads on each side, or a single, flattened curve for strip mall-style lots with entrances and exit along the same road).
 +
 +
To permit a route to be given to exit a small parking lot from the same point the parking lot was entered, [[Turn_restrictions#U-turns|u-turns]] may be enabled at the ends of the parking lot road.  This is particularly relevant where a single parking lot segment connects two different street segments such as is common for many corner [[Places/Gas_Station|gas stations]].
 +
 +
==== Drive-Through Lots ====
 +
 +
Because drive-through lots can be narrow and congested, with one-way sections, the best way to represent them is often a one-way drive-through loop. ''Caveat: because both ends of a segment cannot connect to the same junction, if the lot has only one entrance/exit, it is necessary to build the [[Junction Style Guide#Loops|loop using three segments]].''
 +
 +
==== Two parking lots connected to the same street ====
 +
 +
Bad routing can occur when two parking lots connect to the same street. This can happen, for example, where two lots face each other. If you connect both parking lots to the street using ''the same junction'' as the connection point for both, Waze will treat them as one parking lot. 
 +
 +
If there are no turn restrictions preventing routing across the street, Waze may route the driver through one parking lot to reach a destination in the other parking lot. Waze is designed to avoid such routes, but in this configuration, Waze does not apply the expected penalty - because crossing through the junction from one parking lot segment to the other is not considered a transition, even though there is also a street running through the junction. This may be most easily understood by looking at the example image below.
 +
 +
If it is not legal to cross from one lot to the other, [[turn restrictions]] will prevent any sort of routing between the lots.  However, if it is possible to route from one lot to the other, then a different method is required to prevent routing through one lot to reach the other.
 +
 +
To be sure that Waze will apply the transition penalty when routing through one parking lot from another, the two parking lots must be isolated from the each other such that passing from one to the other requires driving over a standard road segment (not a parking lot road or [[Private road|private road]]). You should use a short "stub" length no less than {{:Segment length/Minimum}} of a standard road segment. This segment will run from the junction to the entry/exit segment of one of the lots. With this configuration, exiting the parking lot will have a consistent penalty, whether the route exits the first parking lot to the street or the route leads to another parking lot at the same junction. The short stub may reduce display impact and will also signal other editors that the use of a different road type is not accidental.
 +
 +
Parking lots do not have to be across the street from each other. In a strip mall, if the exit segment of one business is joined to the entrance segment of the next business, the same problem can occur.
 +
 +
===== Illustration =====
 +
 +
For example, in the configuration shown below if routing from the west parking lot, there is no transition penalty to route through the gas station parking lot on the east side of the street if routing east on Riva Rd.  Conversely, if routing to the west parking lot from Riva Rd. there is no transition penalty to use the gas station. 
 +
 +
[[File:PLA.png|center]] {{clear}}
 +
 +
 +
[[File:PLB.png|right]]This potential problem arises when two parking lots on opposite sides of a street connect at the same junction node on the street.{{clear}}
 +
[[File:PLC.png|right]]If this configuration causes routing problems it can be solved by changing the road type of one (or both) of the parking lot roads that intersect with the street.{{clear}}
 +
[[File:PLD.png|right]]A five meter or longer stub of a different road type will accomplish the same result.{{clear}}
 +
[[File:PLE.png|left]]If the street is a divided highway, then the road type of the crossover segment may be changed (this may also allow [[U-turn_prevention#Avoiding_U_turns|U-turns]] at the crossover segment).
 +
{{clear}}
 +
 +
[http://www.example.com link title]== New Roads ==
 
=== Recorded via Client ===
 
=== Recorded via Client ===
Once you start editing a road, it changes from red (a new road) to the colour of a road type (by default a white street) and will then appear on the next [[Timeline of updating process|update of the Live Map]] which will go out to all Waze users.
+
Once you start editing a road, it changes from red (a new road) to the colour of a road type (by default a white street) and will then appear on the next [[Timeline of updating process|update of the Live Map]] which goes out to all Waze users.
  
So it is '''less than helpful''' if you do an incomplete job. At least if the road is red, then someone else knows that it needs work. If it is white, perhaps even with a street name, then it may look correct. But Waze may not realise it is driveable.
+
So it is '''less than helpful''' if you do an incomplete job. At least if the road is red, then someone else knows that it needs work. If it is white, perhaps even with a street name, then it may look correct. But Waze may not view it as navigable.
  
Follow these simple steps, as best you can, and get it right the first time. [[Map Editing]] explains how to carry out these steps.
+
Follow these simple steps, as best you can, and get it right the first time. [[Waze Map Editor|Map Editing]] explains how to carry out these steps.
  
# Align the [[glossary|geometry]] of the road to the aerial image unless that is [[Warning_on_possible_lack_of_accuracy_in_aerial_images|not appropriate in your area]]
+
# Align the [[glossary|geometry]] of the road to the aerial image unless that is [[Warning on possible lack of accuracy in aerial images|not appropriate in your area]]
 
# Enter the correct name and road type for your road, following the standards for your country
 
# Enter the correct name and road type for your road, following the standards for your country
 
# Make sure the road has the correct [[glossary|directionality]]. Most roads should be Two Way.
 
# Make sure the road has the correct [[glossary|directionality]]. Most roads should be Two Way.
 
# Add junctions where the road intersects with other roads. By default tick "Enable all turns". Restrict any turns that are not allowed. If a junction appears, just add a junction over the top. Chances are it does not have all turns enabled. Waze automatically handles turn restrictions for one way roads.
 
# Add junctions where the road intersects with other roads. By default tick "Enable all turns". Restrict any turns that are not allowed. If a junction appears, just add a junction over the top. Chances are it does not have all turns enabled. Waze automatically handles turn restrictions for one way roads.
 +
  
 
=== Roundabouts ===
 
=== Roundabouts ===
Even though a proper roundabout (i.e., produces "at the roundabout..." verbal cues) can only be created in Cartouche, when it is first created, the segments are configured as new roads.  They will need to be edited as above before they will become part of the live map.
+
*A proper roundabout (i.e., produces "at the roundabout..." verbal cues) can only be created in WME.
 +
*When it is first created, the segments are configured as new roads - they need to be edited as above before they become part of the live map.
 +
*Please see [[Creating and Editing a roundabout]] for more information on creating these special intersections.
 +
 
 +
== Classification of crossings ==
 +
Different types of crossings have [[Classification of crossings|standard ways to handle them]].
 +
 
 +
{{ReturnTo | Editing manual | the editing manual}}
 +
 
 +
[[Category:Waze Map Editor]]
 +
[[Category:Convert to Subpages]]
 +
[[Category:Add Wikilinks]]

Latest revision as of 08:08, 2 May 2018

Wazeopedia.png

The purpose of this page is to help all map editors design maps that work best for the end-user--the driving public--while minimizing the amount of (re)work you have to do because of common mistakes or subtle limitations of the tools. For those who are an Area Manager, many helpful pages already exist on your responsibilities, including how to use Waze Map Editor, identify and solve Map problems and Update requests, set standards for labeling roads, and a general FAQ. These same sources are incredibly useful for newer editors as well and should be reviewed to become familiar with the various elements of Waze map editing before getting too deep with your edits.

If you find something missing from this page or any page of the Wiki, either be bold and edit the page to add or modify the information (if you are confident that is how it works), or you can post a comment in the Wiki improvement forum.

Some of the guidance for Best map editing practice may have specific localized adjustments for your local area. Be sure to familiarize yourself with these differences through the Local vs global guidance page.


Overall Goals

Usability

When it comes to the map, the first and foremost goal of editing is to provide the driver with a map that is easy to follow on a small display, and to produce sensible verbal instructions when (and only when) they are needed.

Simplicity

It is not a goal to model the physical roadway lane-by-lane. Doing so often leads to unnecessary complexity--which means a cluttered map, confusing verbal directions, and lots and lots (and lots!) of extra map maintenance.

Retention

Because Waze users drive over them, road segments retain certain information (e.g., average speed) that is used in route optimization. When a segment is deleted, the information in the segment is discarded. Given a choice between deleting a tangle of segments and creating new ones in their place, vs. untangling them and reusing them, it is better to "recycle".

In Practice

Dividing and un-dividing divided highways

When to divide a two-way road (and when not to)

Generally, a road should be un-divided unless it meets any of the requirements for dividing a road. When initially reviewing whether to divide or "un-divide" (merge back together) a roadway, consider these points first:

  1. The default representation for any roadway is a single 2-way segment, even if the physical roadway is divided. Dividing a roadway carries with it the burden of proof that the change will improve the usability and/ or simplicity of the Waze map.
  2. If a road is currently working with no problem reports, consider leaving it as is.
  3. If the area has an Area Manager, consult with them before dividing/un-dividing. If the area does not have an Area Manager and after reviewing the formal guidelines below you are unsure which way to go, consider sending a permalink of the road to the map editing forums to get additional feedback from other editors.
  4. Try to avoid switching roads back and forth between being divided and 2-way. For example, if most of the road is clearly divided and only parts would be considered a single two-way road, consider leaving it all divided. If only a small portion seems better off divided, consider keeping it all 2-way.


A road may be divided when any of the following conditions are met:

  • It is an Interstate Highway (USA) or other Limited Access Highway using the "Freeway" road type,
  • GPS tracks show a clearly definable and continuous gap (blank area) between the colour-by-azimuth arrows at the 100m/500ft zoom level,
  • multiple houses or businesses with no off-street parking are located directly on the street but are not accessible from the opposite direction of travel due to lengthy median, obstruction, or traffic control signage, or
  • U-turns are required to properly make turns from public drivable road types that are blocked by a median.


A road should not be divided when:

  • There is a curb or non-drivable median less than 5m wide between lanes of travel (see exceptions above).
  • The non-drivable median is interrupted by a cross segment at most intersections.
  • There is a center turn lane (any width) between directions of travel. Dividing this type of road creates problems when people turn from the middle lane because there is no road for the navigation to follow.
  • It is possible and legal to make a driver side turn/u-turn everywhere along the road
  • The objective is solely for visual appearance or to make the road match another visual source like Google Maps.

Remember that dividing and un-dividing roads each comes with its own set of problems. Each situation is unique and some issues may be more manageable with a single two-way road, and some may work fine with a divided road. Consider every aspect of routing, and carefully examine each junction before dividing or un-dividing. Regardless of whether you're dividing or un-dividing, remember that you might cause more problems than you solve and you might have to put it back the way it was before. Also remember that dividing and un-dividing each cause loss of some traffic data, which can result in poor Waze routing.

How to un-divide two one-way roads

Unfortunately there is no easy way to merge two one-way roads back into a two-way road--which is why you should always give a lot of thought before dividing a road in the first place. And then think some more.

When you come across a road in your area that has been divided but shouldn't have been, you have some major map surgery ahead of you. Because of this high complexity in this process, it is recommended NOT to merge the two one-way roads UNLESS there are Update Requests related to the road caused by it being divided.

The process to un-divide a road (convert from two one-way roads to one two-way road) written below has been specifically designed to preserve the underlying address information embedded in the street segments. It is very important that you do not simply delete one of the two roads because that deletes the house address data on that part of the road. They would have to be looked up and manually added back to the new road.

The steps below show how to properly merge two one-way roads and preserve the underlying house numbers.

This is our example road segment. For the entire length of the road you need to:

UndivideRd1.jpg

1. Select the two segments to be merged and set them both to two-way.

UndivideRd2.jpg

2. Disconnect both segments from one side of the section being un-divided. It is best to disconnect alternate ends of each segment as shown.

UndivideRd3.jpg

3. Bring the two disconnected ends together in the middle (and realign the roads as necessary). You can remove the junction point you just created by selecting it and using the Delete key. Please note that the 2 aligned sections must have matching road information (name, type, direction, speed limit, elevation and lock) or the junction point will not allow removal!

UndivideRd4.jpg

The following video was recorded by an editor merging two one-way roads so the addresses were preserved. This video follows the described steps above, but may help seeing it happening in real time. Press the "enlarge button in the lower right corner to see it full screen.


After BOTH sides are merged into one, you need to re-align house number to the street so that it lines up with driveway/entrance of the building the bubble is over.

  1. With the street/road selected, click ‘Edit house numbers’.
  2. From the house number editing view, you need to select each house number one-by-one.
  3. With the house number selected, you see the dashed line is attached to a circle on the street.
  4. Select the circle and move it along the road closest to the entrance of the driveway to the building.

Also be sure to check the following:

  1. Remove all "orphaned" junctions.
  2. Change the direction of the preserved segments to two-way.
  3. Check/fix the connectivity of all the roads already connect to the side you kept.
  4. Connect (and set connectivity) of all the roads that used to be connected to the other side.
  5. Make sure all the new two-way segments are connected.
  6. Adjust the geometry to move the two-way road segments to the middle of the road.


Now repeat the entire process for the remaining segments matching the two opposite from each other.

It isn't difficult once you have gone through the process a couple of times.

Caveat: If you decide to be clever and edit the road properties of multiple segments at a time, first familiarize yourself with the known problems with mass-editing. It can be done -- but if you're not careful, you'll find that all the road segments have reverted to Streets...in Alabama...and any alternate road names are lost.

Highways and Ramps

Useful long-range navigation is impossible with Waze if the highways are broken. Because limited-access roads -- typically Freeways & Major Highways -- offer more to think about (and more opportunities to mess them up) than typical surface-road work, this section is very important.

Roads

The term "limited-access road" here refers to a road that is multi-laned in each direction, with a physical barrier between directions, and which can be entered and exited solely by ramps. Such roads should almost always be mapped as separate one-way segments -- and other roads should almost never be.

Ramps

As stated elsewhere, off-ramps should be named according to their exit number if they have one, as well as whatever is on the actual exit sign; e.g., "Exit 7: Rte 3 S / Braintree / Cape Cod". On-ramps should be named "to" whatever they lead to; e.g., "to I-93 S / Quincy / Providence RI". Because ramps often run especially close to other ramps that flow in the opposite direction, a ramp should be locked to preserve directionality.

Remember to check connectivity and turn restrictions while you're there.

Overpasses & Underpasses

Setting the road elevation can be tricky. Sometimes it is more important to know that road elevation is an issue for a particular segment (e.g., a mile-long stretch of highway that extends well beyond the screen boundaries), than what its actual value is, or of maintaining a consistent elevation across multiple segments of the same road.

Ground level should be considered as a "sentinel value" that signifies a segment has no overpasses or underpasses. When editing an over/underpass, if either segment is at ground level, set the other one to a non-zero value that reflects its relative elevation to the one marked at ground level. If both elevations are already non-zero, either they are already correct (in which case no further action is required) or they are incorrect in which case the area needs to be studied carefully so as not to "break" other intersections that have already been evaluated and assigned.

In many cases, the conflict can be resolved simply by adjusting the elevation of one segment, or perhaps of several segments. Proceed with caution. In really complicated situations, it might help to draw a picture, or to start by looking for the top-most or bottom-most segment.

Occasionally you run into a situation in which no set of values will work. For example, three segments named A, B, and C: A crosses over B, B crosses over C, and C crosses over A. So A > B > C > A... now what? Either pretend that one of the segments crosses over both of the others, or add a junction to one of the segments so that it can have two different elevations as needed and hope nobody deletes that "unnecessary" junction without investigating why it might be there. In this example it might even make sense to add junctions to all three segments, just to make it clearer to the next AM what you're trying to accomplish.

Caveat re. Elevation

No matter what elevation road segments are assigned, if you pin a junction through them, they now form a navigable intersection, and Waze will instruct people to turn off of bridges and onto the cross-streets below. If you are looking at an over/underpass, and there is a junction where the roads cross, get rid of it. First, make sure the elevations of the road segments are correct, and that all the other information of each pair of road segments match. At that point, deleting the junction will most likely work. If that does not work, refer to deleting a junction for more information.

See also Road Elevation.

Bridging Roads

Select the two segments that cross over/under the intersection, then click on the "Bridge" link. If all goes well, the selected segments will be separated from the underlying junction, consolidated into a single segment, and their elevation increased by 1. Failing that, you may have to disconnect both sides of the over/underpassing road from the junction, make sure their elevations are correct, and then re-connect them.

Handling Restricted Lanes

At this time, Waze does not have a facility to handle restricted lanes; e.g., high-occupancy/"car pool" lanes. This is important because these lanes sometimes have their own ramps that the regular lanes do not have, and they often run alongside the main road, so that GPS has a hard time discriminating between the two. The result is driving instructions that can range from incorrect to deadly.

The most direct solution might appear to be omitting/deleting these lanes from the map. Please do not delete these lanes. As Waze implements more features, it helps (in terms of testing and making the feature available) if these lanes are already mapped.

The best partial solution the community has come up with is described in detail on the Carpool, HOV, Transit lanes page. The lanes should be set with the appropriate road type for the road they are part of, and the entrance (and in some cases exit) ramps set with the appropriate restrictions for vehicle type (and time). If the lanes are reversible then they will have to be set with separate timed restrictions for each direction on the lanes themselves as well.

This "solution" gives routing onto these special lanes a very high penalty when they being enforced, and reduce the likelihood that Waze will create a route over them. It does not prevent Waze from snapping a driver to the segments if it determines they are on such a lane, and any recalculation of the route from these segments is correct as well. However, as noted above, the fact that these lanes are usually quite close to the normal/open freeway or highway, makes it unlikely Waze will automatically recognize their true location due to GPS inaccuracy and margin of error.


For more details on this topic, see Carpool, HOV, Transit lanes.

High Occupancy Toll (HOT) Roads/Lanes (USA)

The United States DOT has been working with local governments to introduce a new type of roadway called High Occupancy Toll (HOT) lanes/roads. In many cases these roads replace existing HOV lanes and run in the median between different directions of non-toll traffic along a freeway.

I-15-express-lanes.jpg

HOT roadways have the following features:

  • These lanes/roads allow both toll traffic and HOV traffic to traverse the same lanes.
  • There are no toll plazas or booths for paying by cash. All tolls are paid electronically to maintain traffic speed.
  • Entrances and exits to the HOT lanes are limited to help maintain high speeds.
  • There are no entrance/exit combinations where the toll fare rules don't apply.
  • Tolls are discounted or waived for users that meet High Occupancy Vehicle (HOV) requirements. These requirements may change based on time of day.

HOT lanes are often marketed as "Express Lanes"; however, the term "Express Lanes" is also used by various regional governments for non-HOT lanes. In order to be considered a HOT lane for Waze purposes, a road needs to meet all criteria listed above.

The entrances to HOT lanes should be marked with the toll flag. This prevents Waze from routing those wishing to avoid tolls onto the HOT lanes, while allowing Waze to use the HOT lanes for routing for those willing to pay a toll for a faster commute.

The lanes of the HOT itself should not be flagged as a toll road, to prevent Waze from trying to route HOV users out of the HOT lanes if they have toll avoidance active in the client.

Because Waze does not currently support HOV lanes, HOV users with toll avoidance turned on are not routed onto the HOT lanes. Just as with the current HOV best practices, those that meet the HOV requirements and wish to use the HOT lanes need to navigate themselves to the HOT lanes; they are not be routed onto them by the Waze client. As with standard HOV lanes, HOV users need to recalculate the route for Waze to snap them to the HOT lane.

Because HOT lanes are still considered "experimental" there may be some variation in local implementation. If the HOT lane does not meet all the requirements listed above, check with an experienced local editor or Country Manager before making any changes. When in doubt seek advice on the forum; a change to the guidelines or an exception may need to be made for the local variation.


Toll roads

For other uses see Toll (disambiguation).

Roads with tolls can be indicated by checking the Toll road box on the road segment properties tab. Mark a segment as a toll road only if:

  • there is a toll booth, transponder reader, or other tolling device within, or at either end of the segment

Do not check the toll box setting for segments that lead up to the final toll segment even if they have no other exit except the final toll segment.

In the case of a bridge that is tolled in only one direction, divide the road where the toll is collected and mark only the segment with the toll booth as a toll road.

  • see advanced topic on Time-based Tolls for mapping tolls that do not charge all the time.

Time Restricted Turns

The Waze Map Editor and routing engine supports scheduled restrictions (time of day, day of week, turns, traffic flow direction, vehicle type, etc.).

Please see the Partial restrictions page for full documentation on this feature.


When to Use Ramps in an Intersection

Please see the discussion on at-grade connectors.


When to Create a Roundabout

In the author's editing and driving experience, once you learn how to create a roundabout, it is always the right time to replace an ad hoc traffic circle (built from regular road segments) with a proper roundabout. The voice cues produced by an ad-hoc circle can be terribly misleading, and the client display almost always looks unprofessionally sloppy. Replacing this with a roundabout is an instant, orders-of-magnitude improvement on both counts.

Note: A roundabout should never be used in place of an end-node on dead-end or cul-de-sac street. See: Junction Style Guide


Locking Segments

In some regions there are locking rank standards applied based on road type. In these regions all roads of a certain type are locked to a minimum rank, and should be locked even in residential areas. Check your local wiki for your local standards to see if these apply in your editing area. Locking should otherwise be used on high-value roads and complicated junctions to prevent inexperienced lower rank editors from making changes.

NEVER lock a segment unless you are sure that it and everything that touches it (junctions, turn restrictions, and other segments) is 100% complete and correct.

If you run into a segment or junction that is locked by someone at a higher editing rank than you, refer to the page on unlocking an object above your rank for more information.

Locking should be used sparingly and carefully.


Junction Style Guide

When creating or editing a junction, it is very important to understand the nuances of how the Waze routing engine looks at the map segments and junctions. The Junction Style Guide provides the best practices with the many different types of junctions.


Parking Lots

Mapping a parking lot road serves three purposes:

  • it allows Waze to provide door-to-door directions within the lot;
  • it allows Waze to recognize that the client is off the main road, avoiding erroneous traffic reports.
  • using the special type prevents Waze from routing traffic through the parking lot.

For marking parking lots with places see the information on the Parking Lot Place type. Parking lot roads are not limited to use with the parking lot place type, though they are often used together.

The Parking Lot Road type exists to allow the mapping of parking lots, while discouraging the routing server from using them for through navigation. Waze applies a transition penalty for leaving a Parking Lot Road segment to enter another road type. This penalty decreases the chance that Waze will route through a parking lot as a shortcut but allows better navigation in and out of a parking lot. It is advised not to mix road types within a parking lot to avoid triggering the transition penalty unnecessarily.

Shopping Centers

When mapping a large parking lot (e.g., at a shopping center) consider mapping only the following:

  • Main entrances from the roads outside the parking lot
  • Lanes that run along storefronts
  • Lanes at the edge of the lot which run alongside public roads (prevents Wazers in the parking area from "snapping" to the public road, and then sending it incorrect speed information)
  • Primary travel lanes that serve to get people from one area of the lot to another

Remember, the goals here are usability and simplicity. When in doubt, imagine yourself in a car in the lot at various points, and ask yourself what the most efficient way would be to get to a store at the other end of the lot, or to exit the lot and get back on a main road, with as few convolutions as possible. The lanes that are used the most in this thought experiment should be mapped, with the rest being omitted. You can turn on the GPS points layer (Shortcut key Shift-G) to see where traffic is concentrated to get a sense of what needs mapping.
ParkingLotRoad ShoppingCenter.png

In particular, do not map every single lane, and especially not every single parking space (it has been done!). This serves no purpose but to clutter the map, confuse directions, and put an unnecessary burden on both the client and server hardware. Remember usability and simplicity are #1. Your editing time and expertise can be better used elsewhere in the map.

Small Parking Lots

Parking lots that serve a small number of businesses should be minimal: enough to give the driver correct directions into and out of the lot, and navigate to a particular business. Very small lots with one entrance and one exit could even be represented by a single segment running through the parking area (either a diagonal across the lot if it connects to roads on each side, or a single, flattened curve for strip mall-style lots with entrances and exit along the same road).

To permit a route to be given to exit a small parking lot from the same point the parking lot was entered, u-turns may be enabled at the ends of the parking lot road. This is particularly relevant where a single parking lot segment connects two different street segments such as is common for many corner gas stations.

Drive-Through Lots

Because drive-through lots can be narrow and congested, with one-way sections, the best way to represent them is often a one-way drive-through loop. Caveat: because both ends of a segment cannot connect to the same junction, if the lot has only one entrance/exit, it is necessary to build the loop using three segments.

Two parking lots connected to the same street

Bad routing can occur when two parking lots connect to the same street. This can happen, for example, where two lots face each other. If you connect both parking lots to the street using the same junction as the connection point for both, Waze will treat them as one parking lot.

If there are no turn restrictions preventing routing across the street, Waze may route the driver through one parking lot to reach a destination in the other parking lot. Waze is designed to avoid such routes, but in this configuration, Waze does not apply the expected penalty - because crossing through the junction from one parking lot segment to the other is not considered a transition, even though there is also a street running through the junction. This may be most easily understood by looking at the example image below.

If it is not legal to cross from one lot to the other, turn restrictions will prevent any sort of routing between the lots. However, if it is possible to route from one lot to the other, then a different method is required to prevent routing through one lot to reach the other.

To be sure that Waze will apply the transition penalty when routing through one parking lot from another, the two parking lots must be isolated from the each other such that passing from one to the other requires driving over a standard road segment (not a parking lot road or private road). You should use a short "stub" length no less than 5 m (16 feet) of a standard road segment. This segment will run from the junction to the entry/exit segment of one of the lots. With this configuration, exiting the parking lot will have a consistent penalty, whether the route exits the first parking lot to the street or the route leads to another parking lot at the same junction. The short stub may reduce display impact and will also signal other editors that the use of a different road type is not accidental.

Parking lots do not have to be across the street from each other. In a strip mall, if the exit segment of one business is joined to the entrance segment of the next business, the same problem can occur.

Illustration

For example, in the configuration shown below if routing from the west parking lot, there is no transition penalty to route through the gas station parking lot on the east side of the street if routing east on Riva Rd. Conversely, if routing to the west parking lot from Riva Rd. there is no transition penalty to use the gas station.

PLA.png


PLB.png
This potential problem arises when two parking lots on opposite sides of a street connect at the same junction node on the street.
PLC.png
If this configuration causes routing problems it can be solved by changing the road type of one (or both) of the parking lot roads that intersect with the street.
PLD.png
A five meter or longer stub of a different road type will accomplish the same result.
PLE.png
If the street is a divided highway, then the road type of the crossover segment may be changed (this may also allow U-turns at the crossover segment).

link title== New Roads ==

Recorded via Client

Once you start editing a road, it changes from red (a new road) to the colour of a road type (by default a white street) and will then appear on the next update of the Live Map which goes out to all Waze users.

So it is less than helpful if you do an incomplete job. At least if the road is red, then someone else knows that it needs work. If it is white, perhaps even with a street name, then it may look correct. But Waze may not view it as navigable.

Follow these simple steps, as best you can, and get it right the first time. Map Editing explains how to carry out these steps.

  1. Align the geometry of the road to the aerial image unless that is not appropriate in your area
  2. Enter the correct name and road type for your road, following the standards for your country
  3. Make sure the road has the correct directionality. Most roads should be Two Way.
  4. Add junctions where the road intersects with other roads. By default tick "Enable all turns". Restrict any turns that are not allowed. If a junction appears, just add a junction over the top. Chances are it does not have all turns enabled. Waze automatically handles turn restrictions for one way roads.


Roundabouts

  • A proper roundabout (i.e., produces "at the roundabout..." verbal cues) can only be created in WME.
  • When it is first created, the segments are configured as new roads - they need to be edited as above before they become part of the live map.
  • Please see Creating and Editing a roundabout for more information on creating these special intersections.

Classification of crossings

Different types of crossings have standard ways to handle them.