Map Editor Interface and Controls: Difference between revisions Discussion View history

(Updated for 11/5/2012 release)
Line 1: Line 1:
[[Map Editing (new Editor)#Editing Manual |Back to Map Editing]]
[[Waze Map Editor#Editing Manual |Back to Map Editing]]


=Map Editor Layout=
==Map Editor Layout==
There are four main areas of the Map Editor:
There are three main areas of the Map Editor:
# Toolbar
# Toolbar
# Properties Toolbox
# Tabs Area
# Layers (overlays) selector
# [[#Map Display Area|Map Display Area]]
# [[#Map Display Area|Map Display Area]]


[[Image:papyrus whole window blank.png|700px]]
[[Image:wme31 whole window blank.jpg|700px]]


* At the top, a toolbar with a search box, and buttons to Save, Undo, Redo, Trash and Add
* At the top, a toolbar with a search box, and buttons to Add, Save, Undo, Redo, and Delete
* At the left are two elements:
* At the left is a Tabs Area where information is shown or made available to edit in one or more tabs
*# In the background, is
* When there are no objects selected on the map (Map Problems and Update Requests are not considered map objects)
*#* Your username and current points total
*# '''Me''' displays your wazername, permissions level and current points, a link to the map editing video and editing manual
*#* Your editing level
*#* '''Drives''' displays an historical archive the drives you taken with Waze running on your smartphone
*#* My Places, which, when expanded, can show your Areas you have edit rights, and your Drives (archived routes)
*#* '''Areas''' shows a list of areas you are allowed to make edits within
*#* Below all that is some information about helping to improve the map in various ways
* When a segment is selected
*# In the foreground is an expandable toolbox which displays the properties of the currently selected object. Any editable properties are edited from this properties toolbox.
*# '''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 dark gray bar which displays:
*# '''House Numbers''' allows updating a single segment's house number range. If more than one segment is selected, the House Numbers tab doesn't appear.
** To the left will be the current city and state (US).
* At the top of the main display area below the toolbar, is a wide area which displays:
** To the right is an indicator showing the number of changes currently executed on the map which need to be saved.
** To the left will be the current city and state (US), or Country (outside North America).
** Immediately to the left of the unsaved changes indicator is a loading indicator which appears only when map elements are still loading.
** 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.
* 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.
* 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=
==Map Editor Tool Bar==


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


==Search box==
==Search box==
Line 35: Line 34:
For example, entering "757 Mohawk St, Columbus, OH" will center the map and drop a search marker directly on that address.
For example, entering "757 Mohawk St, Columbus, OH" will center the map and drop a search marker directly on that address.


[[Image:757_mohawk_columbus_oh_search_results.png|300px]]
[[Image:wme31 757 mohawk columbus oh search results.jpg|300px]]


However, searching for "main st, new york" will get you a list of matches to select from.
However, searching for "main st, new york" will get you a list of matches to select from.


[[Image:Main_st_newyork_search_results.png]]
[[Image:wme31 main st newyork search results.jpg]]




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


The Add Button is not reall a button but actually 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.
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.


From this menu, you can add a Road, a Roundabout, or a Landmark. Details for each of these actions are found in the Editing Manual.
From this menu, you can add a Road, a Roundabout, Gas Station, Parking Lot or a Landmark. Details for each of these actions are found in the Editing Manual.


==Save Button==
===Save Button===
[[Image:Button_save.png|left]] Shortcut key: '''Ctrl+s'''
[[Image:wme31 button save.jpg |left]] [[Image:wme31 button save pending.jpg]] [[Image:wme31 button save pending red.jpg]] Shortcut key: '''Ctrl+s'''


The Save button 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 if there were 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 also show the error area highlighted in a bright circle.
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.


Once the Save button is clicked and the save operation completes successfully, you cannot Undo previous changes with the Undo button.
As you make changes, the counter in the Save button increases. Once you have more than 9 changes pending, the icon changes to red as a warning that many unsaved changes may be difficult to save if there is a single error amongst the changes


==Undo Button==
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 if there were 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 also show the error area highlighted in a bright circle.
[[Image:Button_undo.png|left]] Shortcut key: '''Ctrl+Z'''
 
''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'''


The Undo button will undo '''unsaved''' successive previous changes with each click. <span style="color:red;">IMPORTANT: Once the Save button is clicked and the save operation is complete, the Undo button has no effect on previous changes.</span>
The Undo button will undo '''unsaved''' successive previous changes with each click. <span style="color:red;">IMPORTANT: Once the Save button is clicked and the save operation is complete, the Undo button has no effect on previous changes.</span>
Line 63: Line 66:
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.
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.


==Redo Button==
===Redo Button===
[[Image:Button_redo.png|left]]  Shortcut key: '''Ctrl+Shift+Z'''
[[Image:wme31 button redo.jpg|left]]  Shortcut key: '''Ctrl+Shift+Z'''


The Redo button will re-apply any changes which have been recently undone with the Undo button
The Redo button will re-apply any changes which have been recently undone with the Undo button


==Delete Button==
===Delete Button===
[[Image:Button_delete.png|left]] Shortcut key: '''Delete (Del)'''
[[Image:wme31 button delete.jpg|left]] Shortcut key: '''Delete (Del)'''


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.
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.
Line 76: Line 79:




=Left Background=
==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===
When no objects are selected on the map, the Tabs Area displays user information. Map Problems and Update Requests are not considered map objects, so the tabs below will display when a Map Problem or Update Request is selected.
 
[[Image:wme31 hey username.jpg]]


At the left side of the window is an area which is both informational and functional. The sections are discussed below.
The top section greets you by name and is always visible regardless of what is showing or displayed on the map.  


==User information==
[[Image:hey_wazername.gif]]


The top section greets you by name and displays your current point total for the server you are editing on (North America or World)
====Me Tab====


==Editing Permissions==
[[Image:Wazer-with-premission.png]][[Image:permission_levels.png]]
[[Image:Wazer-with-premission.png]][[Image:permission_levels.png]]


The second section displays a Wazer with a hard hat if you have editing permissions. To the right of that icon will be a highlighted cone with a number. This number is your editing rank. Below those graphics is a sentence about your editing rank and permissions.
The '''Me''' tab displays your permissions level and current points for the server you are editing on (North America or World).


==My places==
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 editing rank. Below those graphics is a sentence about your editing rank and permissions.
[[Image:my_places_button.png]]


Below your editing permissions is a section called "My places" which, when expanded, allows you to view either Areas you can edit, or your Drives (routes) you've done with Waze running.
Below your user information is a box graphic which when clicked, will open up a lightboxed panel featuring seven videos from Waze. The videos are titled as follows:
# Introduction
# Before You Start
# Getting Started
# Basic Terms
# Basic Editing
# Map Problems
# Examples


===Areas I can edit===
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.
[[Image:Areas I can edit button.png]]


This list is of the various defined areas of which you are an area manager.


===Drives===
====Drives Tab====
[[Image:drives_button.png]]


Drives allows 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 20miles are will not fully fit. 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!
Drives allows 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. 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!


==Help improve the map==
====Areas Tab====
[[Image:help improve the map.png|left]] Until the "My places" section is expanded, the "Help improve the map" section is visible below "My Places." This is where Waze puts some information about how the map editors can help to improve the map.


The text next to the ? icon will change when you have the Problems layer enabled and there is a Map Problem visible. When there is no visible map problem, it reads, ''If you can't see any, try zooming out. If you still don't see any you probably need to drive some more in order to expand your editing permissions range.''
This list is of the various defined areas of which can perform edits.


Once you get within range of a Map Problem, it looks like it does in the picture to the left. You can click on the ''Click Here'' text and it will select and zoom in to one of the problems. As you solve problems, you can get to the next nearest one in the area by clicking the link again.


==Tabs when segment(s) are selected==
[[Image:Wme3 segments selected edit.png|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.
<br style="clear: both" />
<br style="clear: both" />


==User's Guide==
[[Image:Users_guide_button.png]]


The User's Guide button will open up a lightboxed panel featuring seven videos from Waze. The videos are titled as follows:
====House Numbers Tab====
# Introduction
[[Image:Wme3 house numbers.png|right]] When a single segment is selected, the '''House Numbers''' tab will display and allow you to modify the address range of the selected segment. The ranges are input for both left and right side of the street. When determining which side is left and right, pay close attention to the beginning and end of the segment, which is denoted with the letter "A" for the beginning and "B" for the end. The address range must be set to ''increase'' from A to B. More details can be found in the [[House Numbers in the Editor]] page.
# Before You Start
<br style="clear: both" />
# 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.
[[Image:Wme3 single segment selected.png|left]]When you are adjusting house numbers, you must be clear in the orientation of the segment on the screen as it relates to the view in the House Numbers tab. The (A) and (B) indicators and left and right side of the street must be correctly entered. This can be difficult if the street orientation is backward from the House Number tab display. Be very careful when doing this data entry.
<br style="clear: both" />




=Properties Toolbox=
===Tabs when a Camera is selected===
[[Image:Properties_drawer_tab.png|left]]  
[[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.
<br style="clear: both" />


The properties toolbox is initially shown as a tab which expands to the left when clicked. When there is no object selected on the map, the drawer looks empty. When an object is selected, the contents of the Properties drawer change to reflect the available properties, both editable and non-editable, of that object. Therefore, the look of the drawer when a Landmark is selected is quite different from that of a street segment.


[[Image:Junction_properties_example.png|top]] [[Image:Segment_properties_example.png|top]]
===Tabs when a landmark is selected===
[[Image:wme3 landmark tab.png|right]]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 also a checkbox to lock the landmark to prevent changes by lower ranking editors.
<br style="clear: both" />




=Map Display Area=
==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.
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.
Line 150: Line 164:
<br style="clear: both" />
<br style="clear: both" />


[[Image:wme_control_elements_highlighted.png|700px]]
[[Image:wme31 control elements highlighted.jpg|700px]]




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


Just below the main toolbar, there is a dark gray area which runs the width of the map display area.  
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 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.
* The right side displays whether the editor is still loading any layers, such as road images or GPS points.
* The far right side displays the current count of unsaved changes.
** For zero to nine unsaved changes, this is shown with a black background: [[Image:9 unsaved changes.png]]
** For ten change sor greater, the text background changes to red, as a warning that many unsaved changes may be difficult to save if there is a single error amongst the changes. [[Image:10 unsaved changes.png]]




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


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.
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, the shortcut is '''Shift+<first letter of layer name>'''.


[[Image:Layers_expanded.png]]
The four small dots to the left of a layer selector box is a drag handle which allow you to rearrange layers for which that feature is enabled.
 
[[Image:Wme3 layers expanded.png]]


Each of the layers is discussed in more detail later, but a short desription of each is directly below.
Each of the layers is discussed in more detail later, but a short desription of each is directly below.


===Bing Aerials===
====Bing Aerials====
[[Image:Aerial_skinny.png|260px]] Shortcut key: '''Shift+b'''
[[Image:Aerial_skinny.png|260px]] Shortcut key: '''Shift+b'''


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


===Cities===
====Cities====
[[Image:cities_skinny.png|260px]] Shortcut key: '''Shift+c'''
[[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.
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.


===Roads===
====Roads====
[[Image:Road_segments_skinny.png|260px]] Shortcut key: '''Shift+r'''
[[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 level, some street types are not displayed so that the map is not too cluttered.
Roads are all of the streets, alleys, highways, and freeways which make up the driveable street system in Waze. Depending on the zoom level, some street types are not displayed so that the map is not too cluttered.


===GPS points===
====GPS points====
[[Image:Gps_tracks_straight_skinny.png|260px]] Shortcut key: '''Shift+g'''
[[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.
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.


===Landmarks===
====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.
 
====Landmarks====
[[Image:Landmarks_skinny.png|260px]] Shortcut key: '''Shift+l'''
[[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.
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.


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


Line 206: Line 224:
* For more information, please see the [[Cameras]] page.
* For more information, please see the [[Cameras]] page.


====Speed Cameras====
====Problems====
These cameras are permanently mounted systems, triggered by vehicles traveling beyond the posted speed limit. When triggered, it takes a photo of your car, license plate, driver and you receive a citation in the postal mail. Speed cameras in Waze are uni-directional.
 
====Red Light Camera====
These cameras are permanently mounted systems at intersections. They are triggered when a vehicle is illegally in the intersection when the traffic control light is red for their direction of travel. Different countries and US states operate them differently in terms of when they are set to be triggered. Red light cameras in Waze are uni-directional, so for a fully-covered 4-way intersection, four red light cameras are required to notify drivers in all directions.
 
====Dummy Cameras====
Some locations will have what looks to be a speed camera set up, when in fact it is a fake camera housing only meant to deter drivers from exceeding the speed limit.
 
===Problems===
[[Image:Problem_pin_open.png|left]] Shortcut key: '''Shift+p'''
[[Image:Problem_pin_open.png|left]] Shortcut key: '''Shift+p'''
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.
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.
Line 222: Line 231:




===Update Requests===  
====Update Requests====  
[[Image:Request_pin_open.png|left]] Shortcut key: '''Shift+u'''
[[Image:Request_pin_open.png|left]] Shortcut key: '''Shift+u'''
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.
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.
Line 229: Line 238:




===Editable areas===
====Editable areas====
[[Image:Editable_area_skinny.png|260px]] Shortcut key: '''Shift+e'''
[[Image:Editable_area_skinny.png|260px]] Shortcut key: '''Shift+e'''


Line 235: Line 244:




===Other users===
[[Image:Wazer-with-premission.png]] Shortcut key: '''Shift+o'''
When there are other Waze map editors in your area, they will appear on the map with this "construction Wazer" icon. Their zoom level will be shown with a darkened circle. When they are actively changing, editing or saving map objects, the darkened zoom circle will change to red. As they move around the map and zoom in and out, you will see their icon jumping from location to location and the diameter of their zoom indicator will change in near-real-time. This layer is a first step in promoting better communication between Waze map editors. There is no current communication functionality available.
* For more information, please see the [[Other Users in Waze Map Editor]] page.


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


Line 248: Line 251:
<br style="clear: both" />
<br style="clear: both" />


==Scale==
===Scale===
[[Image:scale_display.png]]
[[Image:scale_display.png]]


Line 254: Line 257:
<br style="clear: both" />
<br style="clear: both" />


==Lat/Lon==
===Lat/Lon===
[[Image:lat-lon_display.png]]
[[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.
In the lower-right corner is a control showing the latitude and longitude of the mouse pointer as it moves over the map.


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


Outside of the lower right corner of the map display area is the underlined word ''permalink.'' The permalink changes any time the map moves or objects are selected and deselected. It is a link to the exact view you are currently seeing in the map display area. You can click it to refresh the map area, or you can right-click and copy the address of the permalink to share via email or in the Waze forums.
Directly to the left of the Lat/Lon Display is a box with the word "Permalink." This button is a link to the current view of the editor, including any segments or other objects currently selected. The permalink changes any time the map moves or objects are selected and deselected. It is a link to the exact view you are currently seeing in the map display area. You can click it to refresh the map area, or you can right-click and copy the address of the permalink to share via email or in the Waze forums.




=Navigating the Map Editor=
==Moving Around the Map==
* Move around the map by clicking and dragging on the map itself
* Move around the map by clicking and dragging on the map itself
* Keyboard arrow keys will pan the map
* 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 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.
# 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.
Line 274: Line 277:
# 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
# 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:
# 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:Shift_zoom.png|500px|center]]
[[Image:wme31 shift_zoom.jpg|500px|center]]




[[Map Editing (new Editor)#Editing Manual |Back to Map Editing]]
[[Waze Map Editor#Editing Manual |Back to Map Editing]]

Revision as of 15:43, 5 November 2012

Map Editor Layout

There are three main areas of the Map Editor:

  1. Toolbar
  2. Tabs Area
  3. Map Display Area

  • 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)
    1. 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
    1. 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).
    2. House Numbers allows updating a single segment's house number range. If more than one segment is selected, the House Numbers tab doesn't appear.
  • 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 section.


Map Editor Tool Bar

Search box

In the wide search box, you can enter an address, city, state, country, landmark or 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 to select from.

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

However, searching for "main st, new york" will get you a list of matches to select from.


Add Button

Shortcut keys: i, o, g, p or u

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.

From this menu, you can add a Road, a Roundabout, Gas Station, Parking Lot or a Landmark. Details for each of these actions are found in the Editing Manual.

Save Button

Shortcut key: Ctrl+s

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 icon changes to red as a warning that many unsaved changes may be difficult to save if there is a single error amongst 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 if there were 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 also 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

Shortcut key: Ctrl+Z

The Undo button will undo unsaved successive previous changes with each click. 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.

Redo Button

Shortcut key: Ctrl+Shift+Z

The Redo button will re-apply any changes which have been recently undone with the Undo button

Delete Button

Shortcut key: Delete (Del)

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.


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

When no objects are selected on the map, the Tabs Area displays user information. Map Problems and Update Requests are not considered map objects, so the tabs below will display when a Map Problem or Update Request is selected.

The top section greets you by name and is always visible regardless of what is showing or displayed on the map.


Me Tab

The Me tab displays your permissions level and current points for the server you are editing on (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 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 lightboxed panel featuring seven videos from Waze. The videos are titled as follows:

  1. Introduction
  2. Before You Start
  3. Getting Started
  4. Basic Terms
  5. Basic Editing
  6. Map Problems
  7. 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

Drives allows 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. 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.


Tabs when segment(s) are selected

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.


House Numbers Tab

When a single segment is selected, the House Numbers tab will display and allow you to modify the address range of the selected segment. The ranges are input for both left and right side of the street. When determining which side is left and right, pay close attention to the beginning and end of the segment, which is denoted with the letter "A" for the beginning and "B" for the end. The address range must be set to increase from A to B. More details can be found in the House Numbers in the Editor page.


When you are adjusting house numbers, you must be clear in the orientation of the segment on the screen as it relates to the view in the House Numbers tab. The (A) and (B) indicators and left and right side of the street must be correctly entered. This can be difficult if the street orientation is backward from the House Number tab display. Be very careful when doing this data entry.



Tabs when a Camera is selected

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.



Tabs when a landmark is selected

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 also a checkbox to lock the landmark to prevent changes by lower ranking editors.



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:

  1. Info Bar
  2. Layers
  3. Zoom Control
  4. Scale
  5. Lat/Lon
  6. Permalink



Info bar

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.


Layers

On the right-side of the main window, you will see this small icon:

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, the shortcut is Shift+<first letter of layer name>.

The four small dots to the left of a layer selector box is a drag handle which allow you to rearrange layers for which that feature is enabled.

Each of the layers is discussed in more detail later, but a short desription of each is directly below.

Bing Aerials

Shortcut key: Shift+b

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

Cities

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.

Roads

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 level, some street types are not displayed so that the map is not too cluttered.

GPS points

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.

Area Managers

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.

Landmarks

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.

(Speed) Cameras

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.

  • For more information, please see the Cameras page.

Problems

Shortcut key: Shift+p

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.


Update Requests

Shortcut key: Shift+u

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.


Editable areas

Shortcut key: Shift+e

Where you can edit is determined primarily by where you have driven. Edit rights are 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.


Zoom Control

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.

Scale

In the lower left corner is a small graphic showing the current scale of the map display area.

Lat/Lon

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

Permalink

Directly to the left of the Lat/Lon Display is a box with the word "Permalink." This button is a link to the current view of the editor, including any segments or other objects currently selected. The permalink changes any time the map moves or objects are selected and deselected. It is a link to the exact view you are currently seeing in the map display area. You can click it to refresh the map area, or you can right-click and copy the address of the permalink to share via email or in the Waze forums.


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:
  1. 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.
  2. Double-clicking any point on the map will zoom in one level and center the map on that point.
  3. 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
  4. 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:


Back to Map Editing