wiki:Help/Preferences/Validator

Version 48 (modified by skyper, 4 years ago) ( diff )

add TOC and more (advanced) preferences

This page is incomplete. Lot's of tests not described.

Preferences > Data Validator

source:trunk/resources/images/preferences/validator.svg

An OSM data validator that checks for common errors made by users and editor programs.

Following four general settings are available:

Use ignore list
enable/disable the use of the ignore list (default: enabled)
Advance preference: validator.ignore
Use error layer
enable/disable the creation of a validator layer highlighting the problematic objects (default: enabled)
Advance preference: validator.layer
Show informational level
enable/disable tests on informational level know as "Other" (default: disabled)
Advance preference: validator.other
Show informational level on upload
enable/disable tests on informational level on upload (default: disabled)
Advance preference: validator.otherUpload

All check boxes below are settings which test should be run on which action with a check box on the left for manual runs, On demand, and On upload on the right side.

Tests

By default, all error and warning tests are active.

https://github.com/mapbox/mapping/wiki/Reviewing-your-edits#customizing-error-detection https://github.com/mapbox/mapping/issues/162

  1. If you are a OSM newbie and encountered validation error about objects you haven't touched, please ignore these messages for now.
  2. Validator can be wrong or incomplete about all tagging practices. Don't fix errors when you aren't sure something is really wrong.
  3. First, refer to Validator panel - how to use validator

The fourth column contains also (video) explanations. The table is incomplete.

Type Message What is checked Additional help Autofix
Addresses errors in Addresses and Relation:associatedStreet.

Advanced preferences:
validator.addresses.max_duplicate_distance (default: 200.0)
validator.addresses.max_street_distance (default: 200.0)
source:trunk/resources/images/data/warning.svg House number without street objects that have an addr:housenumber tag, but neither addr:street nor addr:place. The street name can also be provided using an associatedStreet relation or on interpolation way. Add the missing street name information. no
source:trunk/resources/images/data/warning.svg Duplicate house numbers two members of an associatedStreet relation have the identical house number. It is possible with a low chance. no
source:trunk/resources/images/data/warning.svg Multiple street names in relation name tag of an associatedStreet relation matches the name tags of the members with role street and the addr:street tag of the members with role house. no
source:trunk/resources/images/data/warning.svg House number too far from street the houses of an associatedStreet are far away from the corresponding street. Verify that the house really belongs the the street that is given by the relation. no
source:trunk/resources/images/data/warning.svg Multiple associatedStreet relations an object is in more than one associatedStreet relation. no
Barriers and entrances errors in Barriers and Key:entrance.
Coastlines Coastline are correct.
source:trunk/resources/images/data/error.svg Reversed coastline: land not on left side coastlines that are not counter-clockwise or that are otherwise misplaced (coastline misused as inland lake) Reverse coastline
source:trunk/resources/images/data/error.svg Unconnected coastline: coastline ways do not form closed loops coastlines ways that are not connected to the end of other coastline ways
source:trunk/resources/images/data/error.svg Unordered coastline: coastline ways are not connected start-to-end coastline ways of which either the start is not connected to the end of another coastline or the end is not connected to the start of another coastline Reverse coastline
Conditional Keys usage of *:conditional tags. Imprecise rules covered at osm wiki page "Conditional restrictions"
Crossing barriers / boundaries / ways
source:trunk/resources/images/data/warning.svg Crossing ways ways (with highway/railway/waterway tags) that cross in same layer with no crossing node 1. (video) usually you need to add a common node or
2. add appropriate Key:layer (and possibly Key:bridge or Key:tunnel)
no
source:trunk/resources/images/data/warning.svg Crossing barrier/building barrier crossing a building in same layer with no crossing node no
Duplicated nodes Advanced preference:
validator.duplicatenodes.precision (default: 0.0)
source:trunk/resources/images/data/error.svg Duplicated nodes no nodes in the very same location Merge the nodes into only one, adding the properties from all nodes to the merged one
Duplicated relations no relations with same tags and same members with same roles.
Duplicated ways no ways with same node coordinates and optionally also same tags.
Duplicated way nodes ways with identical consecutive nodes.
source:trunk/resources/images/data/error.svg Duplicated way nodes ways contain no loop edges (i.e., a single step from a node to itself) Split the way, and delete the way consisting of the loop edge.
Highways semantic checks on highways.
Lane tags lanes:* tags, see Lanes
Tag checker (MapCSS based) different kind of checks based on MapCSS, including external rules. See Tag checker rules tab and detailed description below.
Multipolygon multipolygons are valid.
source:trunk/resources/images/data/warning.svg Style for outer way mismatches Within a multipolygon relation, one of the tags of the relation and the outer ways is shared but with different values Copy relation related tags to the relation itself
source:trunk/resources/images/data/warning.svg Style for inner way equals multipolygon Within a multipolygon relation, one of the tags of the relation and the inner ways is shared and has the same value Remove tag from inner way
source:trunk/resources/images/data/other.svg No style in multipolygon relation The multipolygon relation is missing a tag describing what it represents For a building, add building=yes to the relation etc.
Missing name:* translation finds multilingual objects whose name attribute is not equal to some name:* attribute and not a composition of name:* attributes, e.g., Italia - Italien - Italy.
Opening hours syntax correct usage of the opening hours syntax.

