Map Editing (new Editor)

From Wazeopedia

Revision as of 16:03, 12 October 2011 by Alanoftheberg (talk | contribs)

The Road Maps

The Waze map was started in many countries by importing publicly available road data. This data was fairly accurate in geometry, but could be dated. 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. 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:

  1. The web-based map editing tools for Waze users to edit maps of their neighborhoods, cities or other places they are familiar with
  2. 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, 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 Editors

  • Waze currently uses two different map editing interfaces:
    • The default editor for Waze is code-named Papyrus. It was made the default on September 19, 2011
    • Cartouche is the code name for the original editor and was the main editor prior to Papyrus. It is still available until all necessary functionals are replicated in Papyrus.
  • When editing the Waze maps, please follow the best map editing practice. You should also be aware of known Papyrus issues or missing features and bugs and quirks with Cartouche.
  • Editing your route on the map (Papyrus)
  • With the web-based editor, you can add, edit or delete nearly any object within your Editable Area, which is within a 1-mile radius of any location you have driven with Waze running.
  • If you are looking for advanced editing permissions, you must become an Area Manager or perform specified numbers of edits.

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.

Accessing the Map Editor

  • The default Papyrus editor is currently supported on the Chrome browser only. It may work on other browsers, but it is not currently supported
  • Log in to your account from the Waze homepage using the Login link at the top-right corner of the homepage:
    • For North American editors (USA and Canada), login from
    • For the rest of the world, login from
  • 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:

Papyrus sample post login.jpg

Map Editing Basics

The Papyrus 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

  1. 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 to end drawing
    • For a roundabout, click at the center of the roundabout and move the mouse to size it. Click to create it
    • 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.
  2. 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.
  3. 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 and zoom level, visible layers, and any objects such as roads, junctions, or landmarks which should be highlighted and selected.
  • A permalink to your current map editor view, whether you are in Papyrus or Cartouche, is generated and placed in the address bar of your browser by clicking the "Permalink" hyperlink at the bottom-right corner of the map. To copy or share your URL, you can right-click the Permalink directly and copy the link or cut and paste it from the browser address bar.
  • Please note that a permalink is not generated every time you change the display of the editor, so if you recover a browser session of the editor, it will revert to the last map location for which you generated a permalink.

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, you do not have to use the modifier key.

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 Segmetns section.
  • Delete (Del) - delete the selected object. To delete multiple objects, you must click the trash can icon and confirm the multiple delete.
  • Esc - deselect all objects
  • 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+a - 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
  • w - allow all connections for the selected junction
  • r - toggle segment direction between 1-way, reverse-1-way, 2-way and No Entrance
  • 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)
  • u - draw new landmark (equivalent to clicking Landmark under the big + button)
  • 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)
  • Shift+click and double-click - re-centers the map on at the clicked location and zooms in one level

Editing Manual

Google aerial images cannot be used

This section needs to become its own page. Google's terms of use means that Waze cannot use their aerial images.

Those terms of use also apply to you. You cannot use Google's aerial images to edit Waze's maps. In some jurisdictions you may be able to use them as a reference (like looking at a map in a mapbook), but not as an overlay as with the Greasemonkey script Googze.

If you were to do such a thing, it would taint all the work you did and Waze would need to reverse out all your edits. There could 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 Waze's fault).

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.

You may negotiate with officials in your country for access to aerial images that Waze can use. Just be careful not to give the impression that you are acting on behalf of Waze. But as an interested citizen you can speak with local authority, in a local language, to explain the benefits to your country in making aerial images freely available as a public good.