View source for Map Editor Interface and Controls View history

[[Waze Map Editor#Editing Manual |Back to Map Editing]]

==Map Editor Layout==
There are three main areas of the Map Editor:
# Toolbar
# Tabs Area
# [[#Map Display Area|Map Display Area]]

[[Image:wme12_17 whole window blank.jpg|700px]]

* At the top, a toolbar with a search box, and buttons to Add, Save, Undo, Redo, and Delete
* At the left is a Tabs Area where information is shown or made available to edit in one or more tabs
* When there are no objects selected on the map (Map Problems and Update Requests are not considered map objects)
* At the bottom of the left area are some important links for all editors to know, such as the Map Editing wiki start page, the Waze Map Editor forum, current Waze status website and keyboard shortcuts link. (Shortcut key: ?)
*# '''Me''' displays your wazername, permissions level and current points, a link to the map editing video and editing manual
*#* '''Drives''' displays an historical archive the drives you taken with Waze running on your smartphone
*#* '''Areas''' shows a list of areas you are allowed to make edits within
* When a segment is selected
*# '''General''' allows updating  the segment attributes such as road type, direction, level, toll road, and locked and other segment details. In "Edit Mode," the General tab also displays and allowed editing of country, state in the US, city, and segment name. This is also where you can manage any alternate names (linked streets).
* At the top of the main display area below the toolbar, is a wide area which displays:
** To the left will be the current city and state (US), or Country (outside North America).
** To the right is a loading indicator which appears only when map elements are still loading.
* In the top-right corder of the main window, inside the main window space, is the activator for the layers menu.
* The map display area, which takes up the majority of the space is explained in more detail below in the [[#Map Display Area|Map Display Area]] section.


==Map Editor Tool Bar==

[[Image:wme31 top toolbar.jpg|700px]]

At the top of the Waze Map Editor you will see the main tool bar. It includes the primary control buttons for the editor.

===Search box===
[[Image:wme31 757 mohawk columbus oh search results.jpg|left|300px]]
In the wide search box, you can enter an address, city, state, country, landmark,  point of interest, or a combination of those. After hitting Enter or clicking the Find button, you will either be taken to the only result, or be given a list of matches from which to select.

For example, entering "757 Mohawk St, Columbus, OH" will center the map and drop a search marker directly on that address.
{{clear}}

[[Image:wme31 main st newyork search results.jpg|right]]
However, searching for "main st, new york" is less specific and will therefore give you a list of matches from which to select.
{{clear}}

===Add Button===
[[Image:wme31 button add.jpg|left]]  Shortcut keys: '''i, o, g, p''' or '''u'''
[[Image:AddMenuList.png|right]]

The Add Button is not really a button, but a menu. You do not need to click on it; just hover your mouse over it and the menu of objects you can add will appear below. Alternately you can use the shortcut keys for each one:

* r - Road
* o - Roundabout (think circle = O)
* g - Gas station (specific landmark)
* P - Parking lot (specific landmark)
* u - Landmark (default landmark type)

Details for each of these actions are found in the Editing Manual under their name.

===Save Button===
[[Image:wme31 button save.jpg |left]] [[Image:wme31 button save pending.jpg]] [[Image:wme31 button save pending red.jpg]] Shortcut key: '''Ctrl+s'''
{{clear}}
The Save button serves two purposes: 1) it displays the current number of changes pending to be saved, and 2) when clicked, it saves all the current changes you have made.

As you make changes, the counter in the Save button increases. Once you have more than 9 changes pending, the text in the icon changes to red as a warning that many unsaved changes may be difficult to save if there is a single error among the changes.

When the button is clicked (or the shortcut key used), the editor saves all of the current changes you have made. This process is a little more complex than this sounds, but that is what it does. In order to save properly, your browser receives messages back from the Waze server in the event of any errors. If there is an error when saving, the editor will try to give you a detailed error message and a suggestion to fix it. The map view will typically try to show the error area highlighted in a bright circle.

''Once the save operation completes successfully, you cannot Undo previous changes with the Undo button.''

===Undo Button===
[[Image:wme31 button undo.jpg|left]] Shortcut key: '''Ctrl+z'''
{{clear}}
The Undo button will undo '''unsaved''' successive previous changes with each click. {{Red|IMPORTANT: Once the Save button is clicked and the save operation is complete, the Undo button has no effect on previous changes.}}

A change can be deleting a geometry node from a segment or renaming a landmark. It can also be a change to multiple objects at once. For example, if you multi-select 25 street segments to change them from No Entrance to 2-way, that is considered a single change. Therefore, one click on Undo will undo that change for all 25 segments.
{{clear}}

===Redo Button===
[[Image:wme31 button redo.jpg|left]]  Shortcut key: '''Ctrl+Shift+z'''
{{clear}}
The Redo button will re-apply any changes which have been recently undone with the Undo button.
{{clear}}

===Delete Button===
[[Image:wme31 button delete.jpg|left]] Shortcut key: '''Delete (Del)'''
{{clear}}
The Delete button will delete, or trash, any currently selected objects. If you have multiple objects selected, you will be prompted to confirm the multiple deletion. The only object you can currently multi-select is segments.

Undo does work for deleted objects. Objects are not actually deleted until the Save button is clicked. After that, you cannot Undo any edits or deletes.
{{clear}}

==Tabs Area==

At the left side of the window, below your username, is an area which is both informational and functional. Depending on whether an object is selected, the type of object and how many, different tabs will be available which allow you to view and edit details.

===Tabs with No object selected===
{| style="float:right"
| [[Image:wme31 hey username.jpg|left]]
|-
| [[Image:WME_Tabs.png‎|left]]
|}

When no objects are selected on the map, the Tabs Area displays user information. The top section greets you by name and is always visible regardless of what is showing or displayed on the map. Map Problems and Update Requests are not considered map objects, so the tabs below your name will display when a Map Problem or Update Request is selected.


====Me Tab====

[[Image:Wazer-with-premission.png]][[Image:permission_levels.png]]

The '''Me''' tab displays your [[Your Rank and Points|map editing permission level and current points]] for the [[Banks of Servers|server]] on which you are editing (North America or World).

A Wazer with a hard hat displays if you have editing permissions. To the right of that icon will be a highlighted cone with a number. This number is your [[Your_Rank_and_Points#Map_editing_rank|editing rank]]. Below those graphics is a sentence about your editing rank and permissions.

Below your user information is a box graphic which when clicked, will open up a boxed panel leading to seven videos from Waze. The videos are titled as follows:
# Introduction
# Before You Start
# Getting Started
# Basic Terms
# Basic Editing
# Map Problems
# Examples

This animated guide is a good way to get an overview of the Waze map editing system and some of the processes. These videos are only an introduction, and the information contained in the Waze wiki documentation is where you will find the most detail on the editor and, importantly, guidelines for mapping standards.


====Drives Tab====

The Drives tab enables you to see the history of routes you've driven with Waze running. Clicking on an entry will center the map along your route and will zoom out to try and fit your entire route on the screen. Routes over 20 miles will usually not fit on the map display all at once due to scale limitations. Parts of the route that display in red are not currently paved roads. Consider [[Map_Editor_Interface_and_Controls#Zoom_Control|zooming]] into that area to determine if a road should be added.

<!--PRIOR TEXT: 
From the route display, you can choose to create any segment of your drive which does not already exist. These segments are shown in red. Be careful not to create roads over existing segments. Check the map first!
-->
====Areas Tab====

This list is of the various defined areas of which can perform edits. This is known as your [[editable area]].

===Tabs when segment(s) are selected===
[[Image:wme12_17 segments selected editmode.jpg|right]]The area above the tabs will show how many segments are selected. The example graphic to the right shows what the Tabs Area looks like when multiple segments are selected and the General tab is in "Edit mode."


====General Tab====
The '''General''' tab displays the segment name and alternate names details at the top. Just below that information is an Edit button. More info on that below. On this tab, you can modify the road type, toll road checkbox, direction, level, and lock checkbox. Further down past a seperator line is more general details about the segment(s) which is/are selected.


=====Segment Edit Detail=====
When you click on the Edit button, or tap shortcut key 'e', the General tab changes, displaying more detail information and allows you to make changes to the country, state (US only), city and segment name. Next is where you can add or remove any alternate street name information. An alternate name, technically referred to as a "linked street," is used to capture detail such as the state or US route name of a street as it goes through an urban area where it is commonly referred to with a local name. The local name would be put into the primary name field, but the highway name can be entered as an alternate name. An alternate name street must also have the same city as the primary segment.

Be sure to review the [[Road_Naming_(USA)|naming convention used in your area]] before changing names.
{{clear}}

=====Select Entire Street=====
[[Image:Wme12_17 segment selected.jpg|right]]When you click the button titled "Select Entire Street," or use the keyboard shortcut Ctrl+a the editor will select all segments connected to the current segment with the same name, city, state, country information. It will also select some segments off the current visible area.


=====Edit House Numbers=====
When you click the button titled '''Edit House Numbers''', or use the keyboard shortcut 'h', Waze enters the [[House_Numbers_in_WME|House Number editing interface]].

<u>TAKE NOTICE:</u>
*The '''Edit House Numbers''' button appears when there is only one segment selected.
*The '''Edit House Numbers''' button isn't available to click when there are changes which need to be saved. The message, "Save your changes to edit house numbers" appears below the button.
{{clear}}


===Tabs when a Camera is selected===
[[Image:wme3 camera tab speedcam.png|right]] When a camera is selected, there is a single '''General''' tab which allows you to set the alert speed for a Speed Camera, and also to approve the camera once it is placed in the correct location. Red Light Cameras only need to be placed and approved and have no speed set.
{{clear}}


===Tabs when a landmark is selected===

{| border="0" cellpadding="2" style="background:none;"
|- style="vertical-align:top;"
| With a landmark selected, there is a single '''General''' tab which allows you to select the landmark type, give it a name, a description, and a checkbox to lock the landmark to prevent changes by lower ranking editors:

|
| Below that is an address details section which displays the landmark's assigned Country, State (in the US) and City. ''Click'' the '''Edit''' button to change any values and ''click'' '''Apply''' when complete:

|-  style="vertical-align:top;"
| [[Image:wme31 landmark tab.jpg]]
|
| [[Image:wme31 landmark address details.jpg]]


Setting the proper address details will allow Waze to utilize their own internal search for landmarks which appear only in Waze and not in other search provider results.
|}
{{clear}}


===Tabs when a Gas Station is selected===

[[Image:Us gas station landmark.png|right]]
When a gas or petrol station landmark is selected, the view is very similar to that of a generic landmark. There are some more fields of data which need to be filled in or verified as part of the Gas Stations functionality in Waze.

For the Waze application to be as useful as possible to drivers, it is important to ensure all fields of information are fully and properly completed. For more details about completing this data, please see the [[Gas Stations in Waze Map Editor|Gas Stations]] page.
{{clear}}


==Map Display Area==

All the layers currently selected for display show up in the map display area. The map display areas takes up the majority of the browser window. Any object displayed is selectable and editable, depending on your editing rights in the area you are viewing. Select a street and change its geometry. Select a landmark and change its name. Add a road where one should be, or delete a road which should no longer appear.

There are six main component controls or displays in the corners of the map display area:
# Info Bar
# Layers
# Zoom Control
# StreetView Activator
# Scale
# Lat/Lon
# Permalink
{{clear}}

[[Image:wme31 control elements highlighted.jpg|700px]]
{{clear}}

===Info bar===
[[Image:wme31 info bar.jpg|700px]]

Just below the main toolbar, there wide area which runs the width of the map display area. 

* The left side will display the current city and state (US) or city and country (world).
* The right side displays whether the editor is still loading any layers, such as road images or GPS points.
{{clear}}

===Layers===
[[Image:layers.png|right]]On the right-side of the main window, you will see this small icon:
{{clear}}

[[Image:Wme layers expanded.jpg|left]]When clicked, it expands to display the layers or object types which are available for display on the main map. When the box next to the layer name is checked, then that layer is active and being displayed. There is a default shortcut key defined for each layer, and to make it easy to remember, with one exception: The shortcut is '''Shift+<first letter of layer name>'''. The exception (currently) is the satellite/aerial imagery, which uses the letter '''i''' as the shortcut key for '''I'''magery.

The four small dots to the left of a layer selector box is a drag handle which allow you to rearrange layers order. That is, which will appear on top of the other.  PLEASE NOTE: The layer order is reversed from what we would normally expect. Layers at the bottom of the list are on top of the layers above.

Each of the layers is discussed in more detail later, but a short description of each is directly below.
{{clear}}

====Satellite Imagery====
[[Image:Aerial_skinny.png|260px]] Shortcut key: '''Shift+i'''

Waze uses aerial and satellite photography provided by Bing (or VirtualEarth).
{{clear}}

====Cities====
[[Image:cities_skinny.png|260px]] Shortcut key: '''Shift+c'''

City boundaries as defined by segments assigned to that city are shown in different colors. This layer is helpful in finding segments which are set to the wrong city. Until an area is heavily edited an updated, some city boundaries are likely to be overlapping or appear to be unassociated with any segments.
{{clear}}

====Roads====
[[Image:Road_segments_skinny.png|260px]] Shortcut key: '''Shift+r'''

Roads are all of the streets, alleys, highways, and freeways which make up the driveable street system in Waze. Depending on the [[#Zoom_Control|zoom level]], some street types are not displayed so that the map is not too cluttered.
{{clear}}

====GPS points====
[[Image:Gps_tracks_straight_skinny.png|260px]] Shortcut key: '''Shift+g'''

This layer will show tracks from Waze users as they drive with Waze running. Waze records and plots the GPS coordinate of drivers. This layer is useful for relatively accurate placement of new or moved roads when aerial photography is not yet updated. GPS points appear in the map editor as colored arrows. The direction of travel for a GPS point determine its color, so that all drivers going the same direction will show their points in the same color. This makes it easier to determine errant GPS points, or where a road on the map doesn't follow the actual path of vehicles.
{{clear}}

====Area Managers====
[[Image:Wme3 area managers layer skinny.png|260px]] Shortcut key: '''Shift+a'''

The Area Managers layer shows overlapping colored, named rectangles. These areas represent the areas those users have Area Manager permissions. This layer allows you to identify a user you may wish to send a PM in the forums about a specific issue you noticed in their area, but do not have rights to fix.
{{clear}}

====Landmarks====
[[Image:Landmarks_skinny.png|260px]] Shortcut key: '''Shift+l'''

Landmarks are also known as POIs (Points of Interest). These can really be just about anything, but tend to be things like parks, gas stations, cemeteries, transit stations, etc. Landmarks appear in the map editor as colored shapes.
{{clear}}

====(Speed) Cameras====
[[Image:Speed_cam_enabled.png]] [[Image:Red-light_cam_enabled.png]] Shortcut key: '''Shift+s'''

Speed cameras, red-light cameras and dummy cameras are shown on this layer. Drivers report camera location and type, and a map editor is required to confirm the existence of the camera, precise location and direction the camera is point before it will appear on the client. Confirmed cameras will pop up a visual and audible alert in the Waze app when approaching a speed or red light camera.

See [[Cameras|cameras]] for more information.
{{clear}}

====Problems====
[[Image:Problem_pin_open-low.gif|left]][[Image:Problem_pin_open-med.gif]] [[Image:Problem_pin_open-high.gif]] Shortcut key: '''Shift+p'''
{{clear}}
The Waze servers are constantly analyzing driver's GPS tracks to determine when there might be a problem with the map and uses the Problems layer to alert the editors. Some types of problems tracked are missing roads, incorrect turns allowed at intersection, wrong direction of road.

See [[Map Problems in Waze Map Editor|map problems]] for more information.
{{clear}}

====Update Requests==== 
[[Image:Request_pin_open-low.gif|left]][[Image:Request_pin_open-med.gif]] [[Image:Request_pin_open-high.gif]] Shortcut key: '''Shift+u'''
{{clear}}
These are user-submitted map issues while on the road or from LiveMap. This marker shows the location the user reported the issue from. The user's driven route for a distance before and after the reported location will be shown in bright green. If Waze was in navigation mode at the time of the report, the requested route for a distance before and after the reported location will be shown in purple, with markers along the route with the turn direction given to the user.

See [[Update Requests in Waze Map Editor|update requests]] for more information.
{{clear}}

====Editable areas====
[[Image:Editable_area_skinny.png|260px]] Shortcut key: '''Shift+e'''
{{clear}}
Where you can edit is determined primarily by where you have driven. Edit rights are initially granted within a one-mile radius of where you have driven with Waze running. Your editable area is shown in lighter-colored areas surrounded by a black border. Users who are Area Managers will also see their managed areas in a colored highlighted area.
See [[Waze_Map_Editor#Editable_Area|editable area]] for more information.
{{clear}}


===Zoom Control===
[[Image:Zoom_controller.png|left]] Shortcut key: '''Shift+UpArrow''', '''Shift+DownArrow'''

In the upper left corner, the zoom control is one way to adjust the zoom level, or altitude, or the map display area. Clicking + will move in closer, showing more detail. Clicking - zooms out/higher and removes detail. You can also click and drag the selector in between the + and - buttons.

The other methods for controlling the current zoom level is covered below in the section on [[#Moving around the map|Moving around the map]].
{{clear}}


===StreetView===
[[Image:Wme sv lens blue.gif]]

<u>To Activate StreetView</u>, drag the blue lens icon from under the zoom control to the street for which you want to get the street level Google images.

Once the lens has been dropped, the lens will have an arrow inside it which points in the direction StreetView is pointing. You can drag the lens using the small white handle, similar to the drag handle for House Numbers.

[[Image:Wme streetview directional arrow.gif]]

In StreetView mode, all normal editing operations are available. However, you will find that the reduced editing area can make for difficult editing. Clicking on a Map Problem or Update Request will reduce the editable map area further. And writing in the Conversations for an Update Request makes the visible editable area quite skinny, unless you have a very wide monitor.

[[Image:Wme streetview ur convo.jpg|700px]]


When you are editing and activate all these different modes at the same time, be sure you know the Keyboard Shortcuts because control like map zoom will be covered up and can only be accessed via the keyboard.

<u>To Close StreetView</u>, ''click'' the '''X''' at the top right-hand corner of the StreetView pane.


===Scale===
{| style="float:left; background: transparent;" width="400"
| [[Image:scale_display.png|left]]
|-
| In the lower left corner is a small graphic showing the current scale of the map display area.

The values in the scale relate to the [[zoom|zoom level]] you see in the URL address of the web browser. Changing the zoom level alters the displayed scale.
|}
{| style="float:right;"
| {{ZoomLevel}}
|}
{{clear}}

===Lat/Lon===
[[Image:lat-lon_display.png]]

In the lower-right corner is a control showing the latitude and longitude of the mouse pointer as it moves over the map.
{{clear}}


===Permalink===
[[Image:wme31 permalink button.png]]

Directly to the left of the Lat/Lon Display is a box with the word "Permalink." 

{{permalink}}
{{clear}}


==Moving around the map==
* Move around the map by clicking and dragging on the map itself
* Keyboard arrow keys will pan the map
* The keyboard shortcut '''Shift+f''' will hide the Waze top banner bar and put the editor into "Fullscreen Mode"
* There are four ways to zoom the map:
# There is a zoom controller on the top left-hand corner of the map. You can either drag the slider up and down, or click on the + and - buttons.
# Double-clicking any point on the map will zoom in one level and center the map on that point.
# Scrolling up with your mouse wheel will zoom in on a certain point, and scrolling down will zoom out, keeping the mouse pointer's location in the same location. On Macintosh systems with a track pad or similar mouse device, dragging left and right performs this action
# Hold the ''Shift'' key down and then click and drag a rectangle on the map. The map will then zoom in onto the selected area:
[[Image:wme31 shift_zoom.jpg|500px|center]]


[[Waze Map Editor#Editing Manual |Back to Map Editing]]