Preference:
Strict mode: validator.OpeningHourTest.strict (default: false)
common OH examples common mistakes complete OH spec
Overlapping ways a connection between two nodes is not used by more than one way. (video) Using selection, split and middle mouse
source:trunk/resources/images/data/warning.svg Overlapping (high)ways two (high) ways that share the same nodes
Power lines nodes in power lines that do not have a power=tower/pole tag.
Relation checker errors in relations.
Almost right angle buildings buildings with an almost right angle.

Advanced preferences:
validator.RightAngleBuilding.maximumDelta (default: 10.0)
validator.RightAngleBuilding.minimumDelta (default: 1.0)
source:trunk/resources/images/data/other.svg Building with an almost square angle If the angle should be a right angle, orthogonalize the way. yes, #20038
Self-intersecting ways ways that contain some of their nodes more than once.
source:trunk/resources/images/data/warning.svg Self-intersecting ways a way crosses itself Remove the self-crossing, remove overlapping parts or split way
Similarly named ways ways with similar names that may have been misspelled.
source:trunk/resources/images/data/warning.svg Similar named ways ways with very similar names, possibly a typo
Tag checker errors in tag keys and values.
Check property values misspelled property values. Uses the loaded tagging presets files for checking
source:trunk/resources/images/data/other.svg Presets do not contain property key the property key is in no preset Check the key or
Load the preset
no
source:trunk/resources/images/data/other.svg Presets do not contain property value the property value is in no preset Check the value or
Load the preset
no
Check for fixme. any property with the word "fixme" inside
source:trunk/resources/images/data/other.svg fixme Check if you can fix the issue or if it was fixed already. If so, remove the "fixme", otherwise do nothing. no
Turn-restrictions turn-restrictions are valid.
source:trunk/resources/images/data/error.svg No "from" way found
No "to" way found
No "via" node or way found
all necessary elements of a turn restriction relation are present. no
source:trunk/resources/images/data/error.svg More than one "from" way found
More than one "to" way found
More than one "via" node found
at most one way with role from and to and at most one node with role via in a turn restriction relation. no
source:trunk/resources/images/data/error.svg Cannot mix node and way for role "via" there is either a "via" node or multiple "via" ways, but not a mix of nodes and ways with role via. no
source:trunk/resources/images/data/error.svg The "from" way does not start or end at a "via" node.
The "to" way does not start or end at a "via" node.
The "from" and the first "via" way are not connected.
The "via" ways are not connected.
The last "via" and the "to" way are not connected.
the different parts of a turn restriction relation are connected. is also aware of oneway streets and considers parts unconnected, if they cannot be traveled in the intended order due to the oneway restriction. Make sure that consecutive member of a turn restriction relation are connected. (Ways must be connected end-to-end.) no
source:trunk/resources/images/data/warning.svg Unknown role the role for members of a turn restriction relation is either from, to (ways) or via (nodes and ways) no
source:trunk/resources/images/data/warning.svg Unknown member type only nodes and ways (and not relations) are members of a turn restriction relation. no
source:trunk/resources/images/data/warning.svg Superfluous turn-restriction as "to" way is oneway The turn restriction is not needed, because the corresponding turn would mean to enter a oneway street from the wrong side. Verify that the "from" and "to" ways are correctly assigned and delete the relation if it is indeed superfluous.
Unclosed Ways ways which should be circular are closed.
source:trunk/resources/images/data/warning.svg Unclosed ways way types, which should be closed really are closed Close unclosed ways no
Unconnected highways / natural lands and landuses / power ways / railways / waterways a way has an endpoint very near to another way.

