Waze Map Editor
This page is the key starting point for any editor of the Waze maps. Ensure that you read through the entire page to best prepare you for the many bits of information needed to make you a good map editor. People who edit the map without fully understanding many of these elements can do more harm than good with their edits. If you cannot find an answer to your question somewhere in the Wiki, be sure to post a question in the Waze Forums where many experienced Wazers will be happy to provide an answer. Just be sure you did your best to search for the answer in the Wiki here.
Usage of external maps
Usage of any external copyrighted source of information, in order to add information to the Waze database or maps, is not allowed. External copyright information includes any online or printed map information that is not provided by Waze like Google, Bing Aerial imagery.
The Road Maps History
The Waze map was started in many countries by importing publicly available road data. This data was fairly accurate in geometry, but could be out of date. It also did not include some details vital for a navigation system such as permitted travel direction, and distinctions between driveable roads and non-driveable ways, such as railroads and canals. The imported maps also did not indicate if a junction or bridge was present where roads crossed. Waze defaulted to a junction in all cases, and even though turn restrictions may show as being in place at these junctions, all turns are actually allowed if the segments have never been edited. This set of data was enough to get started, but definitely needed updating and maintenance.
This is where two key aspects of the Waze system come into play:
- The web-based map editing tools for Waze users to edit maps of their neighborhoods, cities or other places with which they are familiar.
- The collecting of GPS data from Waze users to modify the maps to set road direction and turning permissions at intersections.
Some countries had no data available for their road systems, so the maps for these countries must be built from the ground up by Waze users. The maps are created in the web editor using roads recorded in the Waze client and the stored GPS tracks of all Waze users superimposed over available aerial photography.
The Map Editor
Waze is currently using its second generation map editing interface (covered in this article). Known as the Waze Map Editor (or WME for short), it is the default editor for Waze since September 19, 2011. This editor interface is internally code-named "Papyrus", and was functionally upgraded on November 5, 2012. There are currently three different server farms managing the maps of the world. Be sure to log into the appropriate server when making edits to a particular part of the world. You can use the same username on all servers, but your editing points are managed separately by each server. Also the maps are not synchronized between the servers, so for example if you went to the North America server to modify parts of Europe, the different server supporting Wazers in Europe would not see your changes.
Map Editing Quick-start Guide
Learning the best map editing techniques for proper navigation and appearance takes some time and practice, but it can be a fun and rewarding experience too. You can be proud that you are improving the experience for all Waze users. The details in later sections of this page are important for you to learn, but for simple edits, there is a Map Editing Quick-start Guide to get you going quickly.
It is very important that all editors take time to read all the documentation found in the #Editing Manual to ensure the Waze map remains complete, accurate, and able to fully and properly route users.
Accessing the Waze Map Editor (WME)
The Waze Map Editor editor is currently officially supported on the Chrome browser only. It may or may not work on other browsers, but there is currently no official support for issues that might arise.
You can access the map editing page directly using the links above in The Map Editors section, or you can reach it from the Waze homepage as follows:
- For North American editors (USA, Canada, and some of Northern Mexico), login from http://www.waze.com
- For the rest of the world (excluding Israel), login from http://world.waze.com
- From the Waze homepage select the Login link at the top-right corner of the screen.
- Select "Live Map" in the main navigation header.
- Select "Update Map" located just above the map viewer.
Once logged in, your screen should look something like this:
For the sake of efficiency, you may also wish to bookmark the link directly to the map editor:
Using the WME, you can add, edit, or delete nearly any object within your editable area. If a road segment is locked by a user with a higher editing level than you, the road, intersection, or turn permissions connected to that road segment cannot be altered unless you chose one of the following:
- Place a request to the Update Request forums to unlock that segment by giving them a permalink with the segment or segments highlighted and a country manager may unlock it for you.
- Send a Private Message (PM) to the previous editor using the Forum PM functionality. As of the August 12, 2012 update, Area Managers are no longer able to override segments locked by higher-level editors.
- https://www.waze.com/editor/ for North America
- https://world.waze.com/editor/ for all other countries
Be sure to check out the Map Editing Tips and Hints page for some shortcuts for logging in to the map editor and other great pieces of information to enhance your map editing.
The Waze Map Editor has a practice mode called Play mode in which you can perform nearly every action available when logged into the Editor, except that you cannot save any changes. In order to save changes, you must log in. Play mode is helpful to and should be use by users who are new to map editing in Waze.
If you are a new editor, take time to read the editing manual and use the editor in Play mode, practicing the functions you would if you were logged in, but without the worry of permanently messing something up. Add, delete, update segments. Change their properties, direction, road type. Connect segments to other segments, try changing turn restrictions. Restrict all turns on a junction, build a roundabout, add a park landmark, build an overpass, delete extra junctions, give a segment a different name, an alternate name, set its level differently, etc.
Your editable area consists of:
- Areas within a certain distance of any location you have driven with Waze running in the past 3 to 4 months. This distance depends on your Editing Rank.
- Areas in which you have requested to be an Area Manager.
Once you have practiced all the functionality, go ahead and log in and try it for real.
Map Editing Basics
The Waze Map Editor editor was designed to be used without much documentation, but this list will give the quick basics for drawing a new road, roundabout, or landmark
- Click the item you want to create under the big + button
- For a road, click to start drawing, click to add a geometry node as you follow a path, and double-click (or shift-click) to end drawing
- For a roundabout, click at the center of the roundabout and move the mouse to size it. Click to create it. Note there must be roads leading into the roundabout first.
- For a landmark, or POI (Point of Interest), click to start the landmark and click as you follow the outline of the area. Double-click to end drawing.
- For each object, there are details you need to enter before saving, such as the city, street name, direction and level, or landmark type for landmarks.
- Click the Save button
You can also modify or delete existing map objects. You do this by selecting an object, then modifying its geometry, location or properties. What is possible with each object depends on the type of object. The Editing Manual is where you will find all the details necessary to understand all the editor functionality.
In the Waze Map Editor, a permalink is a URL used to take you or someone else directly to a specific map location. It stores and encodes the latitude, longitude, zoom level, visible layers, and any objects such as roads, junctions, or landmarks which are selected at the time the permalink is recorded.
To create a permalink to your current map editor view, first set the zoom level and select any road segments or junctions you want to point out to the user who will view the permalink. Use the multiple select option for your browser (CTRL-LEFT-CLICK for Windows-based systems). You can right-click the Permalink hyperlink at the lower right corner of the browser screen (see image). That will bring up the option to copy the URL into your computer clipboard.
Alternately you can left-click the hyperlink to reload the page which updates the URL at the top of the browser window which you can highlight and copy. With this method, be sure to first save any unsaved changes because this operation of the Permalink button will reload the browser window and lose any unsaved changes.
If you notice the road layer does not match the Bing aerial layer, you can press the Permalink button to regenerate the screen and clear up the misalignment. If instead you use the browser reload option the map will move to the location of the last time you pressed the Permalink button.
The last permalink is saved with your user profile. When you restart the browser and go to the Waze Map Editor, it will automatically take you to the last permalink you recorded.
When sharing a permalink be aware that what the recipient can see is limited by the recipients permissions. For example, editors cannot see update requests (URs) or map problems (MPs) outside their editable area. Thus, when posting a permalink regarding a UR or MP in the forums, be aware that only local editors, area managers for the area and country managers for the country will be able to view the UR or MP. If you wish for a broader audience to view the issue raised in a UR or MP, you will need provide the relevant information such as by posting a screen shot of the open UR or MP.
Below are the default keyboard shortcuts for the Waze Map Editor. 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 one. 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)
Map Update Timing
Edits made in the online editors do not appear on the LiveMap nor client immediately. Waze has a long-term goal of 24hr update processing, but that isn't happening yet. Please see the Timeline of updating process page for more detail on the various processes Waze runs and expected update timing.
- Map Editing Quick-start Guide
- Best map editing practice
- Map Editing Tips and Hints
- Map Editor Interface and Controls
- Map Legend
- How to label and name roads
- Update Requests in Waze Map Editor
- Map Problems in Waze Map Editor
- Creating and Editing street segments
- Fixing "smudged" cities
- Creating and Editing a roundabout
- Creating and Editing a landmark
- Overpasses, Underpasses and Bridges
- Updating the map
- Editing ranks
- How to handle road closures due to long-term construction, natural disasters, etc
- How to add ferries (TO DO)
- How to add tunnels (TO DO)
- How to add a new road to an existing junction
- Naming of roads crossing a dual carriage way
- Editing more than one road
- Warning on possible lack of accuracy in aerial images
- Carpool, HOV, Transit lanes
- Automatic map updates and the locking of roads
- To report map editor performance issues, use the Quick Help form on the Support Page
- Outdated Aerials - a form to report locations where the current aerial imagery is out of date
The Style Guides are important for understanding the nuances of road network design in Waze. Please take time to read, and reference them in the future when you come upon a tricky intersection.
Using External sources (such as Google Imagery)
Usage of any external copyrighted source of information, in order to add information to the Waze database or maps, is not allowed. External copyright information includes any online or printed map information that is not provided by Waze like Google Aerial imagery.
Using any source of external copyright information, such as Google Aerial imagery, puts the Waze maps under danger of being forced to revert all changes done to the map in your area / country.
If any user were to do such a thing, it would taint all the work that person did on the maps and Waze would need to reverse out all those edits. There could also be other adverse effects. Waze has already had to remove all the maps for Chile, and other South American countries because the source of the map data was not properly licensed (not the result of any Waze action).
So do not use Googze as a way of applying Google's aerial images as a replacement for Waze's licensed images when doing map editing.
Users may negotiate with officials in their country for access to aerial images that Waze can use. The user must be careful not to give the impression that they are acting on behalf of Waze. But as an interested citizen any user can speak with local authority, in a local language, to explain the benefits to their country in making aerial images freely available as a public good.
Note that external copyright information does not include any source of information that is provided by Waze through the internal tools of the online editor or application. Also any information developed independently by a user being physically present at a site is acceptable to add to the map as long as it is provided without copyright.