Changes between Version 142 and Version 147 of Introduction
- Timestamp:
- (multiple changes)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Introduction
v142 v147 5 5 == Introduction to JOSM == 6 6 === JOSM Terminology === 7 8 7 [[JOSMImage(data/node,middle,inline,link=)]] Node:: A node is a point. 9 8 10 9 [[JOSMImage(data/way,middle,inline,link=)]] Way:: A way is a line connecting multiple nodes. Way, therefore, is a general term for series of joined nodes, not just for roads or ways in reality. 11 10 12 [[JOSMImage(data/relation,middle,inline,link=)]] Relation:: A relation is an ordered sequence of ways and nodes, a logical container used to group elements. Only [ https://taginfo.openstreetmap.org/reports/database_statistics 1% of the data] is modeled using relations.11 [[JOSMImage(data/relation,middle,inline,link=)]] Relation:: A relation is an ordered sequence of ways and nodes, a logical container used to group elements. Only [taginfo:reports/database_statistics 1% of the data] is modeled using relations. 13 12 14 13 [[JOSMImage(data/closedway,middle,inline,link=)]] Area:: An area is a way whose ends are connected. … … 16 15 [[JOSMImage(dialogs/propertiesdialog,middle,16,inline,link=)]] Tag:: Tags describe what each node, way or relation represents. Tags are pairs of key and value. Keys are basically larger categories, such as "Highway" or "Land Use," while values are specific features, such as "Primary Road" or "Residential Street," and "Residential" or "Retail" land use. For example `highway=residential` is pair of key `highway` and value `residential` and represents a residential street. 17 16 18 If a road, track or path is curved, the curve is approximated using a number of nodes within a way, and short lines connecting them. If a way has a direction, that is indicated partly by using tags. For example, "oneway=yes" is a road that goes only in one direction. Other tags refer to being on the left and right of the direction of way along the way. 17 If a road, track or path is curved, the curve is approximated using a number of nodes within a way, and short lines connecting them. If a way has a direction, that is indicated partly by using tags. For example, "oneway=yes" is a road that goes only in one direction. Other tags refer to being on the left and right of the direction of way along the way (ie. Coastline). 19 18 20 19 … … 22 21 JOSM is a Java program, can be obtained from the [wikitr:/Download#Recommendedoptions Download page] which contains download links and link to further help. 23 22 24 If you don't know how to start it, ask someone familiar with your platform how to run a Java program or [https://wiki.openstreetmap.org/wiki/Contact_channels other OSM mappers].23 If you don't know how to start it, ask someone familiar with your platform or [osmwiki:Contact_channels other OSM mappers] how to run a Java program. 25 24 26 25 … … 30 29 31 30 === Downloading ===#Downloading 32 The next step is to download some data. You can practice using JOSM by downloading your neighborhood or locality you know or just recently visited. 31 The next step is to download some data. You can practice using JOSM by downloading your neighborhood or locality you know or just recently visited. 33 32 34 33 ==== OSM data ==== … … 37 36 [[Image(download-data.gif,600,inline,link=)]] 38 37 39 ''The Download window will be displayed which contains a map of the world. You need to select a small area for your edit, not the entire globe (thus you will see the "Download area too large" message).38 The Download window will be displayed which contains a map of the world. You need to select a small area for your edit, not the entire globe (thus you will see the "Download area too large" message). 40 39 41 ''To move around the map and select the specific area you want to download, there are several tools:42 * ''Click with the right mouse button to drag the map43 * ''Use the scroll wheel to zoom in and out44 * ''Click with the left mouse button and move the mouse to define an area.40 To move around the map and select the specific area you want to download, there are several tools: 41 * Click with the right mouse button to drag the map 42 * Use the scroll wheel to zoom in and out 43 * Click with the left mouse button and move the mouse to define an area. 45 44 46 ''After the "Download area too large" error disappeared and you selected a region, click "Download" to fetch the data from the main server.''45 After the "Download area too large" error disappeared and you selected a region, click "Download" to fetch the data from the main server. 47 46 48 47 === Enable Aerial imagery ===#EnableAerialimagery … … 56 55 57 56 === Editing in JOSM === 58 JOSM is an offline editor which means everything you do won't be visible for anyone else until you upload it to the server. This makes it possible to experiment and repeatedlymoving, tagging, adding and deleting elements without breaking anything. Subsequent actions on a single element will go into the database as a single modification when uploaded.57 JOSM is an offline editor which means everything you do won't be visible for anyone else until you upload it to the server. This makes it possible to experiment with moving, tagging, adding and deleting elements repeatedly without breaking anything. Subsequent actions on a single element will go into the database as a single modification when uploaded. 59 58 60 59 === Adding a Node or a Way === 61 The first step of actual editing is to [wikitr:/Help/Action/Draw add a node ] or wayto the OSM data. You can add standalone nodes or you can add nodes to ways, especially where there is a [wikitr:/Help/Action/Draw#Commonnodeswithanotherway junction between two ways].60 The first step of actual editing is to [wikitr:/Help/Action/Draw add a node or way] to the OSM data. You can add standalone nodes or you can add nodes to ways, especially where there is a [wikitr:/Help/Action/Draw#Commonnodeswithanotherway junction between two ways]. 62 61 63 To add a node, activate "Draw Nodes" [wikitr:Help/EditToolbar#Workingmodes mode], ''either by clicking the [[JOSMImage(mapmode/node/autonode,20,middle,link=)]] button in the left menu bar, or by hitting the "A" key on the keyboard (the button should then be highlighted)''. 62 To add a node, activate "Draw Nodes" [wikitr:/Help/EditToolbar#Workingmodes mode], ''either by clicking the [[JOSMImage(mapmode/node/autonode,20,middle,link=)]] button in the left menu bar, or by hitting the "A" key on the keyboard (the button should then be highlighted)''. 64 63 65 64 Then move the mouse cursor over where you want the node, over a way or over your GPS track (if you uploaded one) and left click wherever you want to place the node. A red dot (a selected node) should appear and a rubber-line spans from that node to the mouse cursor. If you create subsequent nodes, the earlier nodes will be shown as yellow nodes. … … 68 67 69 68 === Adding Tags ===#AddingTags 70 Ways or nodes on their own are not of much use unless they are ''[wikitr:/Help/Concepts/Object#Tags tagged]'' to say what they represent. The [osmwiki:Map_Features Map Features] page shows some popular tags, this page will never be complete about all tags. 69 Ways or nodes on their own are not of much use unless they are ''[wikitr:/Help/Concepts/Object#Tags tagged]'' to say what they represent. The [osmwiki:Map_Features Map Features] page shows some popular tags, but this page will never be complete about all tags. 71 70 72 71 The first step in adding tags is to be sure the [wikitr:/Help/Dialog/TagsMembership Tags/Membership window] is open on the right hand side of JOSM. ''The [[JOSMImage(dialogs/propertiesdialog,20,middle,link=)]] button on the left should be highlighted. If it is not highlighted, click on it or hit `Alt+Shift+P`''. 73 72 74 You will see three buttons: [[JOSMImage(dialogs/add,20,middle,link=)]] 73 You will see three buttons: [[JOSMImage(dialogs/add,20,middle,link=)]]**Add**, [[JOSMImage(dialogs/edit,20,middle,link=)]]**Edit** and [[JOSMImage(dialogs/delete,20,middle,link=)]]**Delete**. 75 74 76 To edit the properties of a node or way (such as adding a tag) in the Tags/Membership window, the way or node must be selected. 75 To edit the properties of a node or way (such as adding a tag) in the Tags/Membership window, the way or node must be selected. 77 76 1. ''Enter [wikitr:/Help/Action/Select Select mode] by clicking on [[JOSMImage(mapmode/move/move,20,middle,link=)]] of the left-hand icons or by hitting the `S` key.'' 78 1. ''Highlight the way or pointyou wish to select. Click the [[JOSMImage(dialogs/add,20,middle,link=)]]**Add** button.''77 1. ''Highlight the way or node you wish to select, then click the [[JOSMImage(dialogs/add,20,middle,link=)]]**Add** button.'' 79 78 1. ''A [wikitr:/Help/Dialog/AddValue dialog box] will appear, and you will be asked to select a key and a value for each tag. Type in the key/value pair that represents the tag you are creating. For example, for the key you might type "amenity" and for the value "fountain" (without quotes).'' 80 1. ''Click OK. You have now tagged your way. You can add several tags to one object. 81 '' 82 [[Image(poi-restourant.gif,left,link=)]] 79 1. ''Click OK. You have now tagged your way. You can add several tags to one object.'' 80 [[Image(poi-restourant.gif,link=)]] 83 81 [[Image(poi-fountain.gif,link=)]] 84 85 \\ \\ \\86 82 87 83 === Presets ===#Presets … … 89 85 90 86 All presets can be found: 91 1. at the [wikitr:/Help/Menu main menu] (shown on the left below)87 1. at the [wikitr:/Help/Menu main menu] (shown below on the left) 92 88 1. at the [wikitr:/Help/MainToolbar main toolbar] (no picture below) 93 1. with the `F3` shortcut ( pop-up menushown below on the right)89 1. at the pop-up menu with the `F3` shortcut (shown below on the right) 94 90 95 91 [[Image(presets-from-main-menu.png,link=)]] 96 92 [[Image(presets-f3-search.png,link=)]] 97 93 98 Presets for [wikitr:/Help/Dialog/SelectionList#Selection currently selected object(s)] are displayed above the tags for the current object (displayed in[wikitr:/Help/Dialog/TagsMembership Tags/Memberships window]):94 Presets for the [wikitr:/Help/Dialog/SelectionList#Selection currently selected object(s)] are displayed above the tags in the [wikitr:/Help/Dialog/TagsMembership Tags/Memberships window]: 99 95 100 96 [[Image(presets-in-tag-toggle.png,link=)]] … … 102 98 === Left mouse click on respective preset heading will open complete preset view ===#Leftmouseclickonrespectivepresetheadingwillopencompletepresetview 103 99 104 [[Image(single-preset-shown-in-context-of-tagsmemberships-single-object.png, nolink)]]100 [[Image(single-preset-shown-in-context-of-tagsmemberships-single-object.png,link=)]] 105 101 106 102 === Uploading to OSM ===#UploadingtoOSM 107 103 If you are happy with all that you have done then you must upload your work to the OSM server. Click on the [[JOSMImage(upload,20,middle,link=)]] button. 108 104 109 This will automatically trigger a [wikitr:/Help/Validator validation] of your changes. Review all validation warnings and try to resolve them before you upload. This will prevent unfortunate mistakes such as un-tagged objects or unconnected roads. Note that validator warnings can also be wrong in seldomspecial cases.105 This will automatically trigger a [wikitr:/Help/Validator validation] of your changes. Review all validation warnings and try to resolve them before you upload. This will prevent unfortunate mistakes such as un-tagged objects or unconnected roads. Note that validator warnings can also be wrong in rare special cases. 110 106 111 107 Before you upload, add a proper changeset comment and specify which source you used. This is important as it will show other users who see your changesets what this changeset was intended to modify and from where you took the information. … … 113 109 [[Image(uploading data.gif,link=)]] 114 110 115 ''JOSM will give you an overview of the elements that it is about to upload. You will be asked to provide a short text summary and the source of your edits. This description will be saved with your data on the server and provides information, for example , for the [osmwww:history Recent Changes list].''111 ''JOSM will give you an overview of the elements that it is about to upload. You will be asked to provide a short text summary and the source of your edits. This description will be saved with your data on the server and provides information for the [osmwww:history Recent Changes list], for example.'' 116 112 117 113 If you need more details or have questions about upload process, it is precisely covered at [wikitr:/Help/Action/Upload Upload data]. … … 125 121 === Results of your job === 126 122 * Your changes will appear at the [osmwww:#layers= "Standard" layer] probably within a few minutes. 127 * Data in your routing software, maps and other services :will be updated per each service (from minutes to days, weeks and months)123 * Data in your routing software, maps and other services will be updated per each service (from minutes to days, weeks and months) 128 124 129 125 === Tell your friends === 130 * Tell your friends how easy it is to update data and how your changes get displayed quickly. Truck drivers, couriers, photographers, bikers, journalists, fisherm an and simply runners with GPS are always welcome in OSM.131 * Precise and actual information may affect how you make decisions in your life. The more people who are active in the project -the faster the data gets updated. And while[http://osmstats.neis-one.org/?item=countries&date= a few contributors] can be called as "active" at a given point in time. Every small change advances OSM to a complete and actual state.126 * Tell your friends how easy it is to update data and how your changes get displayed quickly. Truck drivers, couriers, photographers, bikers, journalists, fishermen and simply runners with GPS are always welcome in OSM. 127 * Precise and actual information may affect how you make decisions in your life. The more people who are active in the project, the faster the data gets updated. And while only [https://osmstats.neis-one.org/?item=countries&date= a few contributors] can be called as "active" at a given point in time. Every small change advances OSM to a complete and actual state. 132 128 * OSM data may be viewed as clocks: without an arrow you wouldn't know minutes. It often gets outdated - simply refresh it. When clocks stop we wind them up again. 133 129 * OpenStreetMap is about the whole planet in the same way how your clock about the current time. … … 135 131 136 132 = External links = 137 * [https://www.mapbox.com/mapping/ Mapping with OpenStreetMap] with animations by Mapbox team covers mostly the same topics.138 133 * [https://www.mapbox.com/blog/making-the-most-josm/ Your first steps with JOSM - the Java OpenStreetMap editor] 09/02/2016 by Ramya Ragupathy at Mapbox blog 139 134