Back to Editing Manual
This article covers creating and editing road segments. Be sure to read this whole article to ensure you fully understand all aspects of how segments operate in Waze before you start to create and edit roads on the map.
Creating a new road
You have a location where there should be a road where there isn't one in Waze, such as a recent suburban development. The following series of screenshots and instructions walk you through the process of adding a road to Waze from scratch. The screenshots are from an area of Little Rock, Arkansas, US and we are working on adding the roads missing in the highlighted area shown here:
Set up the map display such that you can see a good portion of the area you need to add the road to, setting the zoom level appropriately such that you will be able to follow the curves in the road as you draw it.
There are four steps essential to add roads to the Waze map:
- Draw the road, including junctions to existing segments
- Confirm the road properties
- Set allowed turns
- Save the changes
Drawing the road
Hover the cursor over the large + icon at the top of the screen in the toolbar and click Road. You can also use the keyboard shortcut which is the letter i, for Insert. Move the cursor to the location you want to start drawing the road. This can be an empty location, or can be on an existing segment where you want the intersection with this new road. The cursor has a small blue circle to indicate it is in drawing mode.
When you hover over an existing segment, it will highlight showing that if you click right there, a junction will be automatically added for you where you start drawing.
Move your mouse along the path of the road, and as you follow along the aerial or GPS points for the new road, every time you click, a geometry node is added, keeping your new road aligned with your cursor movement. When you reach the end location for the new road, double-click the mouse. You will exit drawing mode, and the new road will display in orange to signify that it is unsaved. If you want to remove the road just drawn, before you exit drawing mode, you can press the ESC key on the keyboard.
In the situation being describe here, there is another road in this same view which is missing. We can add another road to the map without having saved the first one, which is a great timesaver. The next screenshot shows the second road already added and auto-junctioned to the first segment we added.
At this point, you can save the newly added roads if you wish. However, the process of properly adding the roads is not complete. These roads are currently still set as 1-way, with no associated city and no street name. Adding those details to the road is required before they will show up in the Waze client app, and is discussed below in the Updating details to confirm roads section below.
Note: When creating special roads like roundabouts and loops, be sure to follow the special considerations for those roads in those linked sections.
Confirm the road by updating details
New roads will not be displayed on the Waze app until they are confirmed, meaning anyone editing the map (including yourself) sets the country, state (for the US), city and street name. In the map editor, unconfirmed roads are displayed in Red in the editor and will not display in the Waze mobile app until they are confirmed by someone. Unconfirmed roads can be both roads drawn in the editor and paved (recorded) from the app.
To confirm a road, select one or more segments with the mouse. Notice in the case below, we can see these are two 1-way segments. Once selected, if the properties drawer has not slid out to the left, click the tab to open it. Notice below that for the one road, there are now two segments. That is because the second road we added has split the original road into two segments, which is normal and expected. In the future you can confirm roads one by one before adding other intersecting roads, or select the multiple segments and confirm them all at once. Note that you cannot add multiple road names to multiple roads. You can only add one road name to one or more segments.
To edit the address details, click the Edit Address link under the Properties tab. This will enable editing of fields above it. When multiple segments are selected, you need to select Country (and State for locations which support it) as well as entering in city and street name information. If this is a location outside a city, use the "No Name" check box. For streets with no name, private drives or parking lot roads, use the "No Name" check box.
For [[1]], do not enter a street name. Leave it as "no city" to allow proper navigation routing through the roundabout.
When complete, click the Apply button, then set the correct Road Type, Direction and Level. For neighborhood streets in these examples, Street is appropriate, they are 2-way streets and they have no roads above or below them, so Level 0 is correct.
- Please be aware the the directionality type 'No Entrance' does not prevent Waze from routing onto a road. 'No Entrance' really means 'Undefined'. When the direction is set to 'No Entrance' Waze will automatically adjust the directionality of the road as Wazers drive it. This is the initial directionality of all roads after a base map import. In addition, the locked checkbox does not prevent the directionalty from changing on 'No Entrance' roads as Wazers drive it.
Again, you can choose to save now, but there is one last step which needs to be completed before we can call this process complete: setting the allowed turns.
Set allowed turns (connections)
We've added our roads and confirmed them, but we haven't set from and to which roads can be legally driven. In the real world, sometimes two 2-way segments are connected, but direction of travel is restricted in a certain way, due to such things as a median barrier being across the road. However, in our suburban neighborhood example, these streets can all be driven to and from each other, but our screenshot to the left shows red arrows, meaning that Waze won't navigate that direction from the selected segment.
In situations where not all turns are allowed, you would click on each arrow to turn red for a disallowed direction from that segment or green to allow that turn. This needs to be done for each segment that is added to the map. The default setting after connecting a new segment to another road is to disallow all turns to the new segment.
If all turns are allowed, then the faster way is to enable all turns by selecting the junction and not the individual segments.
Select the junction and it will turn from an orange circle to a red circle with a white border. If you have already selected a segment connected to that junction, sometimes you need to click elsewhere on the map to deselect that segment before you can select the junction.
Look to the Properties drawer and you will see action links for this junction. Depending on the current state of the junction, both or either Allow all connections or Disallow all connections links will appear. For example, if all connections are currently allowed, then only the disallow all connections link will appear.
To enable all turns at an intersection, click the Allow all connections link for both of the junctions created. Alternately you can use the keyboard shortcut W to allow all connections and the shortcut Q to disallow all connections.
Other helpful turn arrow keyboard shortcuts are:
- Shift+A - Toggles between: 1) showing the enabled and restricted turn arrows for the selected segment, and 2) showing all restricted turns (red arrows only) for every junction on the visible map (up to zoom level 4 or 500 ft showing on the lower left map legend).
- a - Toggles between making the turn restriction arrows being directly selectable (opaque) or transparent to enable selecting objects below them on the map.
- s - Toggles between separating turn arrows so they don't overlap making them visible and leaving them overlapped. This can also be used to refresh the screen when you have toggled visibility for all restricted turns and you have been changing the turn restrictions and the screen has not been refreshed.
To see all keyboard shortcuts, press the ? on the keyboard.
Save
Up to this point, you may have saved your progress or not. If not, click the Save button now (or use the Ctrl+s keyboard shortcut) and all of your updates will be sent to the Waze servers for processing. After the save is complete, and if there are no errors, you will be presented with the final product of this process:
It is good practice to save your changes often and certainly when you get more than 10 unsaved changes pending. Sometimes you may run into an error when you save that you cannot determine what is wrong and you have to undo many prior edits, sometimes all the way back to your first edit. Saving regularly limits your exposure from having to undo and redo large amounts of work in case of unresolvable errors.
Editing existing roads
Editing an existing road or segment is not very different than creating a new road. Once a road is drawn from scratch, before it is saved, all of the editing functions described here work just the same.
Adjusting road geometry (nodes)
Adjusting road geometry is changing the shape or the way a road segment looks. You need to do this for roads after they are realigned in real life, or perhaps a whole area is in the wrong place because the basemap import has the roads in the wrong place.
The instructions here, while written initially for editing an existing road segment, also apply to a new road segment you just created, but have not yet saved. The editor treats them the same.
To start adjusting the geometry of a segment, click on it. As it is highlighted, when you hover over the segment, geometry nodes (black squares) and internodes (white circles) will display along the segment. Both of these are draggable so that you can reposition them wherever you need. When you drag an internode from its default position half-way between two nodes, it will turn into a node.
To delete a node, which you would want to do to straighten out a section of the segment, hover the cursor over a node and hit the d key on the keyboard. This only works with nodes, not internodes. When you have a long straight stretch of road, and you see there are nodes located along it's length, it makes sense to delete these as it makes the road segment more simple and easier to display on the Waze client app.
When complete, the segment appears with a different geometry than at the start.
Don't forget to save!
To see these operations more easily, you can watch a video of adjusting segment geometry.
Fix the end-node on cul-de-sacs and dead-ends
In order for the Waze Application to properly route from a location on a cul-de-sac or dead-end road, the end of the last segment must have an end-node (or dead-end-node). Without this end-node, Waze will give the instruction Proceed to Highlighted Route.
In the image to the right you can see a small blue square at the end of the long court, and no blue square at the end of the short court. The short court is missing an end-node at the end of the segment.
When you select each segment putting them into an edit mode, you can see the difference between the two roads. The long court has the end-node (small white circle) and the short court has a geometry node (large black square) at the end of the segment.
To add an end-node to the short court, a temporary road segment must be added to the current road. Start by not having the road selected (make sure it is white by clicking elsewhere on the map). Hover the cursor over the large + icon at the top of the screen in the toolbar and click Road. You can also use the keyboard shortcut which is the letter i, for Insert. Position the cursor so the blue circle appears at the end of the segment and Left-click the mouse to start the road.
Click some distance away from the end of the current road and double click to end road creation. Select the newly created segment and press the Delete key or the Trash Can icon from the toolbar.
Save the changes and the result will show the small court now has the proper end-node showing as a small blue square (when not being edited or selected).
Note that most cul-de-sac should not terminate in a roundabout or loop, but as a dead end as drawn here.
Junctions
Before making any change to a junction, be sure to review the Junction Style Guide for information on the best practices for creating junctions. There are many times when a junction may be drawn in a way that does not seem logical, but it is very important to the navigation engine in Waze.
Moving junctions
Moving a junction is as simple as dragging the junction to another location, however there are geometry nodes (black squares seen when editing a segment) that may need to be adjusted as well.
First use the mouse to select the intersection of the road segments. This will put a red dot circled in white on the junction indicating you have selected all segments connected to the junction. Release the junction and move the mouse away until the cursor appears as a 4-way crossed arrow 
. If the red dot appears transparent, it means that one of the road segments is locked above your editing level and cannot be removed without assistance from a higher level editor.
With the cursor now appearing as a crossed arrow, select the red junction again and drag it to the desired location. The harsh angles in the road are caused by the geometry nodes of the segments and will need to be adjusted next. It is important to position the junction in a location that is not on top of a segment. That makes it difficult to adjust the geometry nodes and in some cases will tell the editor to merge junctions if one is present below the junction you are moving.
The black geometry nodes can be moved, removed, or added as explained in detail above. Adjust them to align with the visual map or the known GPS tracks.
Merging junctions
There are times when just two segments are linked to each other with a junction. In general they are not a problem, but they do make future map edits a bit longer to process and can be the source of unrecognized incorrect turn restrictions. However, it is very important to study the two segments before merging their respective junctions (or segment ends) to ensure they are not intentionally present.
| Legitimate Reasons for Two-segment Junctions |
|---|
| One of the segment properties is different at that point, i.e., city name changes, road name changes, road type changes |
| The segments are part of a loop road and require the extra junction to allow the Waze routing engine to properly navigate through the loop. |
Once you are certain there is no reason to have the extra junction, there are two methods to remove it. One method highlights the two segments and bridges them together and the other method will drag one junction on top of the other junction.
Bridge segments
This method may be the preferred method to start because it enables the WME to alert you when there are possibly legitimate differences (listed in the table directly above) between the segments giving the junction a purpose. When the segments are different, the special bridge icon will not appear at the junction.
With the mouse, select one of the segments and then holding down the multi-select key (Control for Windows/Linux and Command for Mac) select the second segment. If the two segments have the same properties, a small bridge icon will appear above it. Click the bridge to merge the two segments eliminating the junction between them. A geometry node will be placed where the junction was previously located. To remove the node (if necessary), select the segment (it will turn blue) and hover the mouse near the old junction. The geometry nodes should be displayed and you can press the d key do remove the unwanted node at that point.
Drag together
This method has the distinction of ignoring any differences between the segments on either side of the junctions to be merged. It should only be used when you are certain there is no legitimate reason for the segments to be different.
With the mouse, select one of the junctions to be merged turning it into a red circle with a white ring around it. Next drag it toward the other junction while watching for any acute angles in the segment between them. If they appear, it means there are geometry nodes between the two junctions, and they need to be removed before the two nodes will properly merge. If there are no geometry nodes between them, simply lay the red junction on top of the second (target) junction and they will be merged. Note that any turn restrictions previously set on either junction will need to be reviewed to ensure they are set correctly using the procedure above.
Allow/Disallow connections
Changing the allowed and disallowed turns in a junction follows the same procedure for controlling them when updating a road segment described above.
(Re)Moving a road from a junction
Updating road details
The details of a road can be entered as discussed with regard to confirming the details of a new road above. The procedure is the same for updating the details of an existing road segment.
To update details, first, select the segment(s) you need to update. Click on the segment and the segment will turn blue.
Multiple segments may be selected by holding down the modifier key and clicking additional segments. The modifier key for Mac is the command key, for Windows the control key and for Linux the control key. Each selected segment will turn blue.
Once selected, if the Properties Toolbox has not slid out to the left, click the tab to open it.
Address Properties
At the top of the properties toolbox are the address fields. The address fields include Country, State (currently only in the United States), City and Street. Alternate street names are displayed but can not currently be edited in the waze map editor. To edit the address details, click the Edit Address link. This will enable editing of fields above it. The Country (and State) fields may be updated by selecting a different country (or state) from the dropdown selections. Selections will only be provided for countries (or states) that are present on other nearby road segments.
The city and street names may be updated by typing a new name. See Naming for guidance on choosing the correct street name. As a name is typed, Waze provides a list of similar names. These similar entries can be selected by clicking them. If the segment is in a location outside a city, the "No City" check box should be selected and the city name will be blank. If the road does not have a name, the "No Street" check box should be selected and street name will be blank. Entries must be present for each address property. To eliminate a city name or street name the appropriate "No City" or "No Street" box must be checked. When complete, click the Apply button. If no changes are to be made, the cancel link may be selected.
If the above Address Properties are not set for a segment, the road will display as a red line in the editing map only and it will not appear in the Waze client app after the next update. This process is part of the road verification process. When the Waze client app uses the pave option, the road is created in the edited Waze map only. That Wazer or another Wazer who is editing the map in that area must set these properties in this section in order for the road to be seen in the client.
Road Properties
In the middle of the properties toolbox are the road segment properties.
Road Type
The road type is changed by selecting the appropriate road type from the drop down box.
See Labling and the Map_Legend for further guidance on selecting the correct road type.
Road Direction
The direction of the road is changed by selecting the appropriate direction from the drop down box.
If traffic may travel both ways on the road, select "Two way." If traffic may travel only one-way on the road, one of the "One way(→)" or "One way(←)" selections is appropriate. Selecting "One way(→)" results in a one way street in the native direction of the segment. Selecting "One way(←)" results in a one way street in the opposite direction. Each road segment has a native direction. This native direction does not necessarily correspond to any particular direction on the map (the native direction may be north, east, south, west or any direction that the road segment was created in). If you created the road as discussed above, the native direction will be the direction from the point you clicked to start the road segment towards the point you double clicked to end the road segment. There is no current way to discern the native direction of a two-way or unknown road segment by looking at the editor. Therefore you must simply choose one of the "One way" choices without knowing which is correct. If you guess wrong, choose the other. When you select a "One way" direction, black arrows showing the direction of travel will appear on the segment.
After the road properties are saved, the direction is indicated by blue chevrons on the road.
Base mapped roads are originally assigned the direction of unknown. When the direction is set to unknown Waze will automatically adjust the directionality of the road as Wazers drive it. When editing make every effort to determine the correct direction of the road and choose either "Two way" or the appropriate "One way" direction.
Road Level
The road level should be changed where one road passes over another. By default, the Level of a segment is 0 (zero). When two segments overlap, the value of Level for each segment must be different. This ensures that the Waze problem detection system doesn't flag the spot where two segments overlap as a location where a junction might be needed. See Bridges for more information on levels.
Locked Box
The segment is locked by checking the locked check box. For information on the effect of checking the locked box see Locked Roads.
Changing turn restrictions
Each intersection of two or more segments keeps track of the allowed directions you can turn from one segment to another. Changing these turn restrictions follows the same procedure as outlined above in the section on Set allowed turns.
Separator line (disabled)
The original map editor before the Waze Map Editor had the ability to add a black separator line down the middle of a road segment. It caused difficulty with map editing and was removed as a feature from the updated WME. The Waze developers will eventually have all of the current separator lines removed from the map. Until that time they should be ignored.
Roundabouts
See Creating and Editing a roundabout for guidance on roundabouts or traffic circles.