Module 01

The South Africa Waze Map Editor Guide Blueprint

Your foundations and core philosophy before moving pixels. Understand why precise mapping matters for local South Africa routes, emergency services, and community coordination.

Why It Matters (The Real-World Impact)

Waze isn't a video game; it impacts real South Africans daily. Precise layouts can change commute times and ensure emergency paths are optimized for first responders.

Emergency Services

Accurate routing past informal settlements or gated estates saves critical seconds for ambulances.

The School Run

Optimizing neighborhood routing vs. major arterial avenues manages heavy peak traffic gridlock.

The Cost of Commuting

Properly flagged traditional toll plazas and gravel corridors protects vehicles from heavy wear-and-tear.

Case Study: The Gated Estate Trap

Leaving a resident-only back gate open triggers Waze to mistakenly guide delivery fleets into secured perimeters like Dainfern or Sandton estates, creating security and logistical nightmares.

How Not to Break South Africa

The main reason new volunteers quit is the fear of making mistakes. Everyone breaks a link eventually—what matters is managing it smartly and learning quickly.

  • The Guardian Mindset: Focus on maintenance and learning, not aggressive new road creation.
  • The Golden Rule: Never connect non-drivable paths (residential alleys, foot paths) to major arterial routes.
  • Red Means Stop: Red lines indicate unconfirmed roads—always verify before editing.

The Investigation Framework

Investigate thoroughly before applying changes. Understand the map routing logic before modifying segments.

GPS Tracks: Review active GPS track vectors to see actual vehicle coordinates.
LiveMap: Test how the standard routing algorithms behave on that specific junction.
Street View: Cross-check actual lane signage, turns, and structures.
Community Chat: Discuss odd layouts with nearby area coordinators on Slack.
The Edit: Commit changes to the map once your gathered evidence matches.

South African Road Hierarchy Rules

Roads are categorized based on function and traffic flow rather than legal classifications alone.

Road Type Functional Role Sign/Prefix WME Editor Rule
Freeway Controlled-access layout. No driveways or intersections. Pentagon (N1-N18), R/M routes Must be mapped as two distinct 1-way lines.
Major Highway Arterials connecting commercial nodes; may feature intersections. Diamond (R21-R99), Primary N Connects directly at-grade.
Minor Highway Regional intersections, often single lanes. Rectangle (R100-R727) Controlled via stop controls/signals.
Primary Street Major central neighborhood roads (e.g., Jan Smuts Ave). N/A Fastest structural route option.
Street Standard paved suburban paths. N/A Standard local street properties.

Community & Support Ecosystem

Map curation is built around teamwork. The South African editing community prioritizes coordination channels over text forums for fast collaboration.

Intellectual Property Boundaries

Never copy layouts or details from Google Maps or Google aerial photography. It violates map copyright terms and causes misalignment issues. Use official satellite layers or street-level verification only.

Module 02

Wazeopedia South Africa: Reference Guide

Practical documentation on properties, interface layouts, speed limits, and advanced editing patterns across local provinces.

Welcome & Getting Started

The core map framework is built by everyday drivers. Every tracking trip helps refine real-time speeds, and direct edits ensure roads stay accurate and trusted.

The Golden Rule of Map Editing

Usability Fast, accurate engine choices
Simplicity Clean, readable layouts
Retention Keep roads to save historic data

Editable Areas & Ranks

Your editing perimeter matches the sectors you have driven along recently with Waze running, expiring after 90 days of inactivity in that zone.

Safe Moves for Beginners

  • Fixing minor name spelling typos
  • Changing road directions (one-way/two-way)
  • Setting allowed intersection turns

Avoid on Day 1

  • Deleting roads (wipes out speed history)
  • Mapping every single shopping center lane
  • Editing segments locked above your rank

WME Shortcuts Reference

Toggle editing panels and features using these standard keyboard shortcuts:

General Controls

Show Shortcuts?
Save ChangesCtrl + S
Draw RoadI

Segment Adjustments

Toggle DirectionR
Delete Geometry NodeD
Select Entire StreetCtrl + A

Junction Turn Control

Disallow All TurnsQ
Allow All TurnsW
Show Disallowed TurnsShift + Z

SA Naming Standards & Speed Limits

The Suffix Rule

Always use standard capitalized English abbreviations for street suffixes so text-to-speech works perfectly:

Elizabeth AveCorrect
Elizabeth AvenueIncorrect
Main RdCorrect
Main rdIncorrect

Typical Speed Limits Profile

Type Standard Limit Type Standard Limit
Freeway 120 km/h Primary Street 60 or 80 km/h
Major Highway 100 or 120 km/h Standard Street 40 km/h

Suburb Assignment Rule

Always follow the "Suburb, City" pattern in the address field to keep alerts clean (e.g., "Morningside, Sandton" not "Sandton" alone).

Creating & Editing Roads

Every active segment must have accurate geometry, direction, properties, and turn restrictions before being uploaded to live servers.

Important Sequence for Junction Creation:

To clear hidden, soft turn restrictions that can break route choices, always follow this order: Select Junction Node → Press Q (disallow all) → Then enable specific legal turns.

Elevation Matrix Rules

Manage elevation heights carefully to avoid overlap errors on underpasses or bridges:

0Ground Level
+1 / +2Overpass Bridges
-1 / -2Tunnels / Underpasses
-5Non-drivable tracks

Locking Levels, Places, & Toll Roads

Lock properties protect confirmed layouts from accidental edits by newer accounts.

Road Lock Level Baseline

  • Freeways (N-routes)Level 5
  • Major Highways (Rxx)Level 4
  • Minor Highways (Rxxx)Level 3
  • Primary StreetsLevel 2
  • Standard StreetsLevel 1

Toll Roads Rules

Drivers can choose to bypass tolls via app preferences. Only select the 'Toll Road' property checkbox when the segment collects actual toll revenue.

Major Operators: SANRAL (National Routes), Bakwena (N1/N4 North), N3TC (KZN Corridors), TRAC (N4 East corridor).

Edits to Avoid

Unnecessary Splitting

Do not split standard two-way roads into distinct one-way lines unless they feature a wide, physical structural meridian divider.

Private Farm Paths

Avoid drawing isolated rural property lanes or extreme 4x4 courses. If mapped, verify the Unpaved checkbox property is turned on.

Renaming Updates

When roads are officially renamed, change the primary field to the new designation and move the old name to the Alternate Name field.