Map Editing Quick-start Guide
- 1 Logging in
- 2 Common Functions
- 2.1 Layers
- 2.2 Create a Road
- 2.3 Removing a road
- 2.4 Connect roads
- 2.5 Delete a Junction
- 2.6 Loop roads
- 2.7 Turn restrictions (allowed turns)
- 2.8 Selecting Multiple Segments
- 2.9 Create a roundabout
- 2.10 Create a Landmark
- 2.11 Bridge junction
- 2.12 Overlapping road junction
- 2.13 Splitting a segment
- 2.14 Joining junctions
- 2.15 Disconnecting a road
- 2.16 Select entire street
- 2.17 Solve map problems
- 2.18 Keyboard shortcuts
- 3 Tips and Hints
Be sure to select the appropriate server based on the part of the world you are editing.
If prompted to login, use the same username and password as you do on the Waze client app and the rest of the Waze website.
All of the following sections use terms that are defined in the glossary for your clarification.
For more details on the available layers, see the map editor interface and control section on layers.
Create a Road
- Hover the mouse over the button in the toolbar at the top of the page and click Road.
- Click the mouse on the map at the point where you want to start the road segment.
- Move the mouse cursor along the path of the road and click the mouse to add a geometry node for each point that changes direction along the road.
- When finished, double-click (or shift-click) the last point to end the segment.
- Pressing ESC will abort the road segment creation.
- Be sure the road or roundabout actually exists before creating it.
- Each segment that is added must minimally have the Country and State information added to it or it will stay as a red line and not be seen in the live map after the next update.
For more detail on creating road segments, see Creating and Editing street segments.
Removing a road
- Click on a segment with the mouse
- Click the Trash Can icon in the toolbar or hit the Delete key on the keyboard
You can select and delete multiple segments at one time, but the keyboard Delete key will not work for that. You have to use the Trash Can icon and then confirm you want to delete those segments.
When drawing new segments, or moving segments around, the editor will auto-junction roads.
- For new roads, if you start and/or end the drawing on an existing segment, a junction is created
- For existing roads, if you move the end of a segment onto an existing segment, a junction is created
- If you move a junction to an existing segment, that junction is now part of that segment and any roads connected to that segment previously are all now joined together
Be sure to check the turn restrictions for your newly created junctions.
Delete a Junction
A junction is a small blue diamond which connects two or more segments. Junctions with only two segments might seem unnecessary, but may actually have a purpose. Before deleting any two-segment junction be sure the junction is not present for one of these reasons:
- A change in the road name, city, state, or country.
- Part of a loop road preventing routing errors.
If you are certain the junction is not fulfilling one of the above purposes, then you can remove it with one of three ways:
- Click on the junction, and it will change to a blue dot with a green outline; then click the trash can icon, or use keyboard shortcut Delete or Del key (not backspace).
- Select segments on either side of the junction, and click the Bridge icon which appears over the junction. Note that this will also increase the level of the segments by 1, so this method is best used only when replacing an inadvertent junction with an overpass.
- The third option is not recommended, but if the segment is very short, you can select one junction at one end of the short segment to make it blue with green outline, and drag it to the other end of the segment. This method has three drawbacks: a) all road data will be lost from that segment, b) if there are geometry nodes on that short segment, they must be deleted first to prevent errors when saving, and c) the new junction will have turn restrictions not previously set that will need to be reviewed from each segment entering the junction.
Remember that all elements of the road name, city, state (where applicable) and country must match for the first two options to work. The third option would not care because it is effectively deleting the segment and merging the other two adjoining segments (which loses road data).
You will also find additional information related specifically to Overpasses, Underpasses and Bridges in that section.
When drawing a road which connects to the same segment at both ends, only the ending junction is created. To create the starting junction:
- Move the end of the new segment away from where it is
- Drop it
- Move it back to where you want the junction to be
When drawing a road segment that starts and ends at the same junction, the above may not work, and if it does, turn restrictions at that junction will be wrong. Split the looping segment somewhere along its length by following the instructions in Splitting a segment. Then join the remaining segment end to the common junction and apply normal turn restrictions.
Turn restrictions (allowed turns)
Review the information on soft and hard turn restrictions before reviewing the information below. This section will be updated soon to reflect these changes.
For details of how to set up time-based turn or time-based segment restrictions, please read the Scheduled Restrictions page.
Set by selecting a segment which will allow you to see the connectivity arrows and modify these allowed turns at each end of the segment.
- A green arrow means Allowed
- A yellow arrow with a clock means Scheduled
- A red arrow with the circle-slash icon means Restricted
- Clicking an arrow toggles between Allowed, Restricted, and if a scheduled restriction is in place, Scheduled. Each arrow must be set correctly for Waze to route correctly.
NOTE: The slashed-circle icon for Restricted and clock icon for Scheduled turns were put in place to allow editors who have various forms of color blindness to be able to differentiate between the three different types of turn arrows.
The Purple question mark shows that the all the turns at that end of the segment have not been locked (confirmed) by an editor. Click any turn arrow to lock them. A purple question mark at the end of a segment is also referred to as a Soft Turn. Locking it, removing the purple question mark, makes it a Hard Turn.
Where the arrows appear depends on the road. One-way roads will only have arrows at the end, and roads with unknown directionality will have no connectivity arrows at all.
Two-way segments will also show the small u-turn arrow icon at both ends of the segment. This is used, as its named suggests, to prevent/enable Waze to use a segment end node as a u-turn, in case of necessity. When setting the u-turn arrow to green, make sure that u-turn is possible AND LEGAL in real life. In any other case, set the arrow to red for drivers security. Just as with other turn restrictions, allowed u-turns must be set on a per-segment-per-end-node basis. This very granular control is required for quality route selection.
NOTE: The U-Turn doesn't have a proper navigation announcement (i.e. "Make A U-Turn"), but it will still route you that way. The current policy is to disable all U-Turns UNLESS the road is a divided highway that doesn't meet the requirements to be split.
U-Turns at the end of dead-end-streets
For the definition of a dead-end-street (or cul-de-sac, or court in the US), please read : https://www.waze.com/wiki/Junction_Style_Guide#Cul-de-sacs
When creating or editing dead-end-streets, please make sure that, at the end node, the small u-turn arrow is RED, with no interrogation mark (question mark).
Due to a bug in Waze, we need to make sure that Waze thinks that a U-turn is not allowed on a dead-end, even though in reality it must be. If you allow the U-turn (green U arrow), or even don't disable the soft turn (red U with question mark), Waze may route drivers onto the block for no reason, have them make a U-turn, and then continue the trip.
In the following examples, the only correct edit is number 2 :
Please also remember that a dead-end-street must always be a 2-way street.
Turn restrictions Tips
- Press s to separate overlapping arrows.
- Press a to toggle connection arrows transparent or opaque so you can see beneath them and click items under them
If an intersection should not have any restricted turns, you can easily enable all turns. Initial turn restrictions on roads are set automatically by the Waze routing engine. Automatically set turns can be altered by the routing engine, but manually set turns cannot. Unfortunately both automatic and manually set restricted turns are represented by red arrows and cannot be distinguished. Currently when you use the option to enable all turns, it will not fully change the routing from automatic to manual for the turns. To clear the automatic routing for an intersection start by selecting the junction with the mouse. Then you can choose between mouse clicks or keyboard shortcuts. With the mouse, in the properties toolbox, click the link to "Disallow all connections" and then "Allow all connections". Alternately you can use the keyboard shortcuts by pressing the letter 'q' to disallow all connections followed by 'w' to allow all connections (see keyboard shortcuts).
To see all currently restricted turns for all intersections on the map press 'Shift+z', which will toggle between the turn settings for one selected segment and the turn restrictions for all intersections.
See the section set allowed turns for more information.
Selecting Multiple Segments
Some edits require that you select two or more segments of road. Other times, you want to apply the same change to multiple segments. In the default select mode, you must use the modifier key below:
- Mac: Command + Click
- Windows: Ctrl + Click
- Linux: Ctrl + Click
When in multi-select mode (keyboard shortcut m), you do not have to use the modifier key.
Create a roundabout
- Hover over the at the right side of the toolbar click on Roundabout.
- Click the map at the center of the roundabout.
- Move the mouse outward to the correct size of the roundabout.
- Click to finish.
- There must be roads that touch the roundabout when you click to finish, otherwise no roundabout will be created.
- Roundabout drawing is circular by default. Ellipse drawing can be enabled by holding down the Shift key while adjusting the roundabout size.
- Roundabouts can be created over existing junctions and segments. Any roads within the shape of the roundabout will be truncated, and any junctions within the roundabout shape are deleted.
- To delete a roundabout, you must delete ALL segments of the roundabout. You cannot save your work without deleting all segments of the roundabout. When saved, the roundabout node will also be deleted.
Create a Landmark
- Hover over the at the right side of the toolbar click on Landmark
- Click a point of the map on the edge of the landmark
- Move the cursor along the path and click to add a geometry node to define the shape
- Shift+click (or double click) anywhere to stop drawing and complete the shape
- Select the new landmark and define the type of landmark and a name in the Properties drawer
- The new editor has a different list of landmarks from the old editor. The new list is much shorter, clearer, easier to work with and includes some landmarks that were missing before (such as 'beach'). However, it is also missing some often-used landmarks from the past.
- The properties of the segments to be bridged must be identical or you will not see the bridge icon
- Bridging automatically increases the level of the new merged segment by 1 more than the highest level of the two segments. You can change it, of course, if it needs to be a different level.
Generally if two segments can be joined, if you select the junction you can press the trash can icon to have them join as well. If the trash can icon does not appear, the segments are different in some way and that might be the reason there is a junction in the first place.
- For more detail, see Overpasses, Underpasses and Bridges.
Overlapping road junction
Two roads set to the same level which cross each other can be joined by an intersection easily. This is useful if you draw several new roads for a neighborhood by drawing segments from end-to-end and allowing new segments to cross each other. Once drawn, you can junction them using this method.
Both roads must be set to the same level. You can often use this method with unconfirmed (red) roads, but sometimes the editor will refuse to do this process until the roads are confirmed. Additionally, changing zoom level sometimes helps to get the sometimes-stubborn junction creator icon to appear.
- Select both segments
- Click the which should appear above the intersection
- Note: The sign won't appear if the roads cross each other multiple times
- A junction is added
Splitting a segment
There are three options for splitting a segment, or adding a junction to the middle of a segment:
- Add a new segment from nowhere to the point of the segment you want to split. A new junction will be added. Delete the new segment just created.
- Add a new segment from the spot you want to split to nowhere. A new junction will be added. Delete the new segment just created.
- Disconnect one end of the segment. Draw a new segment from the segment end to the node it used to connect to.
In all these steps, the junction which was automatically added will remain.
When joining or removing a junction, there are a few considerations that should be taken into account. Please review the more detailed article on junction removal.
Disconnecting a road
Select the segment. Drag the end you want to disconnect away from the junction.
Select entire street
- Select a segment
- In the tabs area, click the Select entire street button.
- Any segments connected to the first segment with the same properties will be selected and can be edited as a group.
- If there is a gap or a street with a different name or other different property, it will not allow the selection to go beyond it. You will need to edit in multiple passes in this case.
- Select entire street will not work with unnamed segments
Solve map problems
When using Waze Map Editor, there are a number of keyboard shortcuts available to make editing the map a bit easier if you prefer the keyboard over the mouse. Below are the default keyboard shortcuts. You can customize some keyboard shortcuts by bringing up the keyboard shortcuts help window (with the ? key), select a shortcut, and then press the single key you want to use instead of the default key. This affects the current browser and computer only. This shortcut information is not stored on the server, so you would have to repeat this for each computer and browser you use.
|F||move the cursor to the search box|
|shows the keyboard shortcuts|
|Delete||delete the single selected object (segment, junction, landmark). To delete multiple objects, you must click the trash can icon and confirm the multiple delete.|
|Esc||deselect all objects|
| Alt+⇧ Shift+R
⌥ Opt+⇧ Shift+R
|reload all layers (refreshes map without using a permalink; preserves the chat window)|
|I||draw (insert) a new Road/Segment (equivalent to clicking Road under the draw road icon)|
|O||draw a new Roundabout (equivalent to clicking Roundabout under the draw road icon)|
|D||delete a geometry node from a road segment while hovering the cursor over it during road geometry editing|
|E||when one or more segments are selected, activates Edit mode (shortcut for clicking the Edit button)|
|H||when a segment is selected, activates House Number mode (shortcut for clicking the Edit House Numbers button)|
|M||toggle multi-select mode. Default behavior is that to select multiple segments, you must use the modifier key to multi-select. When toggled active, multi-select mode lets you select multiple segments without using the modifier key.|
|R||toggle segment direction between 1-way (A->B), 1-way (B->A), and 2-way while updating road details. See road direction for more information.|
|T||when one or more segments are selected, activates Restrictions mode (shortcut for clicking the Add/Edit Restrictions button) - mnemonic Time-restrict|
|select Entire Street - mnemonic Select All|
| Ctrl+⇧ Shift+Y
⌘ Cmd+⇧ Shift+Y
| Ctrl+⇧ Shift+Z
⌘ Cmd+⇧ Shift+Z
|increase elevation of selected segments (if all elevations are the same)|
|decrease elevation of selected segments (if all elevations are the same)|
|Junctions and arrows|
|Q||disable all connections for the selected junction which makes the turn arrows all red for that selected junction.|
|W||allow all connections for the selected junction which makes the turn arrows all green for that selected junction. Note that this key will only enable all turns that had not previously been automatically enabled by the Waze routing server, called soft allowed turns. The soft allowed turns have a higher penalty than turns enabled by the editor. Therefore since soft and editor allowed turns have the same color green, if it is known that all turns are enabled at a particular intersection, it is better to first force all turns to disabled with the Q key and then press the W key to force them all to editor enabled.|
|Display and layers|
|⇧ Shift+A||toggles Area Managers layer|
|⇧ Shift+C||toggles Cities layer|
|⇧ Shift+D||toggles No Name segment highlighting|
|⇧ Shift+E||toggles Editable areas layer|
|⇧ Shift+F||toggles Full Screen mode|
|⇧ Shift+G||toggles GPS points layer|
|⇧ Shift+I||toggles Satellite Imagery layer|
|⇧ Shift+L||toggles Landmarks layer|
|⇧ Shift+V||toggles Live users layer|
|⇧ Shift+P||toggles (map) Problems layer|
|⇧ Shift+R||toggles Roads layer|
|⇧ Shift+S||toggles (speed) Cameras layer|
|⇧ Shift+U||toggles Update requests layer|
|Alt+C||toggles Chat window|
|Alt+⇧ Shift+R||reloads layers|
|⇧ Shift+↑||zooms the map in one level|
|⇧ Shift+↓||zooms the map out one level|
|↑↓←→||pan the map in all four directions|
| ⇧ Shift +click
|re-centers the map on at the clicked location and zooms in one level|
|⇧ Shift +click + drag mouse||draws a temporary rectangle and zooms into that portion of the map|
Red ⌘ Cmd keys are for Apple Mac systems