Changes between Version 113 and Version 119 of Help/Concepts/Object
- Timestamp:
- (multiple changes)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Help/Concepts/Object
v113 v119 1 [[TranslatedPages(outdated=Member; Membership; Child and Parent not explained properly. Any need to split Tags into two parts ?)]] 1 [[TranslatedPages(outdated=Member; Membership; Roles; Child and Parent not explained properly. Any need to split Tags into two parts ?)]] 2 2 3 3 … … 8 8 [[PageOutline(2-10,Table of Contents)]] 9 9 10 10 11 == Nodes, ways, and relations == #NodesWaysRelations 11 12 12 === Tags (also an OSM data primitive)=== #Tags13 === Tags === #Tags 13 14 14 Tags provide meaning to the objects. Without them, any other object would be useless and meaningless. Each of ''three otherdata primitives'' '''can have multiple tags'''.15 Tags provide meaning to the objects. Without them, any other object would be useless and meaningless. Each of the three data primitives can have multiple tags. 15 16 16 [=#presets Often tags used in combinations; '''usually these combinations can be found] in [wikitr:/Presets presets]'''. But it may be true that tags you need to use are not in presets and you need to know them first.17 [=#presets Often tags used in combinations; usually these combinations can be found] in [wikitr:/Presets presets]. But it may be true that tags you need to use are not in presets and you need to know them first. 17 18 18 19 Simplest example is [osmwiki:Key:drinking_water drinking_water=yes] - it is present globally and can be applied to every object that provides water. Other example is [osmwiki:Key:leaf_cycle leaf_cycle]=* of trees, it will have less coverage globally (as trees do not grow just everywhere). … … 22 23 [#Tags1 We will cover tags in more detail below], but first will cover all other data primitives. 23 24 24 === Nodes (a lso an OSM data primitive) === #Nodes25 === Nodes (an OSM data primitive) === #Nodes 25 26 [[JOSMImage(data/node,24,bottom,margin-right=15,link=)]] A **node** is an individual point with a defined position. ''With respective tags'' it can be used to indicate shops, benches, individual trees or points of drinking water. 26 27 … … 33 34 A practical meaning of this is demonstrated at the [wikitr:/Help/Action/Draw#Commonnodes Draw Nodes] page. The [wikitr:/Help/Action/MergeNodes Merge Nodes] tool can be used to create common nodes. 34 35 35 === Ways (a lso an OSM data primitive) === #Ways36 [[JOSMImage(data/way,24,middle,margin-right=15,margin-bottom=5,link=)]] A **way** is a sequence of nodes ([https://en.wikipedia.org/wiki/Polygonal_chain a "polygonal chain" from ordinary geometry]). OSM **way**used to represent linear objects, ''with respective tags'' it can used to describe: a river bank, tree row, kerbs in the streets (among other uses).36 === Ways (an OSM data primitive) === #Ways 37 [[JOSMImage(data/way,24,middle,margin-right=15,margin-bottom=5,link=)]] A **way** is a sequence of nodes ([https://en.wikipedia.org/wiki/Polygonal_chain a "polygonal chain" from ordinary geometry]). The OSM way is used to represent linear objects, ''with respective tags'' it can used to describe: a river bank, tree row, kerbs in the streets (among other uses). 37 38 38 39 ==== Direction ==== 39 40 Since nodes are ordered in OSM; every way in OSM has a direction. This gives us possibility to add tags (details about object) such as [osmwiki:Key:conveying conveying=*] - to specify direction of escalators and moving walkways or [osmwiki:Key:incline incline=*] which can be used toghter with roads and footways. There [osmwiki:Category:Way_Direction_Dependent more examples] and we can't cover them all. 40 41 41 **Note**: Rendering of direction in [wikitr:/Help/MapView MapView] can be set in DisplayPreferences under [wikitr:/Help/Preferences/Display#OSMDataOSM Data].42 **Note**: Rendering of direction in [wikitr:/Help/MapView MapView] can be set in Preferences under [wikitr:/Help/Preferences/DrawingPreference OSM Data]. 42 43 43 44 ==== Segment ====#Segment 44 Is '''a fragment between two consequent points of the way'''([https://en.wikipedia.org/wiki/Line_segment "line segment" from ordinary geometry]). This is not a part of OSM data model, but users often distinguish because of tools than operate on segment level (rather than on complete way); please, distinguish a segment(s) from complete "way"s.45 Is a fragment between two consequent points of the way ([https://en.wikipedia.org/wiki/Line_segment "line segment" from ordinary geometry]). This is not a part of OSM data model, but users often distinguish because of tools than operate on segment level (rather than on complete way); please, distinguish a segment(s) from complete "way"s. 45 46 46 **Note**: Rendering of segments in [wikitr:/Help/MapView MapView] can be set in DisplayPreferences under [wikitr:/Help/Preferences/Display#OSMDataOSM Data].47 **Note**: Rendering of segments in [wikitr:/Help/MapView MapView] can be set in Preferences under [wikitr:/Help/Preferences/DrawingPreference OSM Data]. 47 48 48 49 ==== Areas ==== #Areas 49 [[JOSMImage(data/closedway,24,middle,margin-right=15,margin-bottom=5,link=)]] If a **way**is closed, i.e. if the last node is the same as the first node, it is also called an**area**. Old term for this is ''Closed Ways'' (it is still present at wiki, used in software and by some mappers; other part uses "geometry" when talking just about shape of the objects, without tags).50 [[JOSMImage(data/closedway,24,middle,margin-right=15,margin-bottom=5,link=)]] If a way is closed, i.e. if the last node is the same as the first node, it is also called an area. Old term for this is ''Closed Ways'' (it is still present at wiki, used in software and by some mappers; other part uses "geometry" when talking just about shape of the objects, without tags). 50 51 51 52 Sometimes single area is not enough to represent an object (for example, a lake with an island in it), then you have to use a [wikitr:/Help/Concepts/Object#typemultipolygon multi-polygon] 52 53 53 === Relations (a lso an OSM data primitive) === #Relations54 === Relations (an OSM data primitive) === #Relations 54 55 55 56 ==== In most cases you don't need them ==== 56 57 If some object can be represented with single ''node'' or ''way'' and ''multiple tags supported by software'', then there is no need in relations. But there are some rare cases where it is theoretically and practically impossible ''only with nodes, ways and tags'' (ex. turn restrictions, will be covered below). 57 58 58 This means '''you can [#Tags1 skip this big "Relations" section], until you decide to add or edit a relation'''.59 This means you can [#Tags1 skip this big "Relations" section], until you decide to add or edit a relation. 59 60 60 ==== Simple explanation ==== 61 ==== Simple explanation ====#SimpleExplanation 61 62 [[JOSMImage(data/relation,24,middle,margin-right=15,margin-bottom=5,link=)]] A **relation**: 62 63 * is a sequence of other objects (nodes, ways and relations) … … 65 66 * tag type=* used to define one of [osmwiki:Types_of_relation many types of relations] 66 67 67 Additionally, each object participating in a **relation**can be assigned a **role**, for instance "via" node and "from", "to" ways in type=restriction relation.68 Additionally, each object participating in a relation can be assigned a **role**, for instance "via" node and "from", "to" ways in type=restriction relation. 68 69 69 70 [wikitr:/Help/Relations Relation Help] covers the most basic tools to create relations in JOSM ([wikitr:/Help/Dialog/RelationList Relations window], [wikitr:/Help/Dialog/SelectionList Selection], [wikitr:/Help/Dialog/RelationEditor Relation editor]). … … 93 94 Can be used to describe turn restrictions according to signs and road marking. JOSM has a plugin to support this type of relations: [osmwiki:JOSM/Plugins/Turnrestrictions Turnrestrictions plugin],[osmwiki:Relation:restriction#Examples Examples] 94 95 96 95 97 == Tags ==#Tags1 96 98 More precisely, a **tag** is a name/value pair assigned to an object. If we write `foo`=`bar` we mean ''The tag with key foo is assigned the value bar''. Here are some examples: … … 111 113 }}} 112 114 113 Assigned to a way, this set of **tags**indicate, that the way represents a road in a residential area with name ''Main road'' (the German name be ''Hauptstraße'', the English name, which in this example equals to name, is ''Main road''). Speed is limited to 30km/h and heavy goods vehicles (hgv) are not allowed. Furthermore, it's a one way street.115 Assigned to a way, this set of tags indicate, that the way represents a road in a residential area with name ''Main road'' (the German name be ''Hauptstraße'', the English name, which in this example equals to name, is ''Main road''). Speed is limited to 30km/h and heavy goods vehicles (hgv) are not allowed. Furthermore, it's a one way street. 114 116 115 117 In the [[JOSMImage(dialogs/propertiesdialog)]] [wikitr:/Help/Dialog/TagsMembership Tags/Membership panel] you can assign tags to an object, remove tags from an object, or edit assigned tags. 118 116 119 117 120 == Technical properties == … … 121 124 122 125 In JOSM, a new object doesn't have an ID (its ID is 0) until it is uploaded the first time to the OSM server. 123 * Under **''[[JOSMImage(preference)]] [wikitr:/Help/Action/Preferences Preferences]''** (or **''`F12`''**) -> [[JOSMImage(preferences/display,24,link=,middle)]]**''[wikitr:/Help/Preferences/Display DisplaySettings] -> Look and Feel''**it is possible to en- or disable the display of objects ids in the windows.124 * With **''File -> [[JOSMImage(downloadprimitive)]] [wikitr:/Help/Action/DownloadObject Download object ...]''**it is possible to download**objects**by Ids.126 * Under ''[[JOSMImage(preference)]] [wikitr:/Help/Action/Preferences Preferences]'' (or ''`F12`'') -> [[JOSMImage(preferences/display,24,link=,middle)]] ''[wikitr:/Help/Preferences/Display Display]'' it is possible to en- or disable the display of objects ids in the windows. 127 * With ''File -> [[JOSMImage(downloadprimitive)]] [wikitr:/Help/Action/DownloadObject Download object ...]'' it is possible to download objects by Ids. 125 128 126 **Note**: The display of object ids in the [wikitr:/Help/Dialog/SelectionList Selection List] can be set in DisplayPreferences under [wikitr:/Help/Preferences/Display#LookAndFeel Look and Feel].129 **Note**: The display of object ids in the [wikitr:/Help/Dialog/SelectionList Selection List] can be set in Preferences under ''[wikitr:/Help/Preferences/Display Display]''. 127 130 128 131 … … 136 139 Also, you can use time sliced data (region extracts by date) to inspect how objects were changing (and refer to object id and point in time from the database). 137 140 138 **Note**: The display of object versions in the [wikitr:/Help/Dialog/SelectionList Selection List] can be set in DisplayPreferences under [wikitr:/Help/Preferences/Display#LookAndFeel Look and Feel].141 **Note**: The display of object versions in the [wikitr:/Help/Dialog/SelectionList Selection List] can be set in Preferences under [wikitr:/Help/Preferences/Display Display]. 139 142 140 143 ==== Information about latest version ==== 141 * **''View -> [[JOSMImage(info)]] [wikitr:/Help/Action/InfoAboutElements Advanced info]''**(or Keyboard shortcut:**''`Ctrl+I`''**) opens separated windows with informations about selected objects in text format.142 * **''View -> [[JOSMImage(info)]] [wikitr:/Help/Action/InfoAboutElementsWeb Advanced info (web)]''**(or Keyboard shortcut:**''`Ctrl+Shift+I`''**) opens the**objects pages**of selected objects on the [osmwww: OSM website] in your web browser.144 * ''View -> [[JOSMImage(info)]] [wikitr:/Help/Action/InfoAboutElements Advanced info]'' (or Keyboard shortcut:''`Ctrl+I`'') opens separated windows with informations about selected objects in text format. 145 * ''View -> [[JOSMImage(info)]] [wikitr:/Help/Action/InfoAboutElementsWeb Advanced info (web)]'' (or Keyboard shortcut:''`Ctrl+Shift+I`'') opens the objects pages of selected objects on the [osmwww: OSM website] in your web browser. 143 146 144 147 Alternatively, you can browse the objects directly by entering following address in your web browser: … … 149 152 150 153 ==== History of the object ====#ObjectHistory 151 Each object has a **version**. The **version**is incremented whenever the object is uploaded to the server and the OSM server not only stores the most recent version of an object, but its complete**history**.154 Each object has a version. The version is incremented whenever the object is uploaded to the server and the OSM server not only stores the most recent version of an object, but its complete history. 152 155 153 * **''View -> [[JOSMImage(dialogs/history)]] [wikitr:/Help/Action/ObjectHistory History]''**(or Keyboard shortcut:**''`Ctrl+H`''**) opens the History Browser. The History Browser will show you the**versions**of a particular object.154 * Alternatively, **''View -> [[JOSMImage(dialogs/history)]] [wikitr:/Help/Action/ObjectHistoryWeb History (web)]''**(or Keyboard shortcut:**''`Ctrl+Shift+H`''**) opens a page on the [osmwww: OSM website] in your web browser which displays the object history, too.156 * ''View -> [[JOSMImage(dialogs/history)]] [wikitr:/Help/Action/ObjectHistory History]'' (or Keyboard shortcut:''`Ctrl+H`'') opens the History Browser. The History Browser will show you the versions of a particular object. 157 * Alternatively, ''View -> [[JOSMImage(dialogs/history)]] [wikitr:/Help/Action/ObjectHistoryWeb History (web)]'' (or Keyboard shortcut:''`Ctrl+Shift+H`'') opens a page on the [osmwww: OSM website] in your web browser which displays the object history, too. 155 158 156 159 ----
