Changes between Version 106 and Version 148 of Introduction


Ignore:
Timestamp:
(multiple changes)
Author:
(multiple changes)
Comment:
(multiple changes)

Legend:

Unmodified
Added
Removed
Modified

  • Introduction

    v106 v148  
    11[[TranslatedPages]]
     2[[PageOutline]]
    23
    34
    45== Introduction to JOSM ==
    56=== JOSM Terminology ===
     7 [[JOSMImage(data/node,middle,inline,link=)]] Node:: A node is a point.
    68
    7  [[Image(source:trunk/images/data/node.png,middle,inline,link=)]] Node:: A node is a point.
     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.
    810
    9  [[Image(source:trunk/images/data/way.png,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 [[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.
    1012
    11  [[Image(source:trunk/images/data/relation.png,middle,inline,link=)]] Relation:: A relation is an ordered sequence of ways and nodes, a logical container used to group elements.
     13 [[JOSMImage(data/closedway,middle,inline,link=)]] Area:: An area is a way whose ends are connected.
    1214
    13  [[Image(source:trunk/images/data/closedway.png,middle,inline,link=)]] Area:: An area is a way whose ends are connected.
     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.
    1416
    15  [[Image(source:trunk/images/dialogs/propertiesdialog.svg,middle,16,inline,link=)]] Tag:: Tags describe what each node or way represents. Tags are organized into "keys" and "values." 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.
     17If 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).
    1618
    17 If a road or 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.
    1819
    19 == Start a JOSM ==
    20 JOSM is a Java program, [/wiki can be run from main page].
     20== Launch JOSM ==
     21JOSM is a Java program, can be obtained from the [wikitr:/Download#Recommendedoptions Download page] which contains download links and link to further help.
     22
     23If 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.
     24
    2125
    2226== Your first edit with JOSM ==
    23 
    2427=== Welcome screen ===
    25 
    2628When JOSM starts, it presents you with a few messages about recent changes in JOSM. You should have a look at this page from time to time as it keeps you informed on some of the more interesting changes.
    2729
    28 === Downloading ===
    29 
    30 The next step is to download some data. You can practice using JOSM by downloading your neighbourhood or locality you know or just recently visited.
     30=== Downloading ===#Downloading
     31The next step is to download some data. You can practice using JOSM by downloading your neighborhood or locality you know or just recently visited.
    3132
    3233==== OSM data ====
     34Next, add data for that area from main server, click at: [[JOSMImage(download,middle,20,link=)]] [wikitr:/Help/Action/Download Download from OSM] (`Ctrl+Shift+↓`).
    3335
    34 Next, add data for that area from main server, click at: [[Image(source:trunk/images/download.png,middle,20,link=)]] [Help/Action/Download Download from OSM] ({{{Ctrl+Shift+↓}}}).
     36[[Image(Kapture 2025-06-01 at 12.43.31 2.gif​,600,inline,link=)]]
    3537
    36 [[Image(download-data.gif,600,inline,link=)]]
     38The 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).
    3739
    38 ''"Slippy Map" tab will be displayed, a map of the world. But you need to select smaller area for your edit, not entire globe (thus you will see "Download are too large" message).
     40To 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.
    3944
    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 to define an area.
     45After the "Download area too large" error disappeared and you selected a region, click "Download" to fetch the data from the main server.
    4446
    45 ''After "Download are too large" error disappeared and you selected a region, click "Download" to fetch the data from main server.''
     47=== Enable Aerial imagery ===#EnableAerialimagery
     48For most places on earth there is at least one imagery available. You can pick one from the [wikitr:/Help/Menu/Imagery Imagery menu] at the top of the editor. Bing and Mapbox are popular, but there may be more recent resources for your locality. Note that all local imagery resources, which are available for the region you are currently working, are displayed in the lower part of the Imagery menu.
    4649
    47 === Enable Aerial imagery ===
    48 
    49 For most places on earth, there at least one imagery available. You can pick one from [Help/Menu/Imagery Imagery menu] at the top of the editor. While Bing and Mapbox are popular, but there may be more recent resources for your locality.
    50 
    51 Bing and Mapbox may have different levels of detail and clarity in different places, so often worth checking both. Simply select one of them from the imagery menu and you're ready to go.
    52 
    53 Mapbox-only: you can [https://www.mapbox.com/bites/00240/#3/0.00/0.00 request a better imagery for region of your interest] ([https://www.mapbox.com/blog/new-imagery-for-openstreetmap/ announcement in 2014-04-11 by Eric Gundersen])
     50Imageries may have different levels of detail and clarity in different places, so it is often worth checking different imageries. Simply select one of them from the imagery menu and you're ready to go.
    5451
    5552[[Image(enable-imagery.gif,link=)]]
    … …  
    5855
    5956=== Editing in JOSM ===
    60 
    61 JOSM is an offline editor which means everything you do won't be visible for anyone else until uploading it to the server. This makes it possible to experiment and repeatedly moving, 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.
     57JOSM 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.
    6258
    6359=== Adding a Node or a Way ===
    64 The first step of actual editing is to [wiki: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 junction between two ways.
     60The 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].
    6561
    66 To add a node, highlight the "Node" button, either by clicking the 3rd button in the left menu bar [[Image(source:trunk/images/mapmode/node/autonode.png,20,middle,link=)]]
    67 , or by hitting the "A" key on the keyboard (the 2nd button should then be highlighted). 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 a node. A red dot (a selected node) should appear and a rubber-line span from that dot to the mouse cursor. If you create subsequent nodes, the earlier nodes will be shown as yellow dots.
     62To 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)''.
     63
     64Then 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.
    6865
    6966A series of joined nodes forms a way.
    7067
    71 === Adding Tags ===
    72 Ways or nodes on their own are not of much use unless they are ''tagged'' [wiki:Help/Concepts/Object#Tags to say what they represent]. The [osmwiki:Map_Features Map Features] page shows some popular tags, this page will never complete about all tags.
     68=== Adding Tags ===#AddingTags
     69Ways 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.
    7370
    74 The first step in adding tags is to be sure the [wiki:Help/Dialog/TagsMembership Tags/Membership Dialog] is open on the right hand side of JOSM. The [[Image(source:trunk/images/dialogs/propertiesdialog.svg,20,middle,link=)]] button on the left should be highlighted. If it is not highlighted, click on it or hit `Alt+Shift+P`. You will see the Tags/Membership Dialog, which has three buttons: [[Image(source:trunk/images/dialogs/add.png,20,middle,link=)]] '''Add''', [[Image(source:trunk/images/dialogs/edit.png,20,middle,link=)]]'''Edit''' and [[Image(source:trunk/images/dialogs/delete.png,20,middle,link=)]]'''Delete'''.
     71The 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`''.
    7572
    76 To edit the properties of a node or way (such as adding a tag) in the Tags/Membership Dialog, the way or node must be selected.
    77 1. ''Enter [wiki:Help/Action/Select Select mode] by clicking on [[Image(source:trunk/images/mapmode/move/move.png,20,middle,link=)]] of the left-hand icons or hitting the {{{S}}} key.''
    78 1. ''Highlight the way or point you wish to select. Click the [[Image(source:trunk/images/dialogs/add.png,20,middle,link=)]]'''Add''' button.''
    79 1. ''A [wiki: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 "highway," and for the value "secondary" (no 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=)]]
     73You 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**.
     74
     75To 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.
     761. ''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.''
     771. ''Highlight the way or node you wish to select, then click the [[JOSMImage(dialogs/add,20,middle,link=)]]**Add** button.''
     781. ''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).''
     791. ''Click OK. You have now tagged your way. You can add several tags to one object.''
     80[[Image(poi-restourant.gif,link=)]]
    8381[[Image(poi-fountain.gif,link=)]]
    8482
    85 [[br]][[br]][[br]]
     83=== Presets ===#Presets
     84Instead of adding tags manually you can also use [wikitr:/Help/Concepts/Object#presets Presets].
    8685
    87 === Presets ===
    88 
    89 [wiki:Help/Concepts/Object#presets Instead of adding tags manually you can also use Presets].
    90 
    91 All presets can be found: 1. from [wiki:Help/Menu main menu] (shown on the left below) 2. [Help/MainToolbar main toolbar] (no picture below). 3. {{{F3}}} shortcut (pop-up menu shown below on the right)
     86All presets can be found:
     871. at the [wikitr:/Help/Menu main menu] (shown below on the left)
     881. at the [wikitr:/Help/MainToolbar main toolbar] (no picture below)
     891. at the pop-up menu with the `F3` shortcut (shown below on the right)
    9290
    9391[[Image(presets-from-main-menu.png,link=)]]
    9492[[Image(presets-f3-search.png,link=)]]
    9593
    96 Presets for [Help/Dialog/SelectionList#Selection currently selected object(s)] are displayed above tags for current object (displayed in [wiki:Help/Dialog/TagsMembership Tags/Memberships Dialog]):
     94Presets 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]:
    9795
    9896[[Image(presets-in-tag-toggle.png,link=)]]
    9997
    100 === Left mouse click on respective preset heading will open complete preset view ===
     98=== Left mouse click on respective preset heading will open complete preset view ===#Leftmouseclickonrespectivepresetheadingwillopencompletepresetview
    10199
    102 [[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=)]]
    103101
    104 === Uploading to OSM ===
     102=== Uploading to OSM ===#UploadingtoOSM
     103If 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.
    105104
    106 If you are happy with all that you have done then you must upload your work to the OSM server. Click on the green up arrow [[Image(source:trunk/images/upload.png,20,middle,link=)]].
     105This 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.
    107106
    108 This will automatically trigger [Help/Dialog/Validator validation]. Review all validation warnings and resolve all errors ([Help/Preferences/Validator#Listoferrors Complete list of errors and how to fix them]) before you upload. This will prevent unfortunate mistakes such as un-tagged objects or unconnected roads.
    109 
    110 Before you upload, add a proper changeset comment and specify what 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.
     107Before 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.
    111108
    112109[[Image(uploading data.gif,link=)]]
    113110
    114 ''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.''
    115112
    116 If you need more details or have questions about upload process, it is precisely covered at [wiki:Help/Action/Upload Upload to OSM] page.
     113If you need more details or have questions about upload process, it is precisely covered at [wikitr:/Help/Action/Upload Upload data].
     114
    117115
    118116== Thank you! ==
     117Thanks for contributing to the OSM database. For more information see our [wikitr:/Help help page] or simply press `F1` over buttons or any interface element within JOSM. This will directly lead you to the respective help page.
    119118
    120 No matter if you pick JOSM as your main tool or as [osmwiki:Editors#Choice_of_editors one of many editors], don't forget to [wiki:Help use help page] or simply press {{{F1}}} over button or any interface element, because we had no time to cover all topics.
    121119
    122 == What next ==
    123 
     120== What's next ==
    124121=== Results of your job ===
    125 
    126 * Will appear at [http://www.openstreetmap.org/#layers= openstreetmap.org "Standard" layer within 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)
     122* Your changes will appear at the [osmwww:#layers= "Standard" layer] probably within a few minutes.
     123* Data in your routing software, maps and other services will be updated per each service (from minutes to days, weeks and months)
    128124
    129125=== Tell your friends ===
     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.
     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.
     129* OpenStreetMap is about the whole planet in the same way how your clock about the current time.
    130130
    131 * How it is easy to update data, how your results get displayed quickly. Truck drivers, couriers, photographers, bikers, journalists, fisherman and simply runners with GPS are always welcome in OSM.
    132 * Precise and actual information may affect how you make decisions in your life. The more people active in project - the faster data gets updated. And while [http://osmstats.neis-one.org/?item=countries&date= a few contributors can be called as "active"] at given point in time. Every small change advances OSM to complete and actual state
    133 * OSM data may be viewed as clocks: without an arrow you wouldn't know minutes. it's often gets outdated - simply refresh it, when clock "stops" we wind up.
    134 * OpenStreetMap is about whole planet in the same way how your clock about current time
    135 
    136 === Conventions in Creating Certain Types of Ways ===
    137 
    138 A couple of other points about creating ways.
    139 
    140 1. Dual-carriage ways (divided roads such as motorways, interstate highways, etc.) should be drawn as two separate parallel ways, with each carriage way being a different direction.
    141 1. If a street is one-way (including the individual carriage ways of a dual-carriage way), that way '''should be drawn in the direction of travel'''.
    142 1. Key-and-value tagging is case sensitive. All keys should be entered in '''lower case'''.
    143131
    144132= External links =
    145 * [https://github.com/mapbox/mapping/wiki/Mapping%20with%20JOSM Mapping with JOSM] with animations, by Mapbox team, covers mostly the same topics
    146133* [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
    147134
     135
    148136= See also =
    149 * [Help/Concepts/Object Objects in OSM data model]
     137* [wikitr:/Help/Concepts/Object Objects in OSM data model]
     138
    150139
    151140----
    152 Back to [wiki:/Help Main Help]
     141Back to [wikitr:/Help Main Help]