Map Editing Tips and Hints: Difference between revisions Discussion View history

m (added the word Bookmarket to helper scripts)
 
(74 intermediate revisions by 15 users not shown)
Line 1: Line 1:
[[Map Editing (new Editor)|Back to Map Editing]]
{{ReturnTo | Editing manual | the editing manual}}


These map editing tips and hints have been compiled to help new map editors learn some of the many helpful instructions, procedures, settings, etc., that improve the map editing experience.


==Login Position==
== {{anchor|Login Position|Login position|Reload map}}Map editor startup position ==
To start Papyrus at a particular position, (your home),
# Adjust the map display area the way you want it to start up in each time
# Click on the permalink link in the bottom right corner
# 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.
To start [[Waze Map Editor]] at a particular position, like your home, every time you log into the editor,
* You can still create a bookmark from the Permalink and use that bookmark to open the editor
# Adjust the map display area (position and [[Map_Editor_Interface_and_Controls#Zoom_Control|zoom]]) the way you want it to start up in your browser each time.
* Sometimes, it is advantageous to allow the editor to open in the previous location, in case you have edits to complete from a previous editing session
# Click on the [[Waze_Map_Editor#Permalink|permalink]] icon [[File:1LiveMap-permalink.png]] on the right edge of the screen and the URL for that location will appear in a window for your use.
# Click the copy icon next to the Permalink URL entry to save it to your clipboard.
# Bookmark this URL, and you'll always be at your selected "home location" when you start the editor using that bookmark.


==Editing with roads layer off==
* The editor automatically displays the last location you were editing.
You can edit roads and nodes without the road layer actually showing on the screen. Turn off the Roads overlay layer while leaving the Bing Aerial layer on. As the pointer hovers over the road or node element, you can then select it and make any necessary changes. This is useful for aligning to aerial images.
* You can also 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 complete from a previous editing session.
* This can also be used to reload your map editor screen in case the map data appears out of sync with your browser and you are getting repeated errors trying to save changes. Just copy the URL into the browser URL field and reload the page. Any unsaved edits will be lost, but you can reedit the screen with the fresh data after it reloads.


