Map Editing Quick-start Guide
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
Create a junction
When you need two separate roads to intersect in the middle of each segment, lay one over the top of the other. Select one of the roads and with the Control key pressed, select the second road. You will see an intersection symbol. Press it to make the intersection between the roads.
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 red dot, 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.
- 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 red 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 looses 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)
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 indicates that travel is allowed from the selected segment in the direction of the arrow. A red arrow indicates that travel is not allowed (restricted) from the selected segment in the direction of the arrow. Clicking an arrow changes the color of the arrow. Each arrow must be set correctly for Waze to route correctly.
The green arrow has a small checkmark and the red arrow has a small x inside the arrow to aid color-blind editors.
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.
- 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-A', 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.
Dragging one junctions to another will join all segments from both junctions into a single intersection. This is great for those intersection where Waze has two nodes joining right-angle roads in two separate intersections. If there is a single segment connecting the two nodes, it will be automatically deleted.
- Make sure that there are no geometry points in the segment to be deleted. If you get an error, check for and delete any geometry points in the segment and try it again.
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 with with unnamed segments
Solve map problems
Below are the default keyboard shortcuts. You can customize some keyboard shortcuts by bringing up the keyboard shortcuts help window (with ? key), select a shortcut and then tap the shortcut you want to use instead. 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.
- ? (or [Shift]+[/] or [Shift]+[-] or [Shift]+[~] or [Shift]+[ù] ) - shows keyboard shortcuts
- d - delete node from road geometry while hovering cursor over it during road geometry editing
- 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 as described in the Selecting Multiple Segments.
- Delete (Del) - delete the 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
- e - when a/segment(s) are selected, activates Edit mode (shortcut for clicking the Edit button)
- h - when a/segment(s) are selected, activates House Number mode (shortcut for clicking the Edit House Numbers button)
- a - toggle connection arrows transparent or opaque so you can see beneath them and click items under them
- s - toggles separation of connection arrows so they do not overlap to ease clicking on either
- [Shift]+[z] - toggles display of disallowed connections (turns) for every segment/node in the view. When active, no green arrows are shown.
- 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.
- r - toggle segment direction between 1-way, reverse-1-way, 2-way and No Entrance (Undefined directionality)
- i - insert/draw new segment (equivalent to clicking Road under the big + button)
- o - draw new roundabout (equivalent to clicking Roundabout under the big + button)
- g - draw a new Gas Station (equivalent to clicking Gas Station under the big + button)
- p - draw a new Parking Lot (equivalent to clicking Parking Lot under the big + button)
- u - draw new landmark (equivalent to clicking Landmark under the big + button)
- [Shift]+[d] - toggles No Name segment highlighting
- [Shift]+[f] - toggles Full Screen mode
- [Ctrl]+[a] - Select Entire Street
- [Ctrl]+[z] - undo ([Cmd]+[z] also works on Mac)
- [Ctrl]+[Shift]+[y] - redo ([Cmd]+[Shift]+[y] also works on Mac)
- [Ctrl]+[Shift]+[z] - redo ([Cmd]+[Shift]+[z] also works on Mac)
- [Ctrl]+[s] - save ([Cmd]+[s] also works on Mac)
- [Ctrl]+[UpArrow] - increase Level of selected segments (if all Levels are the same)
- [Ctrl]+[DnArrow] - decrease Level of selected segments (if all Levels are the same)
- [Shift]+[b] - toggles Bing Aerials layer
- [Shift]+[c] - toggles Cities layer
- [Shift]+[r] - toggles Roads layer
- [Shift]+[g] - toggles GPS points layer
- [Shift]+[a] - toggles Area Managers layer
- [Shift]+[l] - toggles Landmarks layer
- [Shift]+[s] - toggles (speed) Cameras layer
- [Shift]+[p] - toggles (map) Problems layer
- [Shift]+[u] - toggles Update requests layer
- [Shift]+[e] - toggles Editable areas layer
- [Shift]+[o] - toggles Other users layer (Not currently available)
- [Shift]+[UpArrow] - zooms the map in one level
- [Shift]+[DownArrow] - zooms the map out one level
- Arrow Keys - pan the map in all four directions
- [Shift]+click and double-click - re-centers the map on at the clicked location and zooms in one level
There are also user-definable shortcuts for:
- Toggling the highlighting of Empty streets (segments with no name)