Advanced preferences:
validator.UnconnectedWays.node_way_distance (default: 10.0)
validator.UnconnectedWays.way_way_distance (default: 0.0)
source:trunk/resources/images/data/warning.svg Way end node near other highway End point of a way is very near to other ways Connect the ways or when really unconnected set a 'noexit' tag to prevent further warnings no
Untagged and unconnected nodes untagged nodes that are not part of any way.
source:trunk/resources/images/data/warning.svg Unconnected nodes without physical tags untagged nodes that are not part of any way 1. If it is yours node, you are to decide if to remove it otherwise
2. Download parent relations and contact mappers who added these nodes in unclear cases
Untagged, empty and one node ways untagged, empty and one node ways.
source:trunk/resources/images/data/error.svg Incomplete ways ways with zero or only one node Removes the way
source:trunk/resources/images/data/warning.svg Untagged ways untagged ways 1. describe them correctly if you know this objects or
2. leave them until somebody describes them
no
Way connected to Area ways connected to areas.
source:trunk/resources/images/data/warning.svg Way terminates on Area First/Last node of way connected with area Optionally, either continue the way, unglue it from area or add a tag describing an entrance. no
Wrongly Ordered Ways direction of water, land and coastline ways.
Uncategorized Descriptions that need to be checked, updated and added to one of the categories above.
Check property keys misspelled property keys. See the words.cfg for file of misspelled property keys Replace wrong key with right one
Empty properties properties with empty values
source:trunk/resources/images/data/other.svg Key 'x' invalid. - ... illegal key combinations, names and similar issues
source:trunk/resources/images/data/other.svg Nodes with the same name two nodes have equal name
source:trunk/resources/images/data/other.svg Unknown property value proper use of tags If it is your new tag, it is good idea document it at wiki Any tags you like

Tag checker rules

This tab consists of two list and some buttons. On the left side all available rules are listed and on the right side all downloaded and local rules.

Buttons

Icon Description

Available rules (left)

Active rules (right)

MapCSS-based tests

Type Message What is checked Additional help Autofix
Addresses
Tag combinations
Deprecated features
Geometry
source:trunk/resources/images/data/other.svg Overlapping areas areas overlap Remove overlapping only when really wrong. no
Highways
source:trunk/resources/images/data/other.svg Highway without a reference there is a ref tag for highways that are tagged tertiary. Not always required, see for instance Highway Optionally, add noref=yes no
Multiple values
Numeric values
Religion
Relations
Territories
Unnecessary tags
Wikipedia

Advanced Preferences

More advanced preferences not described, yet.

  • validator.auto_reload_local_rules - wether to auto-reload local rules after file changes
  • validator.autozoom - wether to Zoom to problem, automatically
  • validator.ignorelist - the ignore list
  • validator.ignorelist.version - format version of the ignore list

See also


Back to Preferences Dialog
Back to Main Help

Attachments (3)

Download all attachments as: .zip

Note: See TracWiki for help on using the wiki.