Difference between revisions of "Modèle:Documentation subpage"

From Wazeopedia
(Address Properties)
(208 intermediate revisions by 27 users not shown)
Line 1: Line 1:
[[Map Editing (new Editor)#Editing_Manual|Back to Editing Manual]]
-->{{#ifeq:{{lc:{{#titleparts: {{PAGENAME}} | | -1 }}}} |{{{override|doc}}}
    | <!--(this template has been transcluded on a /doc or /{{{override}}} page)-->
=Creating a new road=
      -->{{#ifeq:{{{doc-notice|show}}} |show
You have a location where there should be a road where there isn't one in Waze, such as a recent suburban development. The following series of screenshots and instructions walk you through the process of adding a road to Waze from scratch. The screenshots are from an area of Little Rock, Arkansas, US and we are working on adding the roads missing in the highlighted area shown here:
          | {{Mbox
            | type = notice
            | style = margin-bottom:1.0em;
            | image = [[File:Edit-copy green.png|40px|alt=|link=]]
            | text =
'''This is a [[Wikipedia:Template documentation|documentation]] [[Wikipedia:Subpages|subpage]] for {{purge|{{{1|[[:{{SUBJECTSPACE}}:{{#titleparts: {{PAGENAME}} | -1 }}]]}}}}}'''.<br />It contains usage information, [[Wikipedia:Categorization|categories]] and other content that is not part of the original {{#if:{{{text2|}}} |{{{text2}}} |{{#if:{{{text1|}}} |{{{text1}}} |{{#ifeq:{{SUBJECTSPACE}} |{{ns:User}} |{{lc:{{SUBJECTSPACE}}}} template page |{{#if:{{SUBJECTSPACE}} |{{lc:{{SUBJECTSPACE}}}} page|article}}}}}}}}.
      -->{{#if:{{{inhibit|}}} |<!--(don't categorize)-->
          |  <includeonly><!--
              -->{{#ifexist:{{NAMESPACE}}:{{#titleparts: {{PAGENAME}} | -1 }}
                  | [[Category:{{#switch:{{SUBJECTSPACE}} |Template=Template |Module=Module |User=User |#default=Wikipedia}} documentation pages]]
                  | [[Category:Documentation subpages without corresponding pages]]
Set up the map display such that you can see a good portion of the area you need to add the road to, setting the zoom level appropriately such that you will be able to follow the curves in the road as you draw it.
(completing initial #ifeq: at start of template:)
There are four steps essential to add roads to the Waze map:
    | <!--(this template has not been transcluded on a /doc or /{{{override}}} page)-->
# Draw the road, including junctions to existing segments
# Confirm the road properties
# Set allowed turns
# Save the changes
==Drawing the road==
[[Image:Select_road.png|left]] ''Hover'' the cursor over the large + icon at the right side of the [[Map_Editor_Interface_and_Controls#The_Tool_Bar|toolbar]] and ''click'' '''Road'''. You can also use the keyboard shortcut which is the letter '''i''', for Insert. Move the cursor to the location you want to start drawing the road. This can be an empty location, or can on an existing segment where the intersection with this new road will be. The cursor has a small blue circle to indicate it is in drawing mode.
When you hover over an existing segment, it will highlight showing that if you click right there, a junction will be automatically added for you where you start drawing.
Move your mouse along the path of the road, and as you follow along the aerial or GPS points for the new road, every time you ''click'', a '''geometry node''' is added, keeping your new road aligned with your cursor movement. When you reach the end location for the new road, ''double-click'' the mouse. You will exit drawing mode, and the new road will display in orange to signify that it is unsaved.
In the situation being describe here, there is another road in this same view which is missing. We can add another road to the map without having saved the first one, which is a great timesaver. The next screenshot shows the second road already added and auto-junctioned to the first segment we added.
At this point, you can save the newly added roads if you wish. However, the process of properly adding the roads is not complete. These roads are currently still set as 1-way, with no associated city and no street name. Adding those details to the road is required before they will show up in the client, and is discussed below in the Updating details to confirm roads section below.
<br clear="all" />
==Add an end-node on cul-de-sac's==
(this section needs work and photos)
In order for the Waze Application to route properly from a location on a cul-de-sac, an end-node or dead-end-node needs to be added at the end of each cul-de-sac road.  Without this end-node Waze will give the instruction 'Proceed to Hilighted Route'.  Basically an end-node is a junction at the end of the cul-de-sac.
Too add a end-node, draw a temporary street and junction this temporary street at the end of the cul-de-sac.  After the end-node is created, you can then delete the temporary road.
The result is an end-node which appears in the map editor as a blue, square dot.
==Confirm the road by updating details==
New roads will not be displayed on the Waze app until they are confirmed, meaning an editor confirms the correct city and street name at a minimum. In the map editor, unconfirmed roads are displayed in Red. Unconfirmed roads can both be roads drawn in the editor as well as roads recorded or paved from the app. To confirm a road, you must at least set the country, state (for the US), city and street name.
First, select the segment(s) you need to confirm. Notice in the case below, we can see these are two 1-way segments. Once selected, if the [[Map_Editor_Interface_and_Controls#Properties_Drawer|properties drawer]] has not slid out to the left, click the tab to open it. Notice below that for the one road, there are now two segments. That is because the second road we added has split the original road into two segments. This is normal and expected. You can choose to confirm the first road before added the second road if you wish.
[[Image:windrush_pt_properties.png|right]] To edit the address details, ''click'' the '''Edit Address''' link. This will enable editing of fields above it. When multiple segments are selected, you need to select Country (and State for locations which support it) as well as entering in city and street name information. If this is a location outside a city, use the "No Name" check box. Same for the street name. If this is a private drive or a parking lot road or other road which doesn't have a name, use the "No Name" check box.
When complete, ''click'' the '''Apply''' button, then set the correct Road Type, Direction and Level. For neighborhood streets in these examples, Street is appropriate, they are 2-way streets and they have no roads above or below them, so Level 0 is correct.
* Please be aware the the directionality type 'No Entrance' does not prevent Waze from routing onto a road.  'No Entrance' really means 'Undefined'.  When the direction is set to 'No Entrance' Waze will automatically adjust the directionality of the road as Wazers drive it.  This is the initial directionality of all roads after a base map import.  In addition, the locked checkbox does not prevent the directionalty from changing on 'No Entrance' roads as Wazers drive it.
<br clear="all" />
Again, you can choose to save now, but there is one last step which needs to be completed before we can call this process complete: setting the allowed turns
==Set allowed turns (connections)==
[[Image:new_road_turns_not_allowed.png|left]] We've added our roads and confirmed them, but we haven't set which roads can be legally driven from and to. In the real world, sometimes two 2-way segments are connected, but direction of travel is restricted in a certain way, due to such things as a median barrier being across the road. However, in our suburban neighborhood example, these streets can all be driven to and from, but our screenshot to the left shows red arrows, meaning that Waze won't navigate that direction from the selected segment.
<br clear="all" />
In situations where not all turns are allowed, you would click on each arrow to allow that turn, or travel direction. But if all turns are allowed, then the faster way is to enable all turns at the junction.
[[Image:select_junction.png|right]] ''Select'' the '''junction''' and it will turn from an orange to red with a white border.
<br clear="all" />
[[Image:Junction_properties_example.png|left]] Look to the Properties drawer and you will see action links for this junction. Depending on the current state of the junction, both or either '''Allow all connections''' or '''Disallow all connections''' links will appear. (If all connections are currently allowed, then that link will not appear.)
<br clear="all" />
To enable all turns at our intersections, ''click'' the '''Allow all connections''' link for both of the junctions created.
<br clear="all" />
Up to this point, you may have saved your progress or not. If not, ''click'' the '''Save''' button now (or use the '''Ctrl+s''' keyboard shortcut) and all of your updates will be sent to the Waze servers for processing. After the save is complete, and if there are no errors, you will be presented with the final product of this process:
=Editing existing roads=
Editing an existing road or segment is not very different than creating a new road. Once a road is drawn from scratch, before it is saved, all of the editing functions described here work just the same.
==Adjusting geometry==
Adjusting geometry is changing the shape or the way a road segment looks. You need to do this for roads after they are realigned in real life, or perhaps a whole area is in the wrong place because the basemap import has the roads in the wrong place.
The instructions here, while written initially for editing an existing road segment, also apply to a new road segment you just created but have not yet saved. The editor treats them the same.
[[Image:Adjust_geometry_1.png|320px|right]] To start adjusting the geometry of a segment, ''click'' on it. As it is highlighted, when you hover over the segment, geometry nodes and internodes will display on the segment. Both of these are draggable so that you can reposition them wherever you need. When you drag an internode from its default position 1/2 was between two nodes, it will turn into a node.
<br clear="all" />
[[Image:Adjust_geometry_2.png|320px|right]] To delete a node, which you would want to do to straighten out a section of the segment, ''hover'' the cursor over a node and hit the '''d''' key on the keyboard. This only works with nodes, not internodes. When you have a long straight stretch of road, and you see there are nodes located along it, it makes sense to delete these as it makes the road segment more simple and easier to display on the Waze client app.
<br clear="all" />
[[Image:Adjust_geometry_3.png|320px|right]] When complete, the segment is now a different geometry than it was to start with.
<br clear="all" />
Don't forget to save!
To see these operations more easily, you can [http://youtu.be/Pm8zEmlD5bo?hd=1 watch a video of adjusting segment geometry].
===Moving junctions===
===Allow/Disallow connections===
==(Re)Moving a road from a junction==
==Updating details==
The details of a road can be entered as discussed with regard to confirming the detail of a new road above.  The procedure is the same for updating the details of an existing road segment.
To update details, first, select the segment(s) you need to update. Click on the segment and the segment will turn blue.
Multiple segments may be selected by holding down the modifier key and clicking additional segments.  The modifier key for Mac is the command key, for Windows the control key and for Linux the control key. Each selected segment will turn blue.
Once selected, if the [[Map_Editor_Interface_and_Controls#Properties_Toolbox|Properties Toolbox]] has not slid out to the left, click the tab to open it.
===Address Properties===
At the top of the properties toolbox are the address fields. The address fields include Country, State (currently only in the United States), City and Street.  Alternate street names are displayed but can not currently be edited in the waze map editor. To edit the address details, ''click'' the '''Edit Address''' link. This will enable editing of fields above it.  The Country (and State) fields may be updated by selecting a different country (or state) from the dropdown selections.  Selections will only be provided for countries (or states) that are present on other nearby road segments.
The city and street names may be updated by typing a new name. See [[How_to_label_and name_roads#Naming:_giving_your_road_the_proper_name|Naming]] for guidance on choosing the correct street name.  As a name is typed, Waze provides a list of similar names. These similar entries can be selected by clicking them.  If the segment is in a location outside a city, the "No City" check box should be selected and the city name will be blank.  If the road does not have a name, the "No Street" check box should be selected and street name will be blank.  Entries must be present for each address property. To eliminate a city name or street name the appropriate "No City" or "No Street" box must be checked.  When complete, ''click'' the '''Apply''' button.  If no changes are to be made, the cancel link may be selected.
===Road Properties===
In the middle of the properties toolbox are the road segment properties.
====Road Type====
The road type is changed by selecting the appropriate road type from the drop down box.
See [[How_to_label_and name_roads#Labeling;_giving_your_road_the_correct_road_type|Labling]] and the [[Map_Legend]] for further guidance on selecting the correct road type.
====Road Direction====
The direction of the road is changed by selecting the appropriate direction from the drop down box.
If traffic may travel both ways on the road, select "Two way."  If traffic may travel only one-way on the road, one of the "One way(&rarr;)" or "One way(&larr;)" selections is appropriate.  Selecting "One way(&rarr;)" results in a one way street in the native direction of the segment.  Selecting "One way(&larr;)" results in a one way street in the opposite direction.  Each road segment has a native direction.  This native direction does not necessarily correspond to any particular direction on the map (the native direction may be north, east, south, west or any direction that the road segment was created in).  If you created the road as discussed above, the native direction will be the direction from the point you clicked to start the road segment towards the point you double clicked to end the road segment.  There is no current way to discern the native segment of a road segment by looking at the editor map.  Therefore you must simply choose one of the "One way" choices without knowing which is correct.  If you guess wrong, choose the other.  When you select a "One way" direction, black arrows showing the direction of travel will appear on the segment.
After the road properties are saved, the direction is indicated by blue chevrons on the road.
Base mapped roads are originally assigned the direction of unknown.  When the direction is set to unknown Waze will automatically adjust the directionality of the road as Wazers drive it.  When editing make every effort to determine the correct direction of the road and choose either "Two way" or the appropriate "One way" direction. 
====Road Level====
The road level should be changed where one road passes over another.  By default, the Level of a segment is 0 (zero). When two segments overlap, the value of Level for each segment must be different. This ensures that the Waze problem detection system doesn't flag the spot where two segments overlap as a location where a junction might be needed. See [[Overpasses,_Underpasses_and_Bridges|Bridges]] for more information on levels.
===Locked Box===
The segment is locked by checking the locked check box.  For information on the effect of checking locked box see [[FAQ#What is a locked road?|Locked Roads]].
==Setting allowed turns (connections)==
See [[Creating and Editing a roundabout]] for guidance on roundabouts or traffic circles.
[[Map Editing (new Editor)#Editing_Manual|Back to Editing Manual]]

Latest revision as of 19:24, 27 February 2017

This is a documentation subpage for [[:Modèle:]].
It contains usage information, categories and other content that is not part of the original modèle page.