Changes between Version 20 and Version 21 of Introduction
- Timestamp:
- 2009-04-25T14:01:23+02:00 (16 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Introduction
v20 v21 2 2 = Introduction to JOSM = 3 3 == Terminology == 4 5 4 A "node" is a point and a "way" is a line connecting multiple nodes. This means "way" is a general term for series of joined nodes, not only for roads or ways in reality. A "relation" is an ordered sequence of ways and nodes, a logical container to group elements. An "area" is a way whose ends are connected, but other than that isn't special. 6 5 … … 8 7 9 8 == Starting JOSM == 10 11 JOSM is a Java program, and comes in a .jar file. If you don't know how to start it, ask someone familiar with your platform how to run a Java program. 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 harming anything. Subsequential actions on a single element will go into the database as a single modification when uploaded. 9 JOSM is a Java program, and comes in a .jar file. If you don't know how to start it, ask someone familiar with your platform how to run a Java program. You might also want to read the [InstallNotes#Running install notes]. 12 10 13 11 When JOSM starts up, 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. … … 18 16 19 17 == Editing in JOSM == 18 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. Subsequential actions on a single element will go into the database as a single modification when uploaded. 20 19 21 20 The first step of actual editing is to add a node to the OSM data where there will be a junction or a significant change in direction. To add a node, highlight the node button, either by clicking the 2nd button in the left menu bar, or by hitting the "A" key on the keyboard (the 2nd button should then be highlighted). Move the mouse cursor over your GPS track, and left click it wherever you want a node to be. A white dot (a selected node) should appear and a rubberline span from that dot to the mouse cursor. As you create subsequent nodes the earlier nodes will be shown as yellow dots. … … 30 29 If you are happy with all that you have done then you need to upload this to OSM server. Click on the green up arrow [[Image(source:trunk/images/upload.png)]]. 31 30 32 JOSM now performs a quick check on the data you're about to upload. If it finds warnings or errors you'll be presented with a list of them and get the chance to correct the problems and try again or upload anyway. It's not necessary to fix all of that, but please don't go over it easily, especially not the errors.31 JOSM now performs a quick check on the data you're about to upload. If it finds warnings or errors you'll be presented with a list of them and get the chance to correct the problems and try again or upload anyway. 33 32 34 Finally JOSM will present you a list of changed or newly created elements for reviewing it. You're also asked to provide a short freetext summary of your edits. This description will be saved with your data on the server and serves information purposes like for example the [http://openstreetmap.org/browse Recent Changes list]. If you fixed an error in the data by deleting a way not existing anymore in reality, this is something you should definitely mention.33 Finally JOSM will give you an overview on the elements that will be uploaded. You're also asked to provide a short freetext summary of your edits. This description will be saved with your data on the server and serves information purposes like for example the [http://openstreetmap.org/browse Recent Changes list]. 35 34 36 35 With your final click on "Upload changes" your data will be uploaded and visible for everyone else. 37 36 38 Please be careful with editing and uploading data. When in doubt if everything is ok, rather refrain from uploading and save the area locally on disk to check back to it later. 39 40 There is no simple answer to the question when and how often to upload. You neither should edit the whole day and then upload everything at one nor upload every minute after adding a way. The former to keep data in memory small, make uploads faster and minimize the risk of your edits colliding with someone else editing the same ways in the same area. 41 The latter to minimize the overhead each upload poses on the server in means of CPU time and also database size since each change also means processing and saving some meta information. 42 43 If possible group your edits. In logical as well as in geographically units, this also makes it easier to give a good upload summary. 44 37 See [wiki:Help/Action/Upload Upload to OSM] for further informations on uploading. 45 38 46 39 == Conventions ==
