Changes between Version 43 and Version 44 of Help/Preferences/Validator


Ignore:
Timestamp:
2020-05-28T18:19:01+02:00 (6 years ago)
Author:
skyper
Comment:

harmonize table; small updates

Legend:

Unmodified
Added
Removed
Modified

  • Help/Preferences/Validator

    v43 v44  
    1 [[TranslatedPages(outdated=This page is incomplete.)]]
     1[[TranslatedPages(outdated=This page is incomplete. Lot's of tests not described.)]]
    22
    3 = Preferences > Data Validator=
    4 
     3= Preferences > Data Validator =
     4[[JOSMImage(preferences/validator,48,link=,middle,margin-right=20,margin-bottom=10)]]
    55An OSM data validator that checks for common errors made by users and editor programs.
    66
    7 == Tests == #Tests
    8 
     7== Tests ==#Tests
    98By default, all error and warning tests are active.
    109
    11 [[Image(validator_settings.gif)]]
     10[[Image(validator_settings.gif,link=)]]
     11
     121. If you are a OSM newbie and encountered validation error about objects you haven't touched, please ignore these messages for now.
     131. Validator can be wrong or incomplete about all tagging practices. Don't fix errors when you aren't sure something is really wrong.
     141. First, refer to [wikitr:/Help/Dialog/Validator Validator panel] - how to use validator
     15
     16The fourth column contains also '''(video)''' explanations. The table is incomplete.
     17
     18||= Type =||= Message =||= ''What is checked'' =||= Additional help =||= Autofix =||
     19||||= '''Addresses''' =|||||| errors in [[osmwiki:Addresses]] and [[osmwiki:Relation:associatedStreet]]. ||
     20||  [[JOSMImage(data/warning)]]  || 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. || ||
     21||  [[JOSMImage(data/warning)]]  || Duplicate house numbers || two members of an `associatedStreet` relation have the identical house number. || It is possible with a low chance. || ||
     22||  [[JOSMImage(data/warning)]]  || 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`. || ||
     23||  [[JOSMImage(data/warning)]]  || 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. || ||
     24||  [[JOSMImage(data/warning)]]  || Multiple associatedStreet relations || an object is in more than one `associatedStreet` relation. || || ||
     25||||= '''Barriers and entrances''' =|||||| errors in [[osmwiki:Barriers]] and [[osmwiki:Key:entrance]]. ||
     26||||= '''Coastlines''' =|||||| [[osmwiki:Coastline]] are correct. ||
     27||  [[JOSMImage(data/error)]]  || 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 || ||
     28||  [[JOSMImage(data/error)]]  || Unconnected coastline: coastline ways do not form closed loops || coastlines ways that are not connected to the end of other coastline ways || || ||
     29||  [[JOSMImage(data/error)]]  || 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 || ||
     30||||= '''Conditional Keys''' =|| usage of `*:conditional` tags. |||| Imprecise rules covered at [osmwiki:Conditional_restrictions osm wiki page "Conditional restrictions"] ||
     31||||= '''Crossing barriers / boundaries / ways''' =|||||| ||
     32||  [[JOSMImage(data/warning)]]  || Crossing ways || ways (with highway/railway/waterway tags) that crosses in same layer with no crossing node || 1. [https://commons.wikimedia.org/wiki/File:JOSM_9900_en_validator_message_%22Crossing_ways%22_with_shortcuts.ogv (video) usually you need to add a common node] or \\ 2. add appropriate [[osmwiki:Key:layer]] (and possibly [[osmwiki:Key:bridge]] or [[osmwiki:Key:tunnel]]) ||
     33||||= '''Duplicated nodes''' =|||||| ||
     34||  [[JOSMImage(data/error)]]  || 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 || ||
     35||||= '''Duplicated relations''' =|||||| no relations with same tags and same members with same roles. ||
     36||||= '''Duplicated ways''' =|||||| no ways with same node coordinates and optionally also same tags. ||
     37||||= '''Duplicated way nodes''' =|||||| ways with identical consecutive nodes. ||
     38||  [[JOSMImage(data/error)]]  || 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. || ||
     39||||= '''Highways''' =|||||| semantic checks on highways. ||
     40||  [[JOSMImage(data/other)]]  || Highway without a reference || there is a [osmwiki:Key:ref ref tag] for highways that are tagged tertiary. Not always required, see for instance [osmwiki:Map_Features#Highway Highway] || ||
     41||||= '''Lane tags''' =|||||| `lanes:` tags. ||
     42||||= '''Tag checker (MapCSS based)''' =|||||| errors in tag keys and values. ||
     43||||= '''Multipolygon''' =|||||| multipolygons are valid. ||
     44||  [[JOSMImage(data/warning)]]  || 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 || ||
     45||  [[JOSMImage(data/warning)]]  || 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 || ||
     46||  [[JOSMImage(data/other)]]  || 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. || ||
     47||||= '''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. ||
     48||||= '''Opening hours syntax''' =|| correct usage of the opening hours syntax. |||| [osmwiki:Key:opening_hours#Examples common OH examples] [osmwiki:Key:opening_hours#Common_mistakes common mistakes] [osmwiki:Key:opening_hours/specification complete OH spec] ||
     49||||= '''Overlapping ways''' =|| a connection between two nodes is not used by more than one way. |||| [https://commons.wikimedia.org/wiki/File:JOSM_9900_en_validator_message_%22Overlapping_ways%22_with_shortcuts.ogv (video) Using selection, split and middle mouse] ||
     50||  [[JOSMImage(data/warning)]]  || Overlapping (high)ways || two (high) ways that share the same nodes || ||
     51||||= '''Power lines''' =|||||| nodes in power lines that do not have a power=tower/pole tag. ||
     52||||= '''Relation checker''' =|||||| errors in relations. ||
     53||||= '''Self-intersecting ways''' =|||||| ways that contain some of their nodes more than once. ||
     54||  [[JOSMImage(data/warning)]]  || Self-intersecting ways || a way crosses itself || Remove the self-crossing, remove overlapping parts or split way || ||
     55||||= '''Similarly named ways''' =|||||| ways with similar names that may have been misspelled. ||
     56||  [[JOSMImage(data/warning)]]  || Similar named ways || ways with very similar names, possibly a typo || ||
     57||||= '''Tag checker''' =|||||| errors in tag keys and values. ||
     58||||= '''Turn-restrictions''' =|||||| [osmwiki:Relation:restriction turn-restrictions] are valid. ||
     59||  [[JOSMImage(data/warning)]]  || Unknown role || the role for members of a turn restriction relation is either `from`, `to` (ways) or `via` (nodes and ways) || || ||
     60||  [[JOSMImage(data/warning)]]  || Unknown member type || only nodes and ways (and not relations) are members of a turn restriction relation. || || ||
     61||  [[JOSMImage(data/error)]]  || No "from" way found \\ No "to" way found \\ No "via" node or way found || all necessary elements of a turn restriction relation are present. || || ||
     62||  [[JOSMImage(data/error)]]  || 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. || || ||
     63||  [[JOSMImage(data/error)]]  || 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`. || || ||
     64||  [[JOSMImage(data/error)]]  || 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.) || ||
     65||  [[JOSMImage(data/warning)]]  || 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. || ||
     66||||= '''Unclosed Ways''' =|||||| ways which should be circular are closed. ||
     67||  [[JOSMImage(data/warning)]]  || Unclosed ways || way types, which should be closed really are closed || Close unclosed ways || ||
     68||||= '''Unconnected highways / natural lands and landuses / power ways / railways / waterways''' |||||| a way has an endpoint very near to another way. ||
     69||  [[JOSMImage(data/warning)]]  || 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 || ||
     70||||= '''Untagged and unconnected nodes''' =|||||| untagged nodes that are not part of any way. ||
     71||  [[JOSMImage(data/warning)]]  || 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 || ||
     72||||= '''Untagged, empty and one node ways''' =|||||| untagged, empty and one node ways. ||
     73||  [[JOSMImage(data/error)]]  || Incomplete ways || ways with zero or only one node || Removes the way || ||
     74||  [[JOSMImage(data/warning)]]  || Untagged ways || untagged ways || 1. describe them correctly if you know this objects or \\ 2. leave them until somebody describes them || ||
     75||||= '''Way connected to Area''' =|||||| ways connected to areas. ||
     76||||= '''Wrongly Ordered Ways''' =|||||| direction of water, land and coastline ways. ||
     77||||= '''Uncategorized''' =|||||| Descriptions that need to be checked, updated and added to one of the categories above. ||
     78|| || Check property keys || misspelled property keys. See the [source:/trunk/resources/data/validator/words.cfg words.cfg] for file of misspelled property keys || Replace wrong key with right one || ||
     79|| || Check property values || misspelled property values. Uses the [wikitr:/TaggingPresets tagging presets] file for checking || ||
     80|| || Empty properties || properties with empty values || || ||
     81||  [[JOSMImage(data/other)]]  || FIXMES || any property with the word "FIXME" inside || || ||
     82||  [[JOSMImage(data/other)]]  || Key 'x' invalid. - ... || illegal key combinations, names and similar issues || ||
     83||  [[JOSMImage(data/other)]]  || Nodes with the same name || two nodes have equal name || || ||
     84||  [[JOSMImage(data/other)]]  || Overlapping areas || areas overlap || Remove overlapping only when really wrong. || ||
     85||  [[JOSMImage(data/other)]]  || Unknown property value || proper use of tags || If it is your new tag, it is good idea document it at wiki [[osmwiki:Any tags you like]] || ||
    1286
    1387
    14 1. If you are a OSM newbie and encountered validation error about objects you haven't touched, please ignore these messages for now.
    15 2. Validator can be wrong or incomplete about all tagging practices. Don't fix errors when you aren't sure something is really wrong.
    16 3. First, refer to [wikitr:/Help/Dialog/Validator Validator panel] - how to use validator
     88== Tag checker rules ==#TagCheckerRules
    1789
    18 The third column contains also '''(video)''' explanations. The table is incomplete.
    19 
    20 || ||= ''Validation'' =||= ''What is checked'' =||= Additional help =||
    21 ||||= '''Addresses''' =|||| errors in [[osmwiki:Addresses]] and [[osmwiki:Relation:associatedStreet]]. ||
    22 || [[JOSMImage(data/warning)]] || 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. ||
    23 || [[JOSMImage(data/warning)]] || Duplicate house numbers || two members of an `associatedStreet` relation have the identical house number. || It is possible with a low chance. ||
    24 || [[JOSMImage(data/warning)]] || 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`.
    25 || [[JOSMImage(data/warning)]] || 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. ||
    26 || [[JOSMImage(data/warning)]] || Multiple associatedStreet relations || an object is in more than one `associatedStreet` relation. || ||
    27 ||||= '''Barriers and entrances''' =|||| errors in [[osmwiki:Barriers]] and [[osmwiki:Key:entrance]]. ||
    28 ||||= '''Coastlines''' =|||| [[osmwiki:Coastline]] are correct. ||
    29 ||||= '''Conditional Keys''' =|| usage of `*:conditional` tags. || Imprecise rules covered at [osmwiki:Conditional_restrictions osm wiki page "Conditional restrictions"]
    30 ||||= '''Crossing barriers / boundaries / ways''' =||  ||
    31 || [[JOSMImage(data/warning)]] ||Crossing ways||ways (with highway/railway/waterway tags) that crosses in same layer with no crossing node|| 1. [https://commons.wikimedia.org/wiki/File:JOSM_9900_en_validator_message_%22Crossing_ways%22_with_shortcuts.ogv (video) usually you need to add a common node] or 2. add appropriate [[osmwiki:Key:layer]] (and possibly [[osmwiki:Key:bridge]] or [[osmwiki:Key:tunnel]]) ||
    32 ||||= '''Duplicated nodes''' =||||  ||
    33 || [[JOSMImage(data/error)]] ||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||
    34 ||||= '''Duplicated relations''' =|||| no relations with same tags and same members with same roles. ||
    35 ||||= '''Duplicated ways''' =|||| no ways with same node coordinates and optionally also same tags. ||
    36 ||||= '''Duplicated way nodes''' =|||| ways with identical consecutive nodes. ||
    37 ||||= '''Highways''' =|||| semantic checks on highways. ||
    38 ||||= '''Lane tags''' =|||| `lane:` tags. ||
    39 ||||= '''Tag checker (MapCSS based)''' =|||| errors in tag keys and values. ||
    40 ||||= '''Multipolygon''' =|||| multipolygons are valid. ||
    41 ||||= '''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. ||
    42 ||||= '''Opening hours syntax''' =|| correct usage of the opening hours syntax. || [osmwiki:Key:opening_hours#Examples common OH examples] [osmwiki:Key:opening_hours#Common_mistakes common mistakes] [osmwiki:Key:opening_hours/specification complete OH spec] ||
    43 ||||= '''Overlapping ways''' =|| a connection between two nodes is not used by more than one way. || [https://commons.wikimedia.org/wiki/File:JOSM_9900_en_validator_message_%22Overlapping_ways%22_with_shortcuts.ogv (video) Using selection, split and middle mouse] ||
    44 || [[JOSMImage(data/warning)]] ||Overlapping (high)ways || two (high) ways that share the same nodes ||
    45 ||||= '''Power lines''' =|||| nodes in power lines that do not have a power=tower/pole tag. ||
    46 ||||= '''Relation checker''' =|||| errors in relations. ||
    47 ||||= '''Self-intersecting ways''' =|||| ways that contain some of their nodes more than once. ||
    48 ||||= '''Similarly named ways''' =|||| ways with similar names that may have been misspelled. ||
    49 || [[JOSMImage(data/warning)]] ||Similar named ways||ways with very similar names, possibly a typo ||
    50 ||||= '''Tag checker''' =|||| errors in tag keys and values. ||
    51 ||||= '''Turnrestrictions''' =|||| [[osmwiki:Relation:restriction|turn restrictions]] are valid. ||
    52 || [[JOSMImage(data/warning)]] || Unknown role || the role for members of a turn restriction relation is either `from`, `to` (ways) or `via` (nodes and ways) || ||
    53 || [[JOSMImage(data/warning)]] || Unknown member type || only nodes and ways (and not relations) are members of a turn restriction relation. || ||
    54 || [[JOSMImage(data/error)]] || No "from" way found [[br]] No "to" way found [[br]] No "via" node or way found || all necessary elements of a turn restriction relation are present. || ||
    55 || [[JOSMImage(data/error)]] || More than one "from" way found [[br]] More than one "to" way found [[br]] 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. || ||
    56 || [[JOSMImage(data/error)]] || 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`. || ||
    57 || [[JOSMImage(data/error)]] || The "from" way does not start or end at a "via" node. [[br]] The "to" way does not start or end at a "via" node. [[br]] The "from" and the first "via" way are not connected. [[br]] The "via" ways are not connected. [[br]] 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.) ||
    58 || [[JOSMImage(data/warning)]] || Superfluous turnrestriction 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. ||
    59 ||||= '''Unclosed Ways''' =|||| ways which should be circular are closed. ||
    60 ||||= '''Unconnected highways / natural lands and landuses / power ways / railways / waterways''' |||| a way has an endpoint very near to another way. ||
    61 ||||= '''Untagged and unconnected nodes''' =|| 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 ||
    62 ||||= '''Untagged, empty and one node ways''' =|||| untagged, empty and one node ways. ||
    63 ||||= '''Way connected to Area''' =|||| ways connected to areas. ||
    64 ||||= '''Wrongly Ordered Ways''' =|||| direction of water, land and coastline ways. ||
    65 ||||= '''Uncategorized''' =|||| Descriptions that need to be checked, updated and added to one of the categories above. ||
    66 || [[JOSMImage(data/error)]] ||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.||
    67 || [[JOSMImage(data/error)]] ||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||
    68 || [[JOSMImage(data/error)]] ||Unconnected coastline: coastline ways do not form closed loops||coastlines ways that are not connected to the end of other coastline ways|| ||
    69 || [[JOSMImage(data/error)]] ||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||
    70 ||[[JOSMImage(data/error)]]||Incomplete ways||ways with zero or only one node||Removes the way||
    71 || ||Check property keys||misspelled property keys. See the [source:/trunk/resources/data/validator/words.cfg words.cfg] for file of misspelled property keys||Replace wrong key with right one||
    72 || ||Check property values||misspelled property values. Uses the [wikitr:/TaggingPresets tagging presets] file for checking||
    73 || ||Empty properties||properties with empty values|| ||
    74 || [[JOSMImage(data/warning)]] ||Self-intersecting ways||a way crosses itself||Remove the self-crossing, remove overlapping parts or split way||
    75 || [[JOSMImage(data/warning)]] ||Unclosed ways||way types, which should be closed really are closed||Close unclosed ways||
    76 || [[JOSMImage(data/warning)]] ||Untagged ways||untagged ways|| 1. describe them correctly if you know this objects or 2. leave them until somebody describes them ||
    77 || [[JOSMImage(data/warning)]] ||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 ||
    78 || [[JOSMImage(data/warning)]] ||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||
    79 || [[JOSMImage(data/warning)]] ||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
    80 || [[JOSMImage(data/other)]] ||FIXMES||any property with the word "FIXME" inside ||
    81 || [[JOSMImage(data/other)]] ||Highway without a reference||there is a [osmwiki:Key:ref ref tag] for highways that are tagged tertiary. Not always required, see for instance [osmwiki:Map_Features#Highway Highway]|| ||
    82 || [[JOSMImage(data/other)]] ||Key 'x' invalid. - ...||illegal key combinations, names and similar issues ||
    83 || [[JOSMImage(data/other)]] ||Nodes with the same name||two nodes have equal name|| ||
    84 || [[JOSMImage(data/other)]] ||Overlapping areas||areas overlap||Remove overlapping only when really wrong.||
    85 || [[JOSMImage(data/other)]] ||Unknown propery value||proper use of tags||If it is your new tag, it is good idea document it at wiki [[osmwiki:Any tags you like]]||
    86 || [[JOSMImage(data/other)]] ||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.||
    87 
    88 == Tag checker rules == #TagCheckerRules
    8990
    9091=== See also ===
    91  * [wikitr:/Help/Dialog/Validator Validator panel]
    92  * [wikitr:/Rules JOSM Validator Custom rules from "Tag Checker Rules"]
    93  * [wikitr:/Help/Validator/MapCSSTagChecker MapCSSTagChecker] - about the syntax of validator checks, which are based on MapCSS
     92* [[JOSMImage(dialogs/validator)]] [wikitr:/Help/Dialog/Validator Validator panel]
     93* [wikitr:/Rules JOSM Validator Custom rules from "Tag Checker Rules"]
     94* [wikitr:/Help/Validator/MapCSSTagChecker MapCSSTagChecker] - about the syntax of validator checks, which are based on MapCSS
    9495
    9596----
    96 Back to [wikitr:/Help/Action/Preferences Preferences Dialog]\\
     97Back to [wikitr:/Help/Action/Preferences Preferences Dialog] \\
    9798Back to [wikitr:/Help Main Help]