Map Editing Quick-start Guide

From Wazeopedia

Revision as of 17:37, 30 September 2011 by Alanoftheberg (talk | contribs)

Logging in

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.

Common Functions

Overlays (Layers)

Show and hide the various overlays by clicking the Layers button.png icon at the right side of the map display area.

Create a Road

  1. Hover over the Add button.png at the right side of the toolbar click on Road or Landmark
  2. Click the point of the map where the segment starts
  3. Move the cursor along the path and click to add a geometry node to define the shape
  4. Double click at the end point of the segment

Connect roads

When drawing new segments, or moving segments around, the editor will auto-junction roads.

  1. For new roads, if you start and/or end the drawing on an existing segment, a junction is created
  2. For existing roads, if you move the end of a segment onto an existing segment, a junction is created
  3. 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

Loop roads

  • When drawing a road which connects to the same segment at both ends, only the ending junction is created. To create the starting junction:
  1. Move the end of the new segment away from where it is
  2. Drop it
  3. Move it back to where you want the junction to be

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. Where the arrows appear depends on the road. One-way roads will only have arrows at the end, and No Entrance roads will have no connectivity arrows at all.

  • Press s to separate overlapping arrows.
  • Allowing all or disabling all turns can also be done by selecting a junction and using the links in the Properties drawer.

Create a roundabout

  1. Hover over the Add button.png at the right side of the toolbar click on Roundabout
  2. Click the map to center of the roundabout.
  3. Move the mouse outward to the correct size of the roundabout
  4. Click to finish
  • 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

  1. Hover over the Add button.png at the right side of the toolbar click on Landmark
  2. Click a point of the map on the edge of the landmark
  3. Move the cursor along the path and click to add a geometry node to define the shape
  4. Double click anywhere to stop drawing and complete the shape
  5. 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.

Bridge junction

  1. Select two adjacent segments which will be bridged together
  2. Click the bridge icon over the junction
  • 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.
  • For more detail, see Overpasses, Underpasses and Bridges.

Create a junction

There is no tool built specifically to create a junction in the middle of a segment. This is because the editor creates a junction automatically when two segments are joined. However, you can create a junction by following the steps below in the Splitting a segment section.

Overlapping road junction

Two roads set to the same level which cross each other can be joined by an intersection easily.

  1. Select both segments
  2. Click the Crossing road add junction.gif which should appear above the intersection
  3. 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.

Joining junctions

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

  1. Select a segment
  2. In the Properties drawer, click the Select entire street button.
  3. 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.

Solve map problems

Only available for the US and Canada Server at this time.

Temporary Map Problems Explanations

Keyboard Shortcuts

  • d - delete selected node from road geometry while editing road geometry
  • m - toggle multi-select mode. Default is that to select multiple segments, you must use the modifier key to select multiple segments. When toggled active, multi-select mode lets you select multiple segments without using the modifier key as described in the Selecting Multiple Segments 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 - connection arrows turn transparent
  • s - spreads connections arrows so they don't touch
  • Shift+a - show all disallowed connections (turns) for every segment/node in the view
  • 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
  • Ctrl+Shift+y - redo
  • Ctrl+Shift+z - redo
  • Ctrl+s - save

Tips and Hints

Login Position

To start Papyrus at a particular position, (your home),

  1. Adjust the map display area the way you want it to start up in each time
  2. Click on the permalink link in the bottom right corner
  3. Bookmark this URL, and you'll always be at 'home' when you start Papyrus
  • The editor opens at the last location you were editing by default.
  • You can still create a bookmark from the Permalink and use that bookmark to open the editor
  • Sometimes, it is advantageous to allow the editor to open in the previous location, in case you have edits to do in a previous editing session

Editing with roads hidden

You can edit roads and nodes without the road layer actually showing on the screen. Turn off the Aerial overlay layer. This is useful for aligning to aerial images.

Streets with no name or city

  • To create or edit segments without a city and/or street name, you must use the check the "No name" box for these fields.
  • Newly drawn streets can be saved without entering a city or street name, but they will show in red on the map and will not be available in the client or for routing
  • When drawing a new road, it cannot loop back onto itself and create a junction. You must use two segments.

Adjusting geometry of multiple selected segments

When multi-selecting streets (such as setting neighborhood streets to set them as two-way), you can also adjust geometry of any selected segment as you hover over it without losing the selection set.

Editing a junction locks it

In areas with base maps, there is a distinction between junctions created or updated by the editors and junctions that have never been touched and were created during the base map upload process.

These junctions appear as if at the turns are forbidden, but you can route as if the turns are allowed. The routing algorithm will prefer routing using segments and junction whose turns are explicitly set by the users, but in case where there is no alternative, or it is fairly longer, it will route through where there are no explicit allowed turns.

Setting a road to 2-directional will not change the status of its nodes. However, once the node is edited, they are assumed to be strictly valid, just like nodes in areas without base maps.

Editing ranks and the locking feature


We are working on a permissions scheme that will enable users to gain 'editing' credit, using ranks from 0 to 5. The new scheme will be based on the user's experience as well as the 'importance' of each road.

Locking Segments

When you lock a segment, only a user with the same rank or higher can change this segment. At the moment this includes all edits, including connecting a different, unlocked segment to it.

Speed cams

  • The last person to edit the speed cam or red light cam is basically locking it to his rank. A user with a lower rank will not be able to change or delete the camera, unless he is the owner of the camera or if it's in his area of management.
  • The camera direction (the direction from the center of the image to the red circle) defines the driving direction for the camera. The current camera image implies that the camera captures the traffic from behind. Don't be fooled.
  • The "30" on the speed cam icon is just part of the image and is not an indication of the actual speed the speed camera is set to.
  • The client warns about a speed camera if it is valid, points in the same direction as the road segment, and the driver is exceeding the limit set on the camera.
  • The client warns about a red light camera if it is valid and points in the same direction as the road segment.

Moving between oldCartouche and the New Editor

During the time of transition from the Cartouche map editor and the new editor, there are functions which are not yet available in the new editor. Some switching back and forth may be necessary, especially for viewing Update Requests in the old Cartouche editor.

To facilitate switching back and forth with the same view, here are two code snippets you can use for a bookmarklet in any modern browser. Even easier is a drag-n-drop solution on this dropbox page (AlanOfTheBerg's dropbox).

Open Cartouche in Papyrus

javascript:(function(){var center_lonlat=new OpenLayers.LonLat(,;center_lonlat.transform(new OpenLayers.Projection("EPSG:900913"),new OpenLayers.Projection("EPSG:4326"));'http://'+window.location.hostname+'/cartouche/?zoom='+('&lon='+center_lonlat.lon+'&lat=','Papyrus');})();

Open Papyrus in Cartouche

javascript:(function(){var center_lonlat=new OpenLayers.LonLat(,;center_lonlat.transform(new OpenLayers.Projection("EPSG:900913"),new OpenLayers.Projection("EPSG:4326"));'http://'+window.location.hostname+'/cartouche_old/?zoom='+(wazeMap.zoom)+'&lon='+center_lonlat.lon+'&lat=','oldCartouche');})();