==Deleting geometry nodes quickly==
== Editing with roads layer off ==
The '''d''' key may be held down while moving the cursor along a segment to delete nodes quickly as soon as the cursor reaches it. This will save you having to hit d dozens of times for very messy geometries.
You can edit roads and nodes without the road layer actually showing on the screen. Turn off the [[Map_Editing_Quick-start_Guide#Roads|Road overlay layer]] while leaving the [[Map_Editor_Interface_and_Controls#Satellite Imagery|Satellite Imagery layer]] on. As the mouse pointer hovers over the road or node element, you can then select it and make any necessary changes. 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 more than one segment.
== Deleting geometry nodes quickly ==
The "'''d'''" key may be held down while moving the cursor along a segment to delete [[Creating and editing road segments#Adjusting_road_geometry_.28nodes.29|geometry nodes]] quickly as soon as the cursor reaches it. This will save you having to hit "'''d'''" dozens of times for very messy geometries.


==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==
== Streets with no name or city ==
In areas with [[Map_Editing_%28new_Editor%29#The_Road_Maps |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.
* To create or edit segments without a city and/or street name, you must check the "No name" box for these fields.


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.
* Newly drawn streets can be saved without entering a city or street name, but they will show in [[Creating and editing road segments#Confirm_the_road_by_updating_details|red]] on the map.


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==
== {{anchor|Streets looping onto itself}}Street looping onto itself ==
The [[Editing ranks]] page has more detailed information than the summaries below.
{| class="Wikitable floatright"
| [[File:Jct_loop_bulb.png|border|x100px]]
| [[File:Loop 3-part 6.jpg|border|x100px]]
|}
''See [[Junction_Style_Guide#Loops|Loops]] for more information.''


===Permissions===
When drawing a new road, it cannot [[Junction_Style_Guide#Loops|loop back onto itself]] and create a junction. You must have at least three segments in the loop to prevent routing problems.
The permissions scheme in the Papyrus editor allows users to gain editing ranks, using ranks from 0 to 5. This scheme is based on the user's experience in terms of edit count as well as the ''importance'' of each road.
{{clear}}


===Locking Segments===
== Adjusting geometry of multiple selected 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.
{| class="Wikitable floatleft"
| [[File:Multi-select-GeoPointsEdit.png|border|135px]]
|}
When [[Map_Editing_Quick-start_Guide#Selecting_Multiple_Segments|multi-selecting]] streets (such as setting a group of neighborhood streets to two-way), you can still individually adjust the geometry of any single segment in the selection as you hover over it. This will not lose the selection set.
{{clear}}


==Moving segments beyond the limit==
== Editing a junction sets the turn restrictions ==
When the error checker is working, and you move the end of a segment a significant distance from its original ending or beginning location, such as when a section of road is missing and you are stretching a segment across the gap, you may get an error reading, "Could not save changes: Some elements were moved beyond the allowed limit."
In areas with [[Waze Map Editor#The_Road_Maps |base maps]], there is a distinction between [[Junction_Style_Guide|junctions]] created or updated by the editors and junctions that have never been touched and were created during the original base map upload process.


Here are some workarounds:
These junctions appear as if at the [[Map_Editing_Quick-start_Guide#Turn_restrictions_.28allowed_turns.29|turns are forbidden]], but the routing server will act as if the turns are allowed. The [[Routing_server|routing algorithm]] will prefer routing using segments and junction whose turns are explicitly set by the users, but in cases where there is no alternate route, or it is much longer, it will route through intersections where there are no explicitly allowed turns.
* Adjust the end a shorter distance and save, then repeat until the full gap is crossed.
* [[Map_Editing_Quick-start_Guide#Splitting_a_segment|Split the segment]] into two or perhaps more smaller segments.
* Draw a new road, which you can stretch as much as you like before saving (often requires draw, pan map, stretch, pan map, etc.)


==Speed cams==
Setting a road to 2-directional will not change the status of its junction turn restrictions. However, once the junction's turn restrictions are edited, they are assumed to be strictly valid, just like junctions in areas without base maps.
* 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.


==Map Editor Bookmarklet Scripts==
== Editing ranks and the locking feature ==
During the time of transition from the Cartouche map editor and the new editor (Papyrus), 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. In addition, there is a script to open the LiveMap with the current Papyrus view.
''See [[Editing rank]] for more detailed information.''


To facilitate switching back and forth with the same view, here are several code snippets you can use for a bookmarklet in any modern browser. Even easier is a drag-n-drop solution on [http://dl.dropbox.com/u/1437031/waze_bookmarklets.html this dropbox page] (AlanOfTheBerg's dropbox).
=== Permissions ===
The permissions scheme in the Waze Map Editor allows users to gain [[editing rank]], using ranks from 1 to 6. This scheme is based on the user's experience in terms of edit count as well as the ''importance'' of each road.


===Open Cartouche in Papyrus===
=== Locking Segments ===
<span style="font-family:Courier;font-size:small;"><nowiki>javascript:(function(){var center_lonlat=new OpenLayers.LonLat(g_cartouche.map.center.lon,g_cartouche.map.center.lat);center_lonlat.transform(new OpenLayers.Projection("EPSG:900913"),new OpenLayers.Projection("EPSG:4326"));window.open('http://'+window.location.hostname+'/cartouche/?zoom='+(g_cartouche.map.zoom)+'&lon='+center_lonlat.lon+'&lat='+center_lonlat.lat,'Papyrus');})();</nowiki></span>
When you [[Map_Editor_Interface_and_Controls#General_Tab|lock a segment]], only a user with the same rank or higher can change this segment. Currently this covers all edits including, but not limited to:
* Connecting or disconnecting a different, unlocked segment
* Deleting a segment connected to the locked segment
* Changing the [[Map_Editing_Quick-start_Guide#Turn_restrictions_.28allowed_turns.29|turn restrictions]] of the locked segment


===Open Papyrus in Cartouche===
== Moving segments beyond the limit ==
<span style="font-family:Courier;font-size:small;"><nowiki>javascript:(function(){var center_lonlat=new OpenLayers.LonLat(wazeMap.center.lon,wazeMap.center.lat);center_lonlat.transform(new OpenLayers.Projection("EPSG:900913"),new OpenLayers.Projection("EPSG:4326"));window.open('http://'+window.location.hostname+'/cartouche_old/?zoom='+(wazeMap.zoom)+'&lon='+center_lonlat.lon+'&lat='+center_lonlat.lat,'oldCartouche');})();</nowiki></span>
When the end of a segment is moved a significant distance from its original ending or beginning location, such as when a section of road is missing and it is stretched across a gap, an [[WME_errors|error message]] may be returned saying:


===Open Papyrus in LiveMap===
:<code>Could not save changes: Some elements were moved beyond the allowed limit.</code>
<span style="font-family:Courier;font-size:small;"><nowiki>javascript:(function(){var center_lonlat=new OpenLayers.LonLat(wazeMap.center.lon,wazeMap.center.lat);center_lonlat.transform(new OpenLayers.Projection("EPSG:900913"),new OpenLayers.Projection("EPSG:4326"));var mapZoom=(window.location.hostname=='world.waze.com' ? (wazeMap.zoom<5 ? (wazeMap.zoom<2 ? wazeMap.zoom+6 : wazeMap.zoom+5) : 9) : (wazeMap.zoom>10 ? wazeMap.zoom-11 : 0));window.open('http://'+window.location.hostname+'/livemap/?zoom='+mapZoom+'&lon='+center_lonlat.lon+'&lat='+center_lonlat.lat,'LiveMap');})();</nowiki></span>
 
===Open LiveMap in Papyrus===
<span style="font-family:Courier;font-size:small;"><nowiki>javascript:(function(){var center_lonlat=OpenLayers.Layer.SphericalMercator.inverseMercator(g_map.getCenter().lon,g_map.getCenter().lat);var mapZoom=(window.location.hostname=='world.waze.com' ? (g_map.zoom>6 ? (g_map.zoom>7 ? g_map.zoom-5 : g_map.zoom-6) : 0) : (g_map.zoom>10 ? g_map.zoom-11 : 0));window.open('http://'+window.location.hostname+'/cartouche/?zoom='+mapZoom+'&lon='+center_lonlat.lon+'&lat='+center_lonlat.lat,'Papyrus');})();</nowiki></span>


Here are some workarounds:
* Adjust the end a shorter distance and save, then stretch the segment further, repeating this process until the full gap is crossed.
* [[Map_Editing_Quick-start_Guide#Splitting_a_segment|Split the segment]] into two or perhaps more smaller segments.
* [[Creating and editing road segments#Creating_a_new_road|Draw a new road]], which can initially be drawn or stretched as much as desired before saving.


===Expand size of Archive (Routes) Window===
This script which can be made into a bookmarklet, will expand the size of the Archive window to account for the recently changed filename length which pushes some window elements to the right causing them to be unavailable.


Change the 950px to a number of your choice if 950 isn't wide enough.
== Move segment end node and not segment end ==
When adjusting the end location of a segment, like a dead end, there are two methods for moving the end of the segment that each result in a different outcome.
{| class="Wikitable floatleft"
| [[File:End-junction 1.JPG|border|150px]]
|}
1. The preferred method is not to select the segment itself, but just the end node. When only the end node is selected, there is no '''A''' or '''B''' segment end identifier. The ID of the node is preserved during repositioning, as well as any turn delay data stored for the U-turn. This method makes it easier to adjust geometry accurately, just like adjusting a junction node that connects two or more segments.
{{clear}}


<span style="font-family:Courier;font-size:small;"><nowiki>javascript:(function()(document.getElementById('archivePanel').style.width='950px';})();</nowiki></span>
{| class="Wikitable floatright"
| [[File:End-junction-2small.png|border|120px]]
| [[File:New-end-junction-small.png|border|120px]]
|}
2. The less desirable method is to first select the segment and force the '''A''' and '''B''' identifiers to appear. Then when the free end letter is grabbed and moved a certain distance, it snaps away and a new end node is created. This is technically a disconnection, but since U-turns are always allowed at dead ends, only the turn delay data is lost, if it exists. The snapping also causes more difficulty in adjusting geometry.


{{clear}}


===Expand size of Update Requests Window===
== {{anchor|Speed cams}}Cameras - speed and red light ==
This script which can be made into a bookmarklet, will expand the size of the Update Requests panel to account for long usernames which can push some window elements to the right causing them to be unavailable.
Be sure to review the larger article on [[Cameras]] before continuing with this section to ensure a full understanding of how cameras work in Waze.


Change the 500px to a number of your choice if 500 isn't wide enough.
{{:Map Editing Tips and Hints/Cameras}}


<span style="font-family:Courier;font-size:small;"><nowiki>javascript:(function(){document.getElementById('updateRequestPanel').style.width='500px';})();</nowiki></span>
== Map Editor Bookmarklet Scripts ==
Several very useful [http://en.wikipedia.org/wiki/Bookmarklet bookmarklet] scripts have been developed to enhance the map editing process. A complete list of available scripts are on the [[Bookmarklets]] Wiki page along with instructions on how to add them to your browser.


==Papyrus Extended Tools Script==
==Plugins, Extensions and Tools==
Please see the [[Community Plugins, Extensions and Tools]] for details on the Papyrus extension/addon to allow easy correction of smudged cities, misspellings, etc.
Please see the [[Community Plugins, Extensions and Tools]] for details on the Waze Map Editor extension/addon to allow easy correction of smudged cities, misspellings, etc.




[[Map Editing (new Editor)|Back to Map Editing]]
{{ReturnTo | Editing manual | the editing manual}}

Latest revision as of 16:28, 5 September 2022

These map editing tips and hints have been compiled to help new map editors learn some of the many helpful instructions, procedures, settings, etc., that improve the map editing experience.

Map editor startup position

To start Waze Map Editor at a particular position, like your home, every time you log into the editor,

  1. Adjust the map display area (position and zoom) the way you want it to start up in your browser each time.
  2. Click on the permalink icon on the right edge of the screen and the URL for that location will appear in a window for your use.
  3. Click the copy icon next to the Permalink URL entry to save it to your clipboard.
  4. Bookmark this URL, and you'll always be at your selected "home location" when you start the editor using that bookmark.
  • The editor automatically displays the last location you were editing.
  • You can also 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 complete from a previous editing session.
  • This can also be used to reload your map editor screen in case the map data appears out of sync with your browser and you are getting repeated errors trying to save changes. Just copy the URL into the browser URL field and reload the page. Any unsaved edits will be lost, but you can reedit the screen with the fresh data after it reloads.

Editing with roads layer off

You can edit roads and nodes without the road layer actually showing on the screen. Turn off the Road overlay layer while leaving the Satellite Imagery layer on. As the mouse pointer hovers over the road or node element, you can then select it and make any necessary changes. This is useful for aligning to aerial images.


Deleting geometry nodes quickly

The "d" key may be held down while moving the cursor along a segment to delete geometry nodes quickly as soon as the cursor reaches it. This will save you having to hit "d" dozens of times for very messy geometries.


Streets with no name or city

  • To create or edit segments without a city and/or street name, you must 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.


Street looping onto itself

See Loops for more information.

When drawing a new road, it cannot loop back onto itself and create a junction. You must have at least three segments in the loop to prevent routing problems.

Adjusting geometry of multiple selected segments

When multi-selecting streets (such as setting a group of neighborhood streets to two-way), you can still individually adjust the geometry of any single segment in the selection as you hover over it. This will not lose the selection set.

Editing a junction sets the turn restrictions

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 original base map upload process.

These junctions appear as if at the turns are forbidden, but the routing server will act 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 cases where there is no alternate route, or it is much longer, it will route through intersections where there are no explicitly allowed turns.

Setting a road to 2-directional will not change the status of its junction turn restrictions. However, once the junction's turn restrictions are edited, they are assumed to be strictly valid, just like junctions in areas without base maps.


Editing ranks and the locking feature

See Editing rank for more detailed information.

Permissions

The permissions scheme in the Waze Map Editor allows users to gain editing rank, using ranks from 1 to 6. This scheme is based on the user's experience in terms of edit count 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. Currently this covers all edits including, but not limited to:

  • Connecting or disconnecting a different, unlocked segment
  • Deleting a segment connected to the locked segment
  • Changing the turn restrictions of the locked segment

Moving segments beyond the limit

When the end of a segment is moved a significant distance from its original ending or beginning location, such as when a section of road is missing and it is stretched across a gap, an error message may be returned saying:

Could not save changes: Some elements were moved beyond the allowed limit.

Here are some workarounds:

  • Adjust the end a shorter distance and save, then stretch the segment further, repeating this process until the full gap is crossed.
  • Split the segment into two or perhaps more smaller segments.
  • Draw a new road, which can initially be drawn or stretched as much as desired before saving.


Move segment end node and not segment end

When adjusting the end location of a segment, like a dead end, there are two methods for moving the end of the segment that each result in a different outcome.

1. The preferred method is not to select the segment itself, but just the end node. When only the end node is selected, there is no A or B segment end identifier. The ID of the node is preserved during repositioning, as well as any turn delay data stored for the U-turn. This method makes it easier to adjust geometry accurately, just like adjusting a junction node that connects two or more segments.

2. The less desirable method is to first select the segment and force the A and B identifiers to appear. Then when the free end letter is grabbed and moved a certain distance, it snaps away and a new end node is created. This is technically a disconnection, but since U-turns are always allowed at dead ends, only the turn delay data is lost, if it exists. The snapping also causes more difficulty in adjusting geometry.

Cameras - speed and red light

Be sure to review the larger article on Cameras before continuing with this section to ensure a full understanding of how cameras work in Waze.


  • 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 client app 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 app warns about a red light camera if it is valid and points in the same direction as the road segment.
  • The "30" on the speed cam icon is just part of the image and is not an indication of the actual speed to which the speed camera is set.
  • 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.


Map Editor Bookmarklet Scripts

Several very useful bookmarklet scripts have been developed to enhance the map editing process. A complete list of available scripts are on the Bookmarklets Wiki page along with instructions on how to add them to your browser.

Plugins, Extensions and Tools

Please see the Community Plugins, Extensions and Tools for details on the Waze Map Editor extension/addon to allow easy correction of smudged cities, misspellings, etc.