This new page is currently undergoing modifications. The information presented should be considered a draft, not yet ready for use. This content is open to changes from anyone during construction. If you would like to make changes or have questions, please send a private message to this user.

Common errors: Improve your skills!

Introduction

Welcome to this Wiki page. You probably got the advice from another editor to read this page, or a specific part of this page. This advice is given to increase the quality of your edits. The edits for which you were referenced might have been deleted or adjusted in the mean while. This might be unhandy, because you miss a specific example. However, realize that the main goal of this advice is to improve your editing skills. If there is no specific subject why you are reading this Wiki page, just consume the information and when you need it, come back to the specific section of your need. Do not try to understand this whole Wiki page with all the details in once, for it might be overwhelming.

You are not the only editor who makes mistakes. All editors made mistakes and also all, now and then, still do. That's the way most people learn. And most of the times it are not even mistakes. The editing guidelines have developed over several years. So, something that was according to the regulations a year ago, might today be ready for improvement.

This Wiki page is not supposed to be a full manual of how to edit the Waze Map. It is an overview of subjects that are often confusing for starting editors, because they did not know the guidelines yet and their own logic tells them differently. This is not strange, because many of the guidelines have changed over the years and if you don't know the history, you don't always see the logic. All (starting) editors had this issue. And because guidelines are still changing and will keep changing, this will also happen to more experienced editors. In addition, the technical working of Waze changes often.

On this Wiki page, we have tried to combine technical knowledge of Waze with the users guidelines in the BeNeLux. To keep duplicate texts to a minimum, we also reference to other Wiki pages.

