Thank you for your interest in improving the roads in South Africa. To get started, make sure you are up to speed with the basics of how to use the [[Map_Editing_%28new_Editor%29|Waze Map Editor]] (WME). Editing is a time consuming activity, so it could be handy to use the [[Keyboard_shortcut|shortcut keys]]. Pressing '?' while using WME will pop up a panel showing the supported [[Keyboard_shortcut|shortcut keys]].

Thank you for your interest in improving the roads in South Africa. To get started, make sure you are up to speed with the basics of how to use the [[Map_Editing_%28new_Editor%29|Waze Map Editor]] (WME). Editing is a time consuming activity, so it could be handy to use the [[Keyboard_shortcut|shortcut keys]]. Pressing '?' while using WME will pop up a panel showing the supported [[Keyboard_shortcut|shortcut keys]].

−

+

<br>

+

<br>

Before you begin, please read the information about [[Map_Editing#Google_aerial_images_cannot_be_used|Google aerial images]] and the use of Googze (i.e. don't use it!). Consulting a map book or looking up the name of the road should be ok, but do not trace roads from Google maps or Google aerial images. In areas which have been gated off, Google is not always accurate anyway. Please ensure you read the section on [[Map_Editing_%28new_Editor%29#Using_External_sources_.28such_as_Google_Imagery.29|external sources of data]] as using these may infringe copyrights.

Before you begin, please read the information about [[Map_Editing#Google_aerial_images_cannot_be_used|Google aerial images]] and the use of Googze (i.e. don't use it!). Consulting a map book or looking up the name of the road should be ok, but do not trace roads from Google maps or Google aerial images. In areas which have been gated off, Google is not always accurate anyway. Please ensure you read the section on [[Map_Editing_%28new_Editor%29#Using_External_sources_.28such_as_Google_Imagery.29|external sources of data]] as using these may infringe copyrights.

−

It is preferable to use GIS information supplied by local authorities, should this be available.

+

It is preferable to use GIS information supplied by local authorities, should this be available.<br>

−

+

<br>

−

+

<u>'''Start with the Basics'''</u><br>

<u>'''Start with the Basics'''</u><br>

−

Before you blindly start editing, make sure you look at the [[South_Africa#Tips_for_successful_editing| Tips for successful editing]]. Also ensure that you log in to the correct server. The 'www.waze.com' URL is only for USA and Canada. The proper server for the rest of the world is [https://world.waze.com world.waze.com], with the WME editor at [https://world.waze.com/editor world.waze.com/editor].

+

Before you blindly start editing, make sure you look at the [[South_Africa#Tips_for_successful_editing| Tips for successful editing]]. Also ensure that you log in to the correct server. The 'www.waze.com' URL is only for USA and Canada. The proper server for the rest of the world is [https://world.waze.com world.waze.com], with the WME editor at [https://world.waze.com/editor world.waze.com/editor].<br>

−

+

<br>

<u>'''Check out the Forums'''</u><br>

<u>'''Check out the Forums'''</u><br>

−

All the Waze sites use the same Username and Password that you registered with. If you have not yet logged in or registered on the Waze Forums, you can follow [https://world.waze.com/forum/ucp.php this link]. Please ensure that you at least set you location in the [https://world.waze.com/forum/ucp.php?i=164 'User Control Panel / Profile Tab / Location'] so that people can easily see which part of the world you are from when you post anything. South Africa has a [https://world.waze.com/forum/viewforum.php?f=62 dedicated Sub-Forum] located in the [https://world.waze.com/forum/viewforum.php?f=19 Country (Language) Forums] section.

+

For any general discussions, discussion of problems you encounter, [https://www.waze.com/forum/viewforum.php?f=265 unlock requests] or general chit-chat with other Wazers, you should visit the [https://world.waze.com/forum Waze Forums] and post a topic there under the relevant section. Please remember to do a keyword search first to see if your problem may have been discussed or may possibly have been resolved before. Do NOT start a new thread without checking first. Announcements are listed on every forum page. If the problem relates to yours, read the announcement first before attempting to post.<br>

−

+

The Forum community consists of editors and users such as yourself - they voluntarily assist other editors and users in their free time. The 'Waze Champions' consists of users all over the world that have a wealth of experience with Waze and editing techniques. As with any other form of Social Media, civilized behaviour, basic courtesy and [http://en.wikipedia.org/wiki/Etiquette_(technology) netiquette] should be observed.<br>

−

+

All the Waze sites use the same Username and Password that you registered with. If you have not yet logged in or registered on the Waze Forums, you can follow [https://world.waze.com/forum/ucp.php this link]. Please ensure that you at least set you location (City, Country) in the [https://world.waze.com/forum/ucp.php?i=164 'User Control Panel / Profile Tab / Location']. If people can see which part of the world you are from, it usually prompts a faster response to your query. If you post or are active on the forum, add an email address of an account you regularly monitor to [https://world.waze.com/forum/ucp.php?i=profile&mode=reg_details your profile]. This way you will get notified if someone sends you a private message, or if someone responds to a query you had. You can also set your notification preferences in the [https://world.waze.com/forum/ucp.php?i=prefs&mode=personal Control Panel].<br>

+

South Africa has a [https://world.waze.com/forum/viewforum.php?f=62 dedicated Sub-Forum] located in the [https://world.waze.com/forum/viewforum.php?f=19 Country (Language) Forums] section.<br>

+

Forum participation is one of the areas where South African editors (and users) should become more active in. Following some of the more interesting topics or just the general chit-chats could vastly expand your knowledge - you do not have to post a single thing, but you will be up to date with the latest happenings.

+

<br>

+

<br>

= Editing or Creating roads =

= Editing or Creating roads =

==Choosing the correct road type==

==Choosing the correct road type==

Choosing the correct road type is important in correctly mapping out your area. Below is the most common supported road types. When any of the National, Regional or Metropolitan designations (N,R,M) are used as part of the road name, the correct road type should be taken into consideration, especially when the road goes through towns.

Choosing the correct road type is important in correctly mapping out your area. Below is the most common supported road types. When any of the National, Regional or Metropolitan designations (N,R,M) are used as part of the road name, the correct road type should be taken into consideration, especially when the road goes through towns.

If a Freeway type is used where an N road runs through a major street in a smaller town, the inhabitants will never be routed on the main roads in the town if their client option is set to 'Avoid Highways'.

If a Freeway type is used where an N road runs through a major street in a smaller town, the inhabitants will never be routed on the main roads in the town if their client option is set to 'Avoid Highways'.

−

+

<br>

=== Highways ===

=== Highways ===

;Freeway

;Freeway

Line 25:

Line 29:

: These roads generally have multiple lanes and have very little or no stop signs or traffic lights regulating its flow through intersections. Access to major highways are not via special ramps, but via normal intersections with other road types. They are generally alternate routes leading from one major city to another, and may go through the center of smaller towns. They are generally the regional roads (R roads) (R21, R23, R24, R29).

: These roads generally have multiple lanes and have very little or no stop signs or traffic lights regulating its flow through intersections. Access to major highways are not via special ramps, but via normal intersections with other road types. They are generally alternate routes leading from one major city to another, and may go through the center of smaller towns. They are generally the regional roads (R roads) (R21, R23, R24, R29).

;Minor Highway

;Minor Highway

−

: These are similar to major highways, except that they have traffic lights or stop signs that regulate the flow of traffic on both the Minor Highway itself and on the intersecting roads. They will generally be R roads which are single lane and where 3- or 4-way stops are often found at intersections.

+

: These are similar to major highways, except that they have traffic lights or stop signs that regulate the flow of traffic on both the Minor Highway itself and on the intersecting roads. They will generally be R roads which are single lane and where 3- or 4-way stops are often found at intersections.

−

+

<br>

=== Ramps ===

=== Ramps ===

[[Junction_Style_Guide#Ramps|Ramps]] are used to connect entrances and exits to Freeways and Highways. They should only be used to connect any street type to Freeways, Major Highways or Minor Highways. The 'Ramp' road type should never be used as [[At-Grade_Connectors|AT-Grade connectors]] for creating slipways on non-highway road types.

[[Junction_Style_Guide#Ramps|Ramps]] are used to connect entrances and exits to Freeways and Highways. They should only be used to connect any street type to Freeways, Major Highways or Minor Highways. The 'Ramp' road type should never be used as [[At-Grade_Connectors|AT-Grade connectors]] for creating slipways on non-highway road types.

−

+

<br>

=== Primary Street ===

=== Primary Street ===

These are roads that are not highways and are heavily used. This would generally be the fastest route you would take to travel through a suburb or town. Examples in Johannesburg would be Rivonia Road, Bowling Avenue and South Road in Sandton, or Jan Smuts, Rissik and Empire in town.

These are roads that are not highways and are heavily used. This would generally be the fastest route you would take to travel through a suburb or town. Examples in Johannesburg would be Rivonia Road, Bowling Avenue and South Road in Sandton, or Jan Smuts, Rissik and Empire in town.

−

+

<br>

=== Service Road ===

=== Service Road ===

Service roads generally run alongside freeways and highways, allowing access to businesses situated right next to it. In other countries they are also used by emergency vehicles.<br>

Service roads generally run alongside freeways and highways, allowing access to businesses situated right next to it. In other countries they are also used by emergency vehicles.<br>

In South Africa we generally have a hard shoulder which is used as an emergency lane, and we do not have service roads that lead directly off of our freeways.

In South Africa we generally have a hard shoulder which is used as an emergency lane, and we do not have service roads that lead directly off of our freeways.

−

+

<br>

=== Dirt Roads/4x4 Trails ===

=== Dirt Roads/4x4 Trails ===

Any public road that does not have a tarred or otherwise paved surface can be considered a dirt road. Private farm roads and trails that are used exclusively as 4x4 trails should preferably not be mapped. They provide no functionality for the general commuter.

Any public road that does not have a tarred or otherwise paved surface can be considered a dirt road. Private farm roads and trails that are used exclusively as 4x4 trails should preferably not be mapped. They provide no functionality for the general commuter.

−

+

<br>

=== Parking Lot Road ===

=== Parking Lot Road ===

As the name suggests, [[Best_map_editing_practice#Parking_Lots|parking lot roads]] are used to map parking lots for shopping centers and Parkades. It is strongly advised not to clutter the map by drawing every single lane of the parking lot, but just the general exits and entrances and main sections that lead directly to shop fronts. If you map all lanes, do not be surprised if some of your edits are deleted by Area Managers. Parking lot roads are [[Best_map_editing_practice#Use_of_the_Parking_Lot_Road_Type|especially useful]] to 'offload' false traffic jam information at some fast food drive-throughs, or when parking lots are close to main roads and Waze might think you are stationary on the main road.

As the name suggests, [[Best_map_editing_practice#Parking_Lots|parking lot roads]] are used to map parking lots for shopping centers and Parkades. It is strongly advised not to clutter the map by drawing every single lane of the parking lot, but just the general exits and entrances and main sections that lead directly to shop fronts. If you map all lanes, do not be surprised if some of your edits are deleted by Area Managers. Parking lot roads are [[Best_map_editing_practice#Use_of_the_Parking_Lot_Road_Type|especially useful]] to 'offload' false traffic jam information at some fast food drive-throughs, or when parking lots are close to main roads and Waze might think you are stationary on the main road.

−

+

<br>

=== Private Road ===

=== Private Road ===

These are roads that are not accessible to the general public. i.e. you need special permission to access these roads. This is for Military Bases and gated communities like secure complexes (think Dainfern in Fourways or the Equestrian estate in Woodmead). Some complexes have multiple entrances that connects to the national grid at opposite ends, and if they are not marked as Private Roads, Waze will incorrectly attempt to route people through there.

These are roads that are not accessible to the general public. i.e. you need special permission to access these roads. This is for Military Bases and gated communities like secure complexes (think Dainfern in Fourways or the Equestrian estate in Woodmead). Some complexes have multiple entrances that connects to the national grid at opposite ends, and if they are not marked as Private Roads, Waze will incorrectly attempt to route people through there.

−

+

<br>

=== Street ===

=== Street ===

−

Any drivable road that does not fit into the categories above ,is a street.

+

Any drivable road that does not fit into the categories above, is a street.

−

+

<br>

=== Non drivable road ===

=== Non drivable road ===

In general, we do not encourage the use of these categories. They are unnecessary, but some railroads are already mapped. Ensure that you never connect any of these to the normal road network, as Waze will attempt to route traffic across these roads if they are connected to normal drivable road types. The general standard is to set 'Railroad' road types to levels to 9 or -5.

In general, we do not encourage the use of these categories. They are unnecessary, but some railroads are already mapped. Ensure that you never connect any of these to the normal road network, as Waze will attempt to route traffic across these roads if they are connected to normal drivable road types. The general standard is to set 'Railroad' road types to levels to 9 or -5.

−

+

<br>

+

<br>

+

== Toll Roads ==

+

The '''Avoid Toll Roads''' option in the client has been activated in South Africa. Roads and ramps that are part of the SANRAL Tolling system, or a Ferry route where payment is required, should be flagged as such by checking the "Toll Road" checkbox.

+

A complete list of all Toll Plazas, Toll Booths and e-Toll Gantries with their Permalinks is [[Toll Booths and Plazas (South Africa)|available here.]]

+

<br>

+

'''Important:''' Segments that form part of the GFIP e-Toll Gantry system should not be flagged as Toll Roads until a final decision has been reached on when e-Tolling will become active. These segments should only be activated when tolling actually commences.

+

<br>

+

<br>

== Setting Directionality ==

== Setting Directionality ==

After creating a new road, it is important to set the proper allowed direction of travel or [[Glossary#Directionality|directionality]] of the road. Roads can be 'one way' in a specific direction, or 'two-way' which allows traffic in both directions along the same segment. Normal streets are usually two-way, allowing traffic in both directions along the same segment or portion of the road. Freeways on the other hand are typically mapped as two separate One Way segments that run parallel to one another, with each of the parallel lanes allowing traffic to only flow in one direction.

After creating a new road, it is important to set the proper allowed direction of travel or [[Glossary#Directionality|directionality]] of the road. Roads can be 'one way' in a specific direction, or 'two-way' which allows traffic in both directions along the same segment. Normal streets are usually two-way, allowing traffic in both directions along the same segment or portion of the road. Freeways on the other hand are typically mapped as two separate One Way segments that run parallel to one another, with each of the parallel lanes allowing traffic to only flow in one direction.

−

+

<br>

−

+

<br>

== Setting Turn Restrictions ==

== Setting Turn Restrictions ==

When you connect one road to another road, verify the correct [[Glossary#Directionality|directionality]] of all the road segments that you connected. After the directionality is set, you should then set the correct turns that allowed where the roads connect. This is known as [[Map_Editing_Quick-start_Guide#Turn_restrictions_.28allowed_turns.29|Turn restrictions]] and it enables you to set the turns that are allowed or not allowed where the roads connect to each other. These connections are referred to as 'Junctions' in the editor, and is a mapped version of the actual intersection of the streets. Setting turn restrictions ensures that Waze routing on the map is only allowed in the same directions as what is possible on the actual roadways. If you are not allowed to turn left at an intersection while driving, there should also be a physical turn restriction on the Waze Map, indicating that a left turn is not permitted. A 'Green Arrow' indicates an allowed turn, while a 'Red Arrow' indicates that a turn is not allowed.

When you connect one road to another road, verify the correct [[Glossary#Directionality|directionality]] of all the road segments that you connected. After the directionality is set, you should then set the correct turns that allowed where the roads connect. This is known as [[Map_Editing_Quick-start_Guide#Turn_restrictions_.28allowed_turns.29|Turn restrictions]] and it enables you to set the turns that are allowed or not allowed where the roads connect to each other. These connections are referred to as 'Junctions' in the editor, and is a mapped version of the actual intersection of the streets. Setting turn restrictions ensures that Waze routing on the map is only allowed in the same directions as what is possible on the actual roadways. If you are not allowed to turn left at an intersection while driving, there should also be a physical turn restriction on the Waze Map, indicating that a left turn is not permitted. A 'Green Arrow' indicates an allowed turn, while a 'Red Arrow' indicates that a turn is not allowed.

−

+

<br>

−

+

<br>

== Controlling Turn Instructions ==

== Controlling Turn Instructions ==

It is important to understand how turn instructions are generated by Waze and how proper instructions can be forced by clever editing. In the same way, careless editing or leaving extra geometry nodes can also produce some unwanted or incorrect instructions. Generating turn instructions are discussed in the section on [[Junction_Style_Guide#Controlling_Turn_Instructions|controlling turn instructions]].

It is important to understand how turn instructions are generated by Waze and how proper instructions can be forced by clever editing. In the same way, careless editing or leaving extra geometry nodes can also produce some unwanted or incorrect instructions. Generating turn instructions are discussed in the section on [[Junction_Style_Guide#Controlling_Turn_Instructions|controlling turn instructions]].

−

+

<br>

−

+

<br>

== Setting Road Levels ==

== Setting Road Levels ==

Normal road levels should be set to 'Level 0'. Where roads intersect without actually connecting, like at Bridges or Highway Ramps, the appropriate levels should be set to ensure that none of the roads over or under has the same level. See [[Best_map_editing_practice#Overpasses_.26_Underpasses| Overpasses and Underpasses]].

Normal road levels should be set to 'Level 0'. Where roads intersect without actually connecting, like at Bridges or Highway Ramps, the appropriate levels should be set to ensure that none of the roads over or under has the same level. See [[Best_map_editing_practice#Overpasses_.26_Underpasses| Overpasses and Underpasses]].

+

<br>

+

<br>

+

== Road Names & Types ==

+

If roads appear as red lines in the editor, they are not named and there is no guarantee that they will be visible or even usable by the Waze client application. There are two reasons for properly naming roads : Audible directions and Traffic reports.

+

Waze uses TTS (Text-To-Speech) to provide driving instructions. In the Android and iPhone Waze clients, the road names are spoken as part of the driving instructions, e.g. 'Turn left into Elizabeth Avenue'.

−

== Naming Roads ==

+

For traffic reports, the '''Road Name''' and '''City Name''' portion is used as a visible clue in the report. It is thus important to correctly name and identify the proper location of each road. If you receive an alert that indicates an accident on 'Rivonia Rd', you would have no idea which portion of Rivonia Road is affected. If the report states that it is near 'Rivonia Rd, Morningside, Johannesburg', you would immediately know which portion of Rivonia Road is affected.

−

If roads appear as red lines in the editor, they are not named and there is no guarantee that they will be visible or even usable by the Waze client application. There are two reasons for properly naming roads : Audible directions and Traffic reports.<br>

+

<br>

−

Waze uses TTS (Text-To-Speech) to provide driving instructions. In the Android and iPhone Waze clients, the road names are spoken as part of the driving instructions, e.g. 'Turn left into Elizabeth Avenue'.<br>

+

The accepted naming convention for the 'Street Name' is to use the proper English name and abbreviated street type suffix for the road name. The correct name for '''"Elizabeth Avenue"''' or '''"Elizabeth Laan"''' would thus be '''"Elizabeth ''Ave''"'''. Ensure you use the correct case for the suffix. It should start with a capital letter like '''Rd''', '''St''' or '''Ave''' and not '''''rd''''', '''''st''''' or '''''ave'''''.

−

For traffic reports, the Road Name and City Name portion is used as a visible clue in the report. It is thus important to correctly name and identify the proper location of each road. If you receive an alert that indicates an accident on 'Rivonia Rd', you would have no idea which portion of Rivonia Road is affected. If the report states that it is near 'Rivonia Rd, Morningside, Sandton', you would immediately know which portion of Rivonia Road is affected.<br>

+

<br>

−

The accepted naming convention for the 'Street Name' is to use the proper English name and 'street type' abbreviation for the road name. The accepted name for 'Elizabeth Avenue' or 'Elizabeth Laan' would thus be 'Elizabeth Ave'. Where road names are just numbers, rather stick to what the actual signage indicates for the name, as '21 First Road' is likely not the same place as '21 1st Road'.<br>

+

Where road names are indicated as numbers, stick to what the actual signage indicates for the name. The address for '21 First Road' is not the same as for '21 1st Road', especially if both naming conventions are used within the same town or suburb.

+

<br>

+

<br>

+

=== Naming the Road ===

+

There are 3 fields when initialy naming a road in WME : Country, Name and City.

+

==== Country ====

+

The '''"Country:"''' field should always be populated with '''South Africa'''. When editing near the country borders, a neighbouring country name might be available in the Country dropdown list. If this is the case, please ensure that you select the correct country when you name anything.

+

==== City ====

+

The '''"City:"''' field for any city, town or suburb should only contain the name as discussed in [[South_Africa#Naming_the_City|Naming the City]] - i.e. '''just''' the Town name or City name, or a combination of '''"Suburb, City"'''. South Africa should NEVER be appended to the city name - it is already contained in the Country field.

+

Be careful when entering a name for a new location the first time, as you will not be able to change the case of the name once it is saved. Just like human names and surnames, city and suburb names should start with a capital letter - do not use fancy conventions like capitalizing every syllable, e.g. TweeBuffelsMetEenSkootMorsDoodGeskietFontein.

+

==== Name ====

+

The '''"Name:"''' Field should only contain the Road Name and Abbreviated Suffix for a normal Street. For and any other N/R/M Routes, various individual naming conventions apply as discussed below in [[South_Africa#Numbered_routes|Numbered Routes]].

+

<br>

+

<br>

+

==== Alternate name ====

+

Once a road is properly named and saved, an option will be available to add an alternate name. This could be useful if a specific street or route is known by one name by local citizens but referred to using a different name by the wider populace. The Primary Name preference is firstly signage, and lacking that, the locally known name. The lesser used name could then be used for the alternate name.

+

With the common local practice where roads are renamed to reflect or acknowledge leaders and contributors from the diverse cultures, the primary name should be changed to the NEW name. The old name can then be retained in the alternate name until old signage is finally removed.

+

Please note that the alternate name will not be used or recognised by Waze when you do a street name search. It might appear in search results provided by the third party address and POI providers. Due to this limitation, alternate name usage is not encouraged.

+

The alternate name entry is only supported by a City and Name field.

+

<br>

+

<br>

+

=== Acceptable suffix abbreviations ===

+

See [[Suffix Abbreviations (South Africa)]] or [[Suffix Abbreviations]] for a more general list of suffixes; however, the table below lists the most commonly used suffixes and the Afrikaans equivalents which may be useful to some people.

South African roads frequently belong to a "numbered route" such as N1 or R25. This designation will usually appear in signage along the route, particularly along freeways and on freeway entrance/exit boards.

−

=== Freeways and motorways ===

+

In some cases, the route designation is the primary name by which the road is known: for example, the R24 approaching O R Tambo International Airport is named "Albertina Sisulu Freeway" but most people are completely unfamiliar with this name, and very few signs mention it. In this case, only the route designation should be used for the Waze road name: eg. "N1" or "R24". Adding the actual road name (eg. "Albertina Sisulu Freeway" or "Ben Schoeman Highway") as an "alternate name" could be done, but at the moment this seems to serve little purpose; including it in the main name should not be done, as this would add a large amount of clutter to the map while serving little purpose.

−

Freeways and motorways generally have a letter/number that everyone recognizes as well as a name that most people don't. For example, the N1 by Johannesburg is called the Western Bypass. As such, the northbound section should be named: N1 Western Bypass North, while the southbound portion should be named N1 Western Bypass South.

+

−

If you are unsure of the full name, then just name it by its common name, i.e. N1 North. It is advisable to use the full direction and not the abbreviation as N1 North looks a lot cleaner on the client than N1 (N).

+

−

=== Major and minor highways ===

+

In other cases, the road name is primarily how the road is known, while the route designation is secondary. In this case, the route designation should be appended to the road name: for example, "William Nicol Dr (R511)". Even in cases where the route designation is very obscure / poorly signposted, it adds very little to the length of the road name so there is little cost to including it, and it is often helpful when following a route that comprises several different roads as it passes through different suburbs.

−

The same rules apply as those for freeways, however, you should think carefully about splitting major highways. Minor highways that are single lane in either direction should never be split. In such cases you would simple leave out the direction indicator.

+

−

=== Primary Roads ===

+

{| class="wikitable unsortable" border="1"

−

Most primary roads will have a name that everyone recognises and a number that not many do. For example, Bowling Avenue is the M85. The naming scheme should be the name followed by the number in brackets, i.e. Bowling Ave (M85) or Commissioner St (R24)

+

|+ Classification of South African routes

+

|-

+

!Route format!!Example!!Waze road type!!Description

+

|-

+

|Nn||N1||Freeway||National route

+

|-

+

|Rnn||R24||Major Highway||Regional route

+

|-

+

|Rnnn||R512||Minor Highway||Regional route

+

|-

+

|Mn/Mnn||M5||Primary Road||Metropolitan route

+

|}

−

=== Streets ===

+

The designation of national and regional routes is unique countrywide: there is only one N1. On the other hand, metropolitan routes are only unique within a particular metropolitan area: the M5 in Johannesburg is a different route to the M5 in Cape Town.

−

Normal streets generally just have a name with no separate N, R or M designation.

+

+

In the table above, "Waze road type" refers to the "minimum" type that a road should be. For example, the N2 should be "promoted" to Freeway even in the single-lane-highway and urban sections. On the other hand, the R24 is a freeway so should be marked as such even though it only warrants "Major Highway" for its route designation alone.

+

+

Actual freeways should always be split into separate one-way road segments; national routes that are not freeways need not be split unless other circumstances require it.

=== Roundabout segments ===

=== Roundabout segments ===

−

Roundabouts should not be named, but they should also not be left as red blotches of road. Select the 'No Name' checkbox for each of the segments in the roundabout, and properly fill in the 'Suburb, City' name for the segments. If the City is not known, or you are uncertain, ensure you check the 'No City' checkbox. The Roundabout road types should also match the highest road types that connects to it, as it could affect routing. Was it mentioned that you should not leave them as freshly paved 'red' roads ?

+

See [[Creating and Editing a roundabout]] for guidance on this subject. In particular, note that the city name should be set but "No Name" should be checked. Also, in the event of the tiny traffic circles found in some parts of South Africa, it is often best not to create a roundabout; people turning across the traffic circle (in some cases one can just drive directly over it) will often lock to the wrong road segments resulting in map errors being generated and such.

+

<br>

+

<br>

== Naming the City ==

== Naming the City ==

−

South African addresses are complicated in that they have multiple levels:

+

South African addresses are complicated in that they have multiple levels. For example:

−

An example would be:

+

−

Country: South Africa<br>

+

Country: South Africa<br/>

−

Province: Gauteng<br>

+

Province: Gauteng<br/>

−

City: Johannesburg<br>

+

City: Johannesburg<br/>

−

Town: Sandton<br>

+

Town: Sandton<br/>

−

Suburb: Morningside<br>

+

Suburb: Morningside<br/>

Waze automatically stores the country, so this is unnecessary. However, the other three are all likely candidates when searching for an address. This is a problem as Waze only allows us to capture 1 entry under city.

Waze automatically stores the country, so this is unnecessary. However, the other three are all likely candidates when searching for an address. This is a problem as Waze only allows us to capture 1 entry under city.

−

Wazers have got round this problem by capturing the Suburb, City. So the above example would be Morningside, Johannesburg. This is the recommended method as just capturing the suburb can cause confusion with people who are not familiar with the area.

−

Please do not type anything into the English City Name (if available). Our cities are either in English or do not have an English equivalent. There is no need to translate [http://en.wikipedia.org/wiki/Tweebuffelsmeteenskootmorsdoodgeskietfontein Tweebuffelsmeteenskootmorsdoodgeskietfontein]. In the past someone thought they might be able to use this field for a suburb, unfortunately this means that center Johannesburg has an english name of "Sunningwood"

+

Wazers have got round this problem by capturing the Suburb, City. So the above example would be Morningside, Johannesburg. This is the recommended method as just capturing the suburb can cause confusion with people who are not familiar with the area.

+

Please note that the old municipalities that were merged into the City of Johannesburg Metropolitan Municipality should /not/ be used as the city. That is, the suburb of Bryanston should have a city name of "Bryanston, Johannesburg", not "Bryanston, Sandton". The same applies for other metro areas that have undergone municipal consolidation.

== Splitting a road ==

== Splitting a road ==

Splitting dual lane roads is not advised as this requires a lot of maintenance with turn restrictions at intersections. A split road will generally cause Waze to start recommending illegal U-Turns if it is not properly created. This includes routing onto an adjacent road, where a U-Turn will be suggested to get back onto the same road again, especially where traffic lights have longer than average waiting periods.

Splitting dual lane roads is not advised as this requires a lot of maintenance with turn restrictions at intersections. A split road will generally cause Waze to start recommending illegal U-Turns if it is not properly created. This includes routing onto an adjacent road, where a U-Turn will be suggested to get back onto the same road again, especially where traffic lights have longer than average waiting periods.

−

As it is not a simple task to un-split a road, be sure to refer to the sections on [[Best_map_editing_practice#When_.28Not.29_to_Split_a_Two-Way_Road|when to split or not split a 2-way road]] and [[Best_map_editing_practice#How_to_.22Un-Split.22_two_One-Way_Roads|when to unsplit a road]].

+

+

As it is not a simple task to un-split a road, be sure to refer to the sections on [[Best_map_editing_practice#When_.28Not.29_to_Split_a_Two-Way_Road|when to split or not split a 2-way road]] and [[Best_map_editing_practice#How_to_.22Un-Split.22_two_One-Way_Roads|when to unsplit a road]]. In general, unsplit is preferred; only split roads where it is actually necessary. In particular, please think twice (and post on the forums for good measure) before splitting an existing road; there is most likely a reason it is not split.

+

WME does not currently support the "Separating Lane" option that the retired Cartouche editor had.

WME does not currently support the "Separating Lane" option that the retired Cartouche editor had.

−

== Other Mappable Categories ==

== Other Mappable Categories ==

Waze supports certain Landmarks that can be mapped. Not all types are useful, and Landmarks should be used sparingly.

Waze supports certain Landmarks that can be mapped. Not all types are useful, and Landmarks should be used sparingly.

Traffic Circles can also be created to generate proper instructions for negotiating roundabouts.

Traffic Circles can also be created to generate proper instructions for negotiating roundabouts.

−

+

<br>

=== Traffic Circles / Roundabouts ===

=== Traffic Circles / Roundabouts ===

If traffic circles are mapped just [[Best_map_editing_practice#When_to_Create_a_Roundabout|using normal street types]], drivers will not get any special instructions. It is thus important to create them using the Roundabout tool. This way the driver will be notified to carry straight on, or take a specific exit number using an 'At the roundabout, ...' voice prompt.

If traffic circles are mapped just [[Best_map_editing_practice#When_to_Create_a_Roundabout|using normal street types]], drivers will not get any special instructions. It is thus important to create them using the Roundabout tool. This way the driver will be notified to carry straight on, or take a specific exit number using an 'At the roundabout, ...' voice prompt.

The best way to create a roundabout is discussed in [[Creating_and_Editing_a_roundabout|this section]] of the Wiki. When multiple different road types all connect to the roundabout, ensure that the proper road type is set to the highest common denominator for the [[Roundabout#Road_Type|roundabout road type]].

The best way to create a roundabout is discussed in [[Creating_and_Editing_a_roundabout|this section]] of the Wiki. When multiple different road types all connect to the roundabout, ensure that the proper road type is set to the highest common denominator for the [[Roundabout#Road_Type|roundabout road type]].

−

+

<br>

=== Landmarks ===

=== Landmarks ===

Waze supports quite a number of different Landmark types. Adding Landmarks should be done sparingly, as they tend to clutter the map and not all of the landmarks serve any useful purpose.

Waze supports quite a number of different Landmark types. Adding Landmarks should be done sparingly, as they tend to clutter the map and not all of the landmarks serve any useful purpose.

Some of the landmarks have the ability to suppress traffic generation, like the 'Gas Station' or the 'Parking Lot' type. If Waze detects that you are within any of these landmarks, and you are stationary, it will not generate false 'Traffic Jam' information. It is thus important to ensure that these types of landmarks do not overlap or snap to any of the roads around them, as this will inhibit traffic report generation in these areas.

Some of the landmarks have the ability to suppress traffic generation, like the 'Gas Station' or the 'Parking Lot' type. If Waze detects that you are within any of these landmarks, and you are stationary, it will not generate false 'Traffic Jam' information. It is thus important to ensure that these types of landmarks do not overlap or snap to any of the roads around them, as this will inhibit traffic report generation in these areas.

−

+

<br>

−

+

<br>

== Tips for successful editing ==

== Tips for successful editing ==

<ol>

<ol>

Line 166:

Line 220:

<li>Drawing two roads so that they touch, does not automatically mean Waze will route from the one to the other. To allow routing, make sure they form a new junction (round node) if you drag them together. A square geometry node is not a connection. To make your life easier, make sure you always override the "Enable all turns" after creating a junction. Highlight the junction and press 'Q' and then 'W'. This means you can then restrict just the turns that are not possible.</li>

<li>Drawing two roads so that they touch, does not automatically mean Waze will route from the one to the other. To allow routing, make sure they form a new junction (round node) if you drag them together. A square geometry node is not a connection. To make your life easier, make sure you always override the "Enable all turns" after creating a junction. Highlight the junction and press 'Q' and then 'W'. This means you can then restrict just the turns that are not possible.</li>

<li>If you drag two segments together and they refuse to create a connection node, you can try connecting them by dragging one slightly past the other so they cross, and then selecting both segments using the 'Control+Left-Click' method. This would usually bring up the [[Map_Editing_Quick-start_Guide#Overlapping_road_junction|intersection popup]] where they overlap, allowing you to connect them if you click on it. Click on the extra piece sticking over, and delete that.</li>

<li>If you drag two segments together and they refuse to create a connection node, you can try connecting them by dragging one slightly past the other so they cross, and then selecting both segments using the 'Control+Left-Click' method. This would usually bring up the [[Map_Editing_Quick-start_Guide#Overlapping_road_junction|intersection popup]] where they overlap, allowing you to connect them if you click on it. Click on the extra piece sticking over, and delete that.</li>

−

<li>When mapping new areas, always verify turn restrictions after you have created all of the roads. For best results, zoom out to the 100m/500ft zoom level and press the 'Shift-A' key. This will highlight any turns that are not allowed using the normal Red Arrows around junctions. You can then verify that the correct restrictions are in place by zooming back in to each of the locations where the arrows show up. If they should be allowed, you can select the junction and press the 'Q' and 'W' keys to allow turns. Pressing 'Shift-A' will toggle this functionality on and off.</li>

+

<li>When mapping new areas, always verify turn restrictions after you have created all of the roads. For best results, zoom out to the 100m/500ft zoom level and press the 'Shift-Z' key. This will highlight any turns that are not allowed using the normal Red Arrows around junctions. You can then verify that the correct restrictions are in place by zooming back in to each of the locations where the arrows show up. If they should be allowed, you can select the junction and press the 'Q' and 'W' keys to allow turns. Pressing 'Shift-A' will toggle this functionality on and off.</li>

<li>When connecting roads, the 'soft turn restrictions' (not visible in the editor) will automatically allow all valid turns for the connectivity based on road directionality. The 'hard turn restrictions' (visible via the red & green arrows) will be set not to allow any turns to and from the newly connected segment. To ensure that soft turn restrictions do not cause routing problems later on, click on the connection node and press the 'Q' key to disallow all turns for soft and hard turn restrictions. You can then allow each individual turn for each segment by selecting the connected segments in turn. If all turns should be allowed for all directions, press the 'W' key while the junction node is still selected.</li>

<li>When connecting roads, the 'soft turn restrictions' (not visible in the editor) will automatically allow all valid turns for the connectivity based on road directionality. The 'hard turn restrictions' (visible via the red & green arrows) will be set not to allow any turns to and from the newly connected segment. To ensure that soft turn restrictions do not cause routing problems later on, click on the connection node and press the 'Q' key to disallow all turns for soft and hard turn restrictions. You can then allow each individual turn for each segment by selecting the connected segments in turn. If all turns should be allowed for all directions, press the 'W' key while the junction node is still selected.</li>

<li>Do not add new segments into the middle of busy roads. Rather re-use and split a piece from an existing adjacent segment of the same road. This way the existing speed information and history is retained. Adding a new segment with no speed information or history could initially cause some weird routing if the segment goes live on the map. This might then persist until new history is built up for the newly added segment.</li>

<li>Do not add new segments into the middle of busy roads. Rather re-use and split a piece from an existing adjacent segment of the same road. This way the existing speed information and history is retained. Adding a new segment with no speed information or history could initially cause some weird routing if the segment goes live on the map. This might then persist until new history is built up for the newly added segment.</li>

Line 172:

Line 226:

<li>To select multiple roads, hold down the 'Control' key while click on the roads.</li>

<li>To select multiple roads, hold down the 'Control' key while click on the roads.</li>

<li>When looking at URs (User Reported problems) or Map Problems, always test existing routing on the Livemap if the problem involves invalid routing. If the problem is not evident, you can always ask for assistance in the [https://world.waze.com/forum/viewforum.php?f=62 Waze Forum]. If you cannot work out what the problem is, it might be a small piece of a road underneath. Try moving some of the roads out the way to see if a latent piece of road was left cut off when a junction was added.</li>

<li>When looking at URs (User Reported problems) or Map Problems, always test existing routing on the Livemap if the problem involves invalid routing. If the problem is not evident, you can always ask for assistance in the [https://world.waze.com/forum/viewforum.php?f=62 Waze Forum]. If you cannot work out what the problem is, it might be a small piece of a road underneath. Try moving some of the roads out the way to see if a latent piece of road was left cut off when a junction was added.</li>

−

<li>Some members of the Waze community has written a few helpful scripts that helps identifying problems. Use them to your advantage.

+

<li>Some members of the Waze community has written a few helpful scripts that helps identifying problems. Use them to your advantage. A complete up to date list is available at [[Community_Plugins%2C_Extensions_and_Tools]].

<li>Learn the [[Map_Editing_Quick-start_Guide#Keyboard_Shortcuts|shortcut keys]]. They make life a lot simpler!</li>

<li>Learn the [[Map_Editing_Quick-start_Guide#Keyboard_Shortcuts|shortcut keys]]. They make life a lot simpler!</li>

−

+

<br>

+

<br>

== FAQ ==

== FAQ ==

−

A lot of Frequently Asked Questions are already covered in the current [[FAQ]].

+

A lot of Frequently Asked Questions are already covered in the current [[FAQ|editing FAQ]].

−

+

<br>

−

+

<br>

== Glossary ==

== Glossary ==

The [[Glossary]] explains some of the abbreviations and terminology used in the Waze world.

The [[Glossary]] explains some of the abbreviations and terminology used in the Waze world.

−

+

<br>

−

+

<br>

== Waze User Manuals ==

== Waze User Manuals ==

The currently supported version of Waze is v3.5. Version 3.5 is unfortunately only supported on Android Smartphones and Tablets and on iPhone and iPad devices. Here is the [[Waze_Version_3.5|Generic v3.5 User Manual]].<br>

The currently supported version of Waze is v3.5. Version 3.5 is unfortunately only supported on Android Smartphones and Tablets and on iPhone and iPad devices. Here is the [[Waze_Version_3.5|Generic v3.5 User Manual]].<br>

Line 199:

Line 254:

*[[Symbian_User_Manual|Symbian]]

*[[Symbian_User_Manual|Symbian]]

*[[Windows_Mobile_User_Manual|Windows Mobile]]

*[[Windows_Mobile_User_Manual|Windows Mobile]]

−

+

<br>

+

<br>

== Final words ==

== Final words ==

Just have fun and happy Wazing. Hope to see you on the roads soon!

Just have fun and happy Wazing. Hope to see you on the roads soon!

+

<br>

Revision as of 23:40, 2 May 2013

Complete Guide to Waze in South Africa (Under Development)

Thank you for your interest in improving the roads in South Africa. To get started, make sure you are up to speed with the basics of how to use the Waze Map Editor (WME). Editing is a time consuming activity, so it could be handy to use the shortcut keys. Pressing '?' while using WME will pop up a panel showing the supported shortcut keys.

Before you begin, please read the information about Google aerial images and the use of Googze (i.e. don't use it!). Consulting a map book or looking up the name of the road should be ok, but do not trace roads from Google maps or Google aerial images. In areas which have been gated off, Google is not always accurate anyway. Please ensure you read the section on external sources of data as using these may infringe copyrights.
It is preferable to use GIS information supplied by local authorities, should this be available.

Start with the Basics
Before you blindly start editing, make sure you look at the Tips for successful editing. Also ensure that you log in to the correct server. The 'www.waze.com' URL is only for USA and Canada. The proper server for the rest of the world is world.waze.com, with the WME editor at world.waze.com/editor.

Check out the Forums
For any general discussions, discussion of problems you encounter, unlock requests or general chit-chat with other Wazers, you should visit the Waze Forums and post a topic there under the relevant section. Please remember to do a keyword search first to see if your problem may have been discussed or may possibly have been resolved before. Do NOT start a new thread without checking first. Announcements are listed on every forum page. If the problem relates to yours, read the announcement first before attempting to post.
The Forum community consists of editors and users such as yourself - they voluntarily assist other editors and users in their free time. The 'Waze Champions' consists of users all over the world that have a wealth of experience with Waze and editing techniques. As with any other form of Social Media, civilized behaviour, basic courtesy and netiquette should be observed.
All the Waze sites use the same Username and Password that you registered with. If you have not yet logged in or registered on the Waze Forums, you can follow this link. Please ensure that you at least set you location (City, Country) in the 'User Control Panel / Profile Tab / Location'. If people can see which part of the world you are from, it usually prompts a faster response to your query. If you post or are active on the forum, add an email address of an account you regularly monitor to your profile. This way you will get notified if someone sends you a private message, or if someone responds to a query you had. You can also set your notification preferences in the Control Panel.
South Africa has a dedicated Sub-Forum located in the Country (Language) Forums section.
Forum participation is one of the areas where South African editors (and users) should become more active in. Following some of the more interesting topics or just the general chit-chats could vastly expand your knowledge - you do not have to post a single thing, but you will be up to date with the latest happenings.

Editing or Creating roads

Choosing the correct road type

Choosing the correct road type is important in correctly mapping out your area. Below is the most common supported road types. When any of the National, Regional or Metropolitan designations (N,R,M) are used as part of the road name, the correct road type should be taken into consideration, especially when the road goes through towns.
If a Freeway type is used where an N road runs through a major street in a smaller town, the inhabitants will never be routed on the main roads in the town if their client option is set to 'Avoid Highways'.

Highways

Freeway

Freeways are free flowing roads with no regular intersections. Access to Freeways are limited to only on- and off-ramps. This means that there are no stop signs or traffic lights on the Freeway itself. Traffic lights and stop signs are limited only to where the ramps connect to other road types. These are generally your national roads (N1, N2, N3 ...) or motorways (M1, M2 ...).

Major Highway

These roads generally have multiple lanes and have very little or no stop signs or traffic lights regulating its flow through intersections. Access to major highways are not via special ramps, but via normal intersections with other road types. They are generally alternate routes leading from one major city to another, and may go through the center of smaller towns. They are generally the regional roads (R roads) (R21, R23, R24, R29).

Minor Highway

These are similar to major highways, except that they have traffic lights or stop signs that regulate the flow of traffic on both the Minor Highway itself and on the intersecting roads. They will generally be R roads which are single lane and where 3- or 4-way stops are often found at intersections.

Ramps

Ramps are used to connect entrances and exits to Freeways and Highways. They should only be used to connect any street type to Freeways, Major Highways or Minor Highways. The 'Ramp' road type should never be used as AT-Grade connectors for creating slipways on non-highway road types.

Primary Street

These are roads that are not highways and are heavily used. This would generally be the fastest route you would take to travel through a suburb or town. Examples in Johannesburg would be Rivonia Road, Bowling Avenue and South Road in Sandton, or Jan Smuts, Rissik and Empire in town.

Service Road

Service roads generally run alongside freeways and highways, allowing access to businesses situated right next to it. In other countries they are also used by emergency vehicles.
In South Africa we generally have a hard shoulder which is used as an emergency lane, and we do not have service roads that lead directly off of our freeways.

Dirt Roads/4x4 Trails

Any public road that does not have a tarred or otherwise paved surface can be considered a dirt road. Private farm roads and trails that are used exclusively as 4x4 trails should preferably not be mapped. They provide no functionality for the general commuter.

Parking Lot Road

As the name suggests, parking lot roads are used to map parking lots for shopping centers and Parkades. It is strongly advised not to clutter the map by drawing every single lane of the parking lot, but just the general exits and entrances and main sections that lead directly to shop fronts. If you map all lanes, do not be surprised if some of your edits are deleted by Area Managers. Parking lot roads are especially useful to 'offload' false traffic jam information at some fast food drive-throughs, or when parking lots are close to main roads and Waze might think you are stationary on the main road.

Private Road

These are roads that are not accessible to the general public. i.e. you need special permission to access these roads. This is for Military Bases and gated communities like secure complexes (think Dainfern in Fourways or the Equestrian estate in Woodmead). Some complexes have multiple entrances that connects to the national grid at opposite ends, and if they are not marked as Private Roads, Waze will incorrectly attempt to route people through there.

Street

Any drivable road that does not fit into the categories above, is a street.

Non drivable road

In general, we do not encourage the use of these categories. They are unnecessary, but some railroads are already mapped. Ensure that you never connect any of these to the normal road network, as Waze will attempt to route traffic across these roads if they are connected to normal drivable road types. The general standard is to set 'Railroad' road types to levels to 9 or -5.

Toll Roads

The Avoid Toll Roads option in the client has been activated in South Africa. Roads and ramps that are part of the SANRAL Tolling system, or a Ferry route where payment is required, should be flagged as such by checking the "Toll Road" checkbox.
A complete list of all Toll Plazas, Toll Booths and e-Toll Gantries with their Permalinks is available here.Important: Segments that form part of the GFIP e-Toll Gantry system should not be flagged as Toll Roads until a final decision has been reached on when e-Tolling will become active. These segments should only be activated when tolling actually commences.

Setting Directionality

After creating a new road, it is important to set the proper allowed direction of travel or directionality of the road. Roads can be 'one way' in a specific direction, or 'two-way' which allows traffic in both directions along the same segment. Normal streets are usually two-way, allowing traffic in both directions along the same segment or portion of the road. Freeways on the other hand are typically mapped as two separate One Way segments that run parallel to one another, with each of the parallel lanes allowing traffic to only flow in one direction.

Setting Turn Restrictions

When you connect one road to another road, verify the correct directionality of all the road segments that you connected. After the directionality is set, you should then set the correct turns that allowed where the roads connect. This is known as Turn restrictions and it enables you to set the turns that are allowed or not allowed where the roads connect to each other. These connections are referred to as 'Junctions' in the editor, and is a mapped version of the actual intersection of the streets. Setting turn restrictions ensures that Waze routing on the map is only allowed in the same directions as what is possible on the actual roadways. If you are not allowed to turn left at an intersection while driving, there should also be a physical turn restriction on the Waze Map, indicating that a left turn is not permitted. A 'Green Arrow' indicates an allowed turn, while a 'Red Arrow' indicates that a turn is not allowed.

Controlling Turn Instructions

It is important to understand how turn instructions are generated by Waze and how proper instructions can be forced by clever editing. In the same way, careless editing or leaving extra geometry nodes can also produce some unwanted or incorrect instructions. Generating turn instructions are discussed in the section on controlling turn instructions.

Setting Road Levels

Normal road levels should be set to 'Level 0'. Where roads intersect without actually connecting, like at Bridges or Highway Ramps, the appropriate levels should be set to ensure that none of the roads over or under has the same level. See Overpasses and Underpasses.

Road Names & Types

If roads appear as red lines in the editor, they are not named and there is no guarantee that they will be visible or even usable by the Waze client application. There are two reasons for properly naming roads : Audible directions and Traffic reports.

Waze uses TTS (Text-To-Speech) to provide driving instructions. In the Android and iPhone Waze clients, the road names are spoken as part of the driving instructions, e.g. 'Turn left into Elizabeth Avenue'.

For traffic reports, the Road Name and City Name portion is used as a visible clue in the report. It is thus important to correctly name and identify the proper location of each road. If you receive an alert that indicates an accident on 'Rivonia Rd', you would have no idea which portion of Rivonia Road is affected. If the report states that it is near 'Rivonia Rd, Morningside, Johannesburg', you would immediately know which portion of Rivonia Road is affected.
The accepted naming convention for the 'Street Name' is to use the proper English name and abbreviated street type suffix for the road name. The correct name for "Elizabeth Avenue" or "Elizabeth Laan" would thus be "Elizabeth Ave". Ensure you use the correct case for the suffix. It should start with a capital letter like Rd, St or Ave and not rd, st or ave.
Where road names are indicated as numbers, stick to what the actual signage indicates for the name. The address for '21 First Road' is not the same as for '21 1st Road', especially if both naming conventions are used within the same town or suburb.

Naming the Road

There are 3 fields when initialy naming a road in WME : Country, Name and City.

Country

The "Country:" field should always be populated with South Africa. When editing near the country borders, a neighbouring country name might be available in the Country dropdown list. If this is the case, please ensure that you select the correct country when you name anything.

City

The "City:" field for any city, town or suburb should only contain the name as discussed in Naming the City - i.e. just the Town name or City name, or a combination of "Suburb, City". South Africa should NEVER be appended to the city name - it is already contained in the Country field.
Be careful when entering a name for a new location the first time, as you will not be able to change the case of the name once it is saved. Just like human names and surnames, city and suburb names should start with a capital letter - do not use fancy conventions like capitalizing every syllable, e.g. TweeBuffelsMetEenSkootMorsDoodGeskietFontein.

Name

The "Name:" Field should only contain the Road Name and Abbreviated Suffix for a normal Street. For and any other N/R/M Routes, various individual naming conventions apply as discussed below in Numbered Routes.

Alternate name

Once a road is properly named and saved, an option will be available to add an alternate name. This could be useful if a specific street or route is known by one name by local citizens but referred to using a different name by the wider populace. The Primary Name preference is firstly signage, and lacking that, the locally known name. The lesser used name could then be used for the alternate name.
With the common local practice where roads are renamed to reflect or acknowledge leaders and contributors from the diverse cultures, the primary name should be changed to the NEW name. The old name can then be retained in the alternate name until old signage is finally removed.
Please note that the alternate name will not be used or recognised by Waze when you do a street name search. It might appear in search results provided by the third party address and POI providers. Due to this limitation, alternate name usage is not encouraged.
The alternate name entry is only supported by a City and Name field.

Numbered routes

South African roads frequently belong to a "numbered route" such as N1 or R25. This designation will usually appear in signage along the route, particularly along freeways and on freeway entrance/exit boards.

In some cases, the route designation is the primary name by which the road is known: for example, the R24 approaching O R Tambo International Airport is named "Albertina Sisulu Freeway" but most people are completely unfamiliar with this name, and very few signs mention it. In this case, only the route designation should be used for the Waze road name: eg. "N1" or "R24". Adding the actual road name (eg. "Albertina Sisulu Freeway" or "Ben Schoeman Highway") as an "alternate name" could be done, but at the moment this seems to serve little purpose; including it in the main name should not be done, as this would add a large amount of clutter to the map while serving little purpose.

In other cases, the road name is primarily how the road is known, while the route designation is secondary. In this case, the route designation should be appended to the road name: for example, "William Nicol Dr (R511)". Even in cases where the route designation is very obscure / poorly signposted, it adds very little to the length of the road name so there is little cost to including it, and it is often helpful when following a route that comprises several different roads as it passes through different suburbs.

Classification of South African routes

Route format

Example

Waze road type

Description

Nn

N1

Freeway

National route

Rnn

R24

Major Highway

Regional route

Rnnn

R512

Minor Highway

Regional route

Mn/Mnn

M5

Primary Road

Metropolitan route

The designation of national and regional routes is unique countrywide: there is only one N1. On the other hand, metropolitan routes are only unique within a particular metropolitan area: the M5 in Johannesburg is a different route to the M5 in Cape Town.

In the table above, "Waze road type" refers to the "minimum" type that a road should be. For example, the N2 should be "promoted" to Freeway even in the single-lane-highway and urban sections. On the other hand, the R24 is a freeway so should be marked as such even though it only warrants "Major Highway" for its route designation alone.

Actual freeways should always be split into separate one-way road segments; national routes that are not freeways need not be split unless other circumstances require it.

Roundabout segments

See Creating and Editing a roundabout for guidance on this subject. In particular, note that the city name should be set but "No Name" should be checked. Also, in the event of the tiny traffic circles found in some parts of South Africa, it is often best not to create a roundabout; people turning across the traffic circle (in some cases one can just drive directly over it) will often lock to the wrong road segments resulting in map errors being generated and such.

Naming the City

South African addresses are complicated in that they have multiple levels. For example:

Waze automatically stores the country, so this is unnecessary. However, the other three are all likely candidates when searching for an address. This is a problem as Waze only allows us to capture 1 entry under city.

Wazers have got round this problem by capturing the Suburb, City. So the above example would be Morningside, Johannesburg. This is the recommended method as just capturing the suburb can cause confusion with people who are not familiar with the area.

Please note that the old municipalities that were merged into the City of Johannesburg Metropolitan Municipality should /not/ be used as the city. That is, the suburb of Bryanston should have a city name of "Bryanston, Johannesburg", not "Bryanston, Sandton". The same applies for other metro areas that have undergone municipal consolidation.

Splitting a road

Splitting dual lane roads is not advised as this requires a lot of maintenance with turn restrictions at intersections. A split road will generally cause Waze to start recommending illegal U-Turns if it is not properly created. This includes routing onto an adjacent road, where a U-Turn will be suggested to get back onto the same road again, especially where traffic lights have longer than average waiting periods.

As it is not a simple task to un-split a road, be sure to refer to the sections on when to split or not split a 2-way road and when to unsplit a road. In general, unsplit is preferred; only split roads where it is actually necessary. In particular, please think twice (and post on the forums for good measure) before splitting an existing road; there is most likely a reason it is not split.

WME does not currently support the "Separating Lane" option that the retired Cartouche editor had.

Other Mappable Categories

Waze supports certain Landmarks that can be mapped. Not all types are useful, and Landmarks should be used sparingly.
Traffic Circles can also be created to generate proper instructions for negotiating roundabouts.

Traffic Circles / Roundabouts

If traffic circles are mapped just using normal street types, drivers will not get any special instructions. It is thus important to create them using the Roundabout tool. This way the driver will be notified to carry straight on, or take a specific exit number using an 'At the roundabout, ...' voice prompt.
The best way to create a roundabout is discussed in this section of the Wiki. When multiple different road types all connect to the roundabout, ensure that the proper road type is set to the highest common denominator for the roundabout road type.

Landmarks

Waze supports quite a number of different Landmark types. Adding Landmarks should be done sparingly, as they tend to clutter the map and not all of the landmarks serve any useful purpose.
Some of the landmarks have the ability to suppress traffic generation, like the 'Gas Station' or the 'Parking Lot' type. If Waze detects that you are within any of these landmarks, and you are stationary, it will not generate false 'Traffic Jam' information. It is thus important to ensure that these types of landmarks do not overlap or snap to any of the roads around them, as this will inhibit traffic report generation in these areas.

Tips for successful editing

Get acquainted with the basics. The Wiki is a reference for both new and experienced editors alike.

Always keep things as simple as possible. Do not draw all roads exactly as they appear. Dual laned roads causes a lot of complications and errors.

Before you connect or disconnect any roads to/from existing junctions, ensure that you verify the existing turn restrictions that are in place for all the connected segments.

Drawing two roads so that they touch, does not automatically mean Waze will route from the one to the other. To allow routing, make sure they form a new junction (round node) if you drag them together. A square geometry node is not a connection. To make your life easier, make sure you always override the "Enable all turns" after creating a junction. Highlight the junction and press 'Q' and then 'W'. This means you can then restrict just the turns that are not possible.

If you drag two segments together and they refuse to create a connection node, you can try connecting them by dragging one slightly past the other so they cross, and then selecting both segments using the 'Control+Left-Click' method. This would usually bring up the intersection popup where they overlap, allowing you to connect them if you click on it. Click on the extra piece sticking over, and delete that.

When mapping new areas, always verify turn restrictions after you have created all of the roads. For best results, zoom out to the 100m/500ft zoom level and press the 'Shift-Z' key. This will highlight any turns that are not allowed using the normal Red Arrows around junctions. You can then verify that the correct restrictions are in place by zooming back in to each of the locations where the arrows show up. If they should be allowed, you can select the junction and press the 'Q' and 'W' keys to allow turns. Pressing 'Shift-A' will toggle this functionality on and off.

When connecting roads, the 'soft turn restrictions' (not visible in the editor) will automatically allow all valid turns for the connectivity based on road directionality. The 'hard turn restrictions' (visible via the red & green arrows) will be set not to allow any turns to and from the newly connected segment. To ensure that soft turn restrictions do not cause routing problems later on, click on the connection node and press the 'Q' key to disallow all turns for soft and hard turn restrictions. You can then allow each individual turn for each segment by selecting the connected segments in turn. If all turns should be allowed for all directions, press the 'W' key while the junction node is still selected.

Do not add new segments into the middle of busy roads. Rather re-use and split a piece from an existing adjacent segment of the same road. This way the existing speed information and history is retained. Adding a new segment with no speed information or history could initially cause some weird routing if the segment goes live on the map. This might then persist until new history is built up for the newly added segment.

If you need to move two connected roads far from where they currently are, disconnect them from each other. To do this, click the road, then click and drag both of the junctions where they connect, away from the main junction. As roads cannot be moved with WME while retaining their geometry or layout, you would be better off deleting all the geometry nodes by hovering over them while holding the 'D' key down.

To select multiple roads, hold down the 'Control' key while click on the roads.

When looking at URs (User Reported problems) or Map Problems, always test existing routing on the Livemap if the problem involves invalid routing. If the problem is not evident, you can always ask for assistance in the Waze Forum. If you cannot work out what the problem is, it might be a small piece of a road underneath. Try moving some of the roads out the way to see if a latent piece of road was left cut off when a junction was added.

Some members of the Waze community has written a few helpful scripts that helps identifying problems. Use them to your advantage. A complete up to date list is available at Community_Plugins,_Extensions_and_Tools.

FAQ

A lot of Frequently Asked Questions are already covered in the current editing FAQ.

Glossary

The Glossary explains some of the abbreviations and terminology used in the Waze world.

Waze User Manuals

The currently supported version of Waze is v3.5. Version 3.5 is unfortunately only supported on Android Smartphones and Tablets and on iPhone and iPad devices. Here is the Generic v3.5 User Manual.
For users with other smartphones or older versions of Waze, the v2 and v3.2.2 user manuals are listed below. Even though not all of the latest functionality is supported, it will help you understand the functionality provided by the client interface.