The best advice we can give to starting editors is to just start and make use of the community. Things will become clear in the process of learning. If something is unclear to you, first try to find it in one of the Wiki pages {overzicht van wiki pagina's, nog te maken}. If you can't find it, [ask your community]; Other editors are very willing to help. While reading the information in the Wiki or getting it from other editors, please keep in mind that, like in real live, also in Waze it is not always black and white. That is why we say we don't have rules or regulations, but guidelines. You may receive several opinions from two experienced editors and both can be correct, although a different interpretation. In addition, exceptions to guidelines are always possible and no problem, provided you have good arguments.

Waze is not a map, but a navigation system

The most made mistakes are because of the overall principle, this is 'Waze is not a topographic map, but a navigation tool'. Many starting editors try to make the map in Waze an exact copy of the actual situation. Roads are split, add pedestrian boarding walks and cycle paths, draw perfect rounded corners and area places are exactly drawn. The actual goal of Waze is to get the best instructions. The less detail on the map, the easier and faster a map can be interpreted, during driving. Especially on small smartphone screens.

An other reason to keep the detail as low as possible is speed. The less details the less bandwidth the downloading of the map requires. Also the less junctions there are, the faster the route calculation is. The number of junctions that Waze handle in one route is limited. So keeping the number of junctions as low as possible, the longer a route can become.

To help you Waze has created a number guidelines. That is what this page is about.

Editing mistakes are inevitable

Everybody, without the need of any prior knowledge or practice, can start editing the Waze map. Therefore, Waze accepts the risk that users make edits that seems logical to them, but lead to undesired results. The Waze community is enthousiastic and active, so the mistake will quickly be noticed. A more experienced editor will contact you to correct the mistake or do the correction himself. It is not meant as criticism, but an encouragement to learn more about editing.

Mistakes are often the result of a misunderstood or unknown guideline, or a lack of technical knowledge. In fact, there is only one true "mistake" you can make, which is withholding from communication with other editors.

Make sure that other editors can contact you

The only true mistake you can make as an editor, is being unreachable to other editors. If editors remark your edits with an undesired result, or if they don't understand the reason why you made this edit, they will try to contact you. They want to increase the quality of the map and meanwhile help you to become a better editor. If other editors cannot reach you, they cannot help you! Moreover, they will probably change your edits according to their own interpretation of the situation.

Therefore, make sure that you can receive e-mails from Waze by providing a valid mail address. Ccheck your mailbox regularly. Also check whether e-mails from Waze are not delivered to your spam- or junkfolder. You might want to make a filter to move the e-mails from Waze to a specific folder, or even create a separate mailbox for Waze. If needed, Adjust your Waze settings.

Communication

How can I contact Waze? Where can I find more information? Where can I post my questions. The local champs are responsible of the goings of your local community. Please contact one of more of them for questions or assistance.

Forum

The forum of your own country is a good starting point for finding more information. You can meet other editors. Read the latest information. Learn from questions of other editors. Or ask a question yourself. You can login using your standard login and password of Waze, which you also use in the app and the editor. In the forum you can also make use Private Messages (PM), this is a kind of inbox, like your e-mail. When you receive a PM you will also receive a regular e-mail to inform you. Also if you have installed the 'WME toolbox' you get a message in the editor of new PM's. How you can handle your PM's you can read here.

Chat

When you are editing you can directly request help in WME chat. When asking for help you can see the level of the colleague you are talking to. Please keep in mind that most editors are willing to help, but not all of them have the technical knowledge or editing experience to give you the best answer. Besides the Chat, which does not work always as desired, we also have Hangouts and Slack. Most editors, especially the higher level ones, have an account on both Hangouts and Slack.

Hangouts

For Hangouts you need a Google account and install the extension in Chrome and/or an app on your smart phone or tablet. Hangouts works with groups and also you can contact users individually. For Waze Benelux several groups are available. There is one per country and one per area (Provence) of the tree countries. If you want to be added in one of the groups send your Google account to your mentor or another L4+ editor.

Slack

If you want to use Slack your first need to request an account on slack.com and them when you logged in type '-invite wazebenelux' and you should receive a link to proceed. In Slack there are Channels, Direct Messages (DM) and Private groups. The channels are split up by subject, please try to use the correct Channel for your question or remark.

Wiki

A lot of information is available in the Wiki of your country. There is one Wiki for the Benelux, of course representing the countries Belgium, Luxembourg and the Netherlands. At the moment a group of people is bringing the Benelux Wiki up-to-date again. The Wiki can be maintained by everybody. Because the are guidelines applying to the whole of the Benelux changes need to be approved in the forum by one of the local champs. In this forum everybody can also do suggestions for new/adjusted guidelines or textual improvements.

At the bottom of each page you can see the date the page is updated. If this is longer than half a year ago please take into consideration that the information is outdated. So if you have seen newer guidelines or technical information in one of the other communication channels, assume that that is more up-to-date. When a Wiki page is available in an other language you can select that at the top of the page. Please keep in mind that the pages are maintained per language. So it is possible that the information is not exactly the same. Also an other language can be older or newer.

A good start with the Wiki is the Benelux Beginnersgids.

ga terug naar de Inhoudsopgave

The principles of Waze

Many misunderstandings have their origin in the fact that the fundamental principles of Waze are not clear. Waze is developed for motor vehicles and should not be used for other means of transport, like pedestrians, pedal cyclists, public transport or taxi's. you should also not use it for personal favourite places, historic railways and illegal shortcuts.

User friendliness

Waze offers drivers a navigation system based on a map that is easily to see on a small screen. Supported with clear and understandable verbal instructions at the moments it is needed.

Simplicity

A lot of things are not added to the map, because we want the map to be as simple and efficient as possible. Unless a object contributes to the navigation as a landmark, it should not be added. Only roads where you can drive with a normal car should be added to the map. When you want to be able to navigate easily to a place (e.g. a supermarket) you can add it as a point place. This way it won't be visible, but you can navigate to it, without knowing the address. Adding too much objects make the map less easier to read and also increase the workload of maintaining the map. If you are not sure whether to add a specific object, please contact the area or region manager.

Cautious

All segments contain information that is used to calculate the optimal route, like average historic speed or average delay at a junction. When you are deleting that segment, you will also delete this information. So be cautious with that. You can better adjust existing segment, then delete the old one and create a new one.

An other reason to be cautious with deleting segments is that an other editor had a reason to add it. And when he or she sees that the segment is removed again without getting a notice that can be demotivating. Everybody can make a mistake or guidelines could have been changed over time. Therefore it is better to consult the editor who added the segment then to change the segment yourself.

go back to the table of content

Locked segments

To protect the map segments have a lock level based on the importance of the road. These roads can only be edited by very experienced editors. Connecting roads and high volume roads have a higher lock level then streets. Most editing options are not available, but when you succeed to edit such a segment you can't save your changes. When you try to connect a segment to a road with a higher lock level you will get an not connected segment.

When you want to make an edit on a segment with a higher lock level, you can request a temporary decrease of the lock level. You can ask this to your area or region manager or the last editor via a Direct or Personal message via one of the Communication methods we have. Please provide a permalink where you have selected all segments where you are requesting the temporary decrease for. You van also post this request in this forum. Before you do please read first this topic.

Common functional mistakes

Incorrect or incomplete data can have a negative effect on the navigation or make it even impossible to navigate to a specific location. We call these functional mistakes and they should be corrected as soon as possible. Functional mistakes are, if noticed by an other editor, often directly corrected, because of the great impact.

Red roads

When a road does not have a city- or street name it will be red in the WME and it won't be drawn on the map or used for navigation. These roads can originate from

Paving roads, who have not been confirmed in the WME.
an editor added a road, but forgot to give it a name.

You fill in these two names by selecting the segment or segments and click 'Edit' on the top left of the screen. If you don't know the name of the street and/or city name check None.

Never delete a segment without first consult the editor who added it. If you think the segment is an improvement to the map, fill in the missing data. Also check the junction arrows, because when an editor has forgotten to fill in the name, most of the time the junction arrows are also not set correctly.

Here you can find more information: Create a road.

Junction Arrows (JA)

Junction arrows used to be called Turn Restrictions. Junction Arrows are the red, green en orange arrows when you select a segment and they control which turns are allowed. Green is allowed, red is not allowed and orange is partial restricted, based on time. You can limit based on type of vehicle, but that does not work in the route calculation.

**Incorrect:** An editor forget to correct the junction arrows. Once you drive on the selected segment Waze does not know which instruction to give.

When you change the driving direction of a segment always also check the junction arrows. The WME does not adjust them automatically based on the driving direction. The quickest way to correct hem is to select the junction and press q and w or click on the button 'Allow all turns'. While creating a new road by default all TR's are red. In the advanced settings of the editor check the option 'Draw new roads with all turns allowed'. If you select this option, it is advised to also check the option 'Draw new roads as two-way'.

An easy way to check incorrect red junction arrows is Ctrl-Z. This will show all the red arrows in the area on your screen, also for the not selected segments. Of course these are not all incorrect, but you can check them. It is advised to before you do the correction, you press Ctrl-Z again and select the segment with the red arrow. Otherwise you can not see which segment has the red arrow.

go back to the table of content

Disconnected segments

Just because segments appear to intersect on your display, they sometimes do not for real. The fasted way to check this, is to select one of the segments. When you don't see the Junction Arrow(s) light up, it is not connected.

No visible arrows, thus not connected. The selected road will be handled as a dead-end road.

You see the arrows, thus the roads are connected.

When a road should be connected, please check the Junction Arrows. If it is not connected, move the end node away from where it should connect, and drop it somewhere else. Than pick it up again and drag it to where you want the junction to be. WME now automatically creates a junction. Again, check the Junction Arrows.

If you cannot connect a segment using the above described method, one of the segments could have a lock level higher than your editing level. In that case you cannot solve this functional mistake yourself and you might want to ask for an unlock. If the segment is a pedestrian boardwalk, check whether this segment should be connected anyway on the Benelux Pedestrian Boardwalks page. More information is to be found on connecting roads.

go back to the table of content

Incorrect use of roundabouts

When approaching a roundabout specific instructions are given. For a standard roundabout (4 exits) the instruction is 'Turn left at the roundabout'. For other roundabouts the instruction will be 'Take the third exit at the roundabout'. If these instructions are not correct for the situation, please don't use a roundabout. A dead-end street should not have a roundabout at the end. If there is no road sign for a roundabout don't use a roundabout. This will give incorrect instructions, where a driver thinks he is approaching a roundabout, when this is not the case. for more information about how to create a roundabout see Quick Start Guide.

go back to the table of content

ToDo: Translate into English

Private access roads that distort routing

Many new editors enthusiastic start mapping all small streets, alleys, driveways, parking lot roads, etcetera. They think if you can drive on it, you can map it. But this can have some negative effects. Of course it means a lot of extra data (bandwidth) and extra calculations. Also it can make the map less clear on small screens. But the biggest disadvantage is that is can distort the routing.

The way Waze works is that is it finds your destination based on GPS coordinates. In a lot of cases from Google. Based on those coordinates it pins your destination. Then it looks for the closed drive-able road, without looking at the name of that road. So that means if the driveway of the rear neighbors is closer to the pin of your destination then you will be lead to the wrong road. And when this is a long road, it can be far of from your actual destination.

**An access road that will distort routing.**

go back to the table of content

Too much or incorrect geometry nodes

This section is moved to the heading 'Too_much_geometry_nodes'.

Local agreements

The relation between the satelite view and map

The Waze map should not be an exact copy of the satelite view. The Waze map should be as simple as possible, so that the navigation instructions are correct and the map should be easy to read while driving. Almost everybody tends to make the map an accurate copy of the satelite view, this is not what you should do. This means even that sometimes roads or parts of roads are not drawn or different then in the satelite view. An other pitfall with the satelite view is that they can be outdated. Also you can't see everything from above. For example a road in the woods is probably not vissible on the satelite view. Use the satelite view as a source, but not a a goal to copy. In case the road is mapped different then the view consult the previous editor or the area manager.

Too much geometry nodes

Too much geometry points can slow down the build of your screen and also it makes a segment harder to maintain. For those reasons we use as less nodes as possible. Even if that means that a road in Waze does not exactly follow the road in the satelite view. When you see that a segment had too much nodes, please remove them by hoover with your mouse over the nodes and press 'd'.

Too much geometry nodes (13 nodes)
This is efficiënt (3 nodes)

Too much geometry nodes
This give excelent navigation instructions
If you prefer rounded corners you can use this as the intermediate solution

For more information see Create a road.

Simplify a cross section

**The actual situation of the cross section.** When you draw in this example the roads exactly as the actual situation you will lots of segments and junctions. Which result in a lot of maintenance. Also the driver will get lots of navigation instructions, where one instruction, e.g. turn left, should be sufficient and much clearer.

More examples of drawing complex situations can be found in Advanced guide.

go back to the table of content

Type of roads

Choosing the correct type of road is quit important in Waze. Because navigation is highly depending of the road type. Therefore be very careful with changing the type of a road. For example when you change a segment from street to parking lot road (PLR) it can result in drivers needed to drive X extra kilometers, because a PLR has a high penalty. This is done because you don't that drivers use a parking lot as a shortcut to avoid a small traffic jam. Changing the type into PLR is only an example, almost for all types there can be a big influence. If the segment of which you want to change the type of road is last edited by an editor with a higher level then yours, always first consult this editor.

When you have set your language in the editor to something else then the local language, please be careful with translations. Some can't be translated, because the exact type of road does not exist or it can be used for something completely different. Therefore check this page and set the language to the local language of the country you are editing in.

Freeway / Highway

This is a typical translation issue as menthioned above. Freeway, major highway and minor highway are all translated as 'snelweg' into Dutch. But all tree are used for different types of roads in the Benelux. Therefore check this Benelux page about road types. This guideline is the base, but the actual determination of the type should be done by functional classication. The means that the road type is depending on the amount of traffic the road can handle in relation to the alternatives. Which can result in a small road typed as minor highway and a bussy road in a city as a major highway.

Pedestrian boardwalks and cycle paths

In general both Pedestrian boardwalks and cycle paths should not be added to the map of Waze, because Waze should only be used by motorvehicles. There are some exceptions and they are explained in Wiki non-drivable roads. One of the exceptions is when a non-drivable roads are addeding a value as a landmark. In that case the PB is set to driving direction unknown and not connected to any drivalble road. In the Benelux Walking trails are not used for walking path, but for public transport, like train rails.

Parking Lots

Also parking lots should be drawn as simple as possible with the aim at good navigation instructions. There is not value added to draw every lane on a parking lot and with the inaccruarcy of GPS Waze probably does not know on which lane you are exactly, resulting in wrong instructions. Roads on parking lots have no name, excepts when the road has a housenumber of an official address that can not be linked to regular street.

See Parking Lot Roads for more information.

Splitting up roads

The general rule for splitting up roads into one segment per driving direction that it should only be done when needed for navigion. The fact that road is physically split is of no influence. With Junction arrows you can make sure that physically impossible turns are not advised. Splitting an existing road should only be done after consulting the area or region manager. Be aware that unsplitting a road costs the same amout of work as splitting it.

Update requests (UR)

During driving a driver can report an update request, when he sees something that is not correct or when he gets navigation instructions that are not allowed. Because this is done during driving most drivers don't have the time to fully descripe the issue. That why there is a way to start a conversation in the UR. When an editor picks up a UR he should take this seriously. Never just close a UR, even if you know it is bogus. There is an international UR Etiquette you can follow. In short this says the following.

start a conversation. Be aware that the reporter probably is not an editor.

Start with thanking the reporter for reporting the issue.
If the report is clear and you can solve this issue directly, please do and explain to the reporter what you have done. The reporter receive a message of this and feels taken seriourly. Therefore he will probably do an other report, next time. Also other editors can learn from it and sometimes it can also apply to other issues in the neigborhood. You can close the UR as solved.
When the issue is not clear ask polite the reporter for more information.
Offially there is no owner of an UR, but don't close or take over the handling of an UR, without consulting the editor that started the conversation with the reporter.
It can happen that reporter does not respond to the request for providing more informarion. In that case you can send a reminder after 5 days. You will see that some reporters only respond after one reminder.
When the reporter also has not responded to your reminder after 2 days, you can make a comment in the conversation and close the UR as unidentified.

Samples of reaction you can find in the script WME UR Dutch Comments.

Wat kan ik wel bewerken?

Overal waar je hebt gereden mag je editen. In zwaar bevolkte gebieden zullen er veel editors zijn en kun je er vanuit gaan dat de kaart al op behoorlijk niveau is. Je kunt er misschien overtollige geometriepunten verwijderen, kleine afwijkingen corrigeren en afslaginstructies controleren. Als je andere dingen wil editen, dan kun je je energie het beste richten op de minder drukke gebieden. In afgelegen gebieden is vaak weinig aandacht geweest voor verbetering van de kaart sinds de oorspronkelijke basis- import. Je ziet er vaak een overvloed aan wegen zonder naam, onverharde wegen die ten onrechte ingesteld zijn als gewone straat, onbekende rijrichting etc.. Door ook deze gebieden op een hoger niveau te krijgen wordt Waze steeds betrouwbaarder.

Mocht je toch in een zwaar bewerkt gebied gaan editen, wees je er dan van bewust dat er zich al veel editors hebben bezig gehouden met de kaart. Dingen die misschien op het eerste gezicht niet juist lijken, kunnen bewust zo zijn ingetekend, na zorgvuldige overweging van de basisprincipes en werking van Waze. Wees voorzichtig met het wijzigen van het werk van andere editors. Vraag liever even na of jouw idee klopt (via het forum, chat of een PM aan de laatste editor).

Constructieve werkzaamheden voor startende editors

Lees de Quick-Start!
Controleer de straatnamen op spelling en afkorting. Kijk of stadsnamen consistent zijn binnen de grenzen van de gemeenten. Gebruik daarvoor de beschikbare gegevens van bronnen die gebruikte mogen worden.

ToDo: toevoegen link voor meer info

Controleer de rijrichting van de wegen, mbv streetview en beschikbare bronnen. Bedenkt wel, indien er recente edits hebben plaatsgevonden, kan het zijn dat de gegevens in Waze nieuwer zijn dan bijv. streetview.
Controleer de afslaginstructies. Tip: gebruik ⇧ Shift+z hiervoor.
Voeg recent aangelegde wegen toe die nog niet staan aangegeven op de kaarten, zoals een nieuwe wijk. Lees eerst meer over een straat aanleggen
Informeer Area Managers en/of senior editors over problemen.
Controleer toegevoegde Plaatsen in jouw omgeving; is de juiste categorie toegewezen, klopt de naam en locatie etc.. Controleer ook of het een Area of Punt moet zijn.
Hou de wegwerkzaamheden in de buurt bij. Hoe je deze kunt verwerken lees je in het forumtopic mogelijkheden voor afsluitingen.
Help mee om de Wiki begrijpelijk en up to date te houden. Zie het forum.
Help mee met het vertalen van Waze teksten. Een uitleg staat in de Benelux Wiki Guide. Meld je graag ook aan in het forum en/of bij Slack©, waar we een apart onderdeel voor Wiki-Benelux hebben. Daar bespreken we altijd eerst de voorgestelde wijzigingen.

Risicovolle werkzaamheden voor startende editors

Tenzij je samenwerkt met een ervaren editor, wees dan terughoudend met de volgende activiteiten:

Verwijder geen straten of delen van straten zonder overleg. Dit verwijdert namelijk ook de verkeersinformatie die daar bij hoort.
Verander geen wegen die aangesloten zijn op vergrendelde segmenten.
Geen wegen splitsen, al zijn het in het echt meer rijstroken.
Voeg geen niet-berijdbare wegen toe, zoals wandel- en fietspaden, spoorwegen, start- en landingsbanen, busbanen, etc.. Het lijkt misschien onschuldig, maar door de manier waarop Waze ze implementeert kunnen ze de navigatie negatief beïnvloeden en zelfs voor verkeerde routes zorgen.
Verander nooit het wegtype, zoals Minor Highway, en Major Highway. Ook dit beïnvloedt de navigatie sterk. Zie Misverstand mbt het wegtype "snelweg" voor meer informatie.
Vermijd het toevoegen van wegen op (risico op overdrijven waardoor de kaart onduidelijk wordt, op het verstoren van de routing naar nabijgelegen bestemmingen, het creëren van foutieve afslaginstructies, of de kans op niet aangesloten segmenten).

ToDo: toevoegen info parkeerplaatsen

Verander geen grote kruispunten, opritten of snelwegen (waarbij je zeer waarschijnlijk vergrendelde segmenten zult tegenkomen). Er is een groot risico op verstoring van belangrijke doorgaande routes.
Het bewerken of zomaar sluiten van de door gebruikers gemelde kaartproblemen (Update Requests-URs). Dit vereist uitgebreide kennis van de UR etiquette en van de (on)mogelijkheden van Waze. Je kunt uiteraard wel suggesties geven in de conversatie.

ga terug naar de Inhoudsopgave

Dank voor je aandacht!