Changes between Version 45 and Version 142 of Introduction


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

Legend:

Unmodified
Added
Removed
Modified
  • Introduction

    v45 v142  
    11[[TranslatedPages]]
    2 = Introduction to JOSM =
    3 == Terminology ==
    4 '''Node:''' A "node" is a point.
     2[[PageOutline]]
    53
    6 '''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.
    74
    8 '''Relation:''' A "relation" is an ordered sequence of ways and nodes, a logical container used to group elements.
     5== Introduction to JOSM ==
     6=== JOSM Terminology ===
    97
    10 '''Area:''' An "area" is a way whose ends are connected.
     8 [[JOSMImage(data/node,middle,inline,link=)]] Node:: A node is a point.
    119
    12 '''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.
     10 [[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.
    1311
    14 Have a look at [Help/Concepts/Object Objects - The basic building blocks of OSM data and maps] for more information.
     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.
    1513
    16 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. (See [#ConventionsinCreatingCertainTypesofWays Conventions in "Creating certain types of ways"] at the bottom of this page for special considerations when creating a one-way road.) Other tags refer to being on the left and right of the direction of way along the way.
     14 [[JOSMImage(data/closedway,middle,inline,link=)]] Area:: An area is a way whose ends are connected.
    1715
    18 == Starting JOSM ==
    19 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].
     16 [[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.
    2017
     18If 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.
     19
     20
     21== Launch JOSM ==
     22JOSM is a Java program, can be obtained from the [wikitr:/Download#Recommendedoptions Download page] which contains download links and link to further help.
     23
     24If 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].
     25
     26
     27== Your first edit with JOSM ==
     28=== Welcome screen ===
    2129When 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.
    2230
    23 The next step is to download some data. If you have a GPX file (downloaded from your GPS receiver) for the area of interest, load it into JOSM using (File/Open). JOSM will display the area of the GPX file.
     31=== Downloading ===#Downloading
     32The next step is to download some data. You can practice using JOSM by downloading your neighborhood or locality you know or just recently visited.
    2433
    25 Next, add data for that area from openstreetmap.org. To select the area to download, first click on the "Slippy Map" tab at the top of the screen. A map of the world appears. To move around the map and select the specific area you want to download, there are several tools: Click with the right mouse button to drag the map, use the scroll wheel to zoom in and out, and click with the left mouse button to define an area. Then, click on the green down arrow [[Image(source:trunk/images/download.png)]] to fetch the data from openstreetmap.org.
     34==== OSM data ====
     35Next, add data for that area from main server, click at: [[JOSMImage(download,middle,20,link=)]] [wikitr:/Help/Action/Download Download from OSM] (`Ctrl+Shift+↓`).
    2636
    27 An alternative is to download existing GPX points from the OSM server. In order to start this process you will need to know the latitude and longitude coordinates of the relevant area. The easiest way to do this is to use the download dialogues slippy map in the first tab. [wiki:Help/Action/Download Read more on the download dialogue].
     37[[Image(download-data.gif,600,inline,link=)]]
    2838
    29 == Editing in JOSM ==
    30 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.
     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).
    3140
    32 '''Adding a Node or a Way'''
     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 map
     43* ''Use the scroll wheel to zoom in and out
     44* ''Click with the left mouse button and move the mouse to define an area.
    3345
    34 The first step of actual editing is to 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 or a significant change in direction of the way.
     46''After the "Download area too large" error disappeared and you selected a region, click "Download" to fetch the data from the main server.''
    3547
    36 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). 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 white 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.
     48=== Enable Aerial imagery ===#EnableAerialimagery
     49For 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.
     50
     51Imageries 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.
     52
     53[[Image(enable-imagery.gif,link=)]]
     54
     55When using imagery, keep in mind that imagery may be offset. That is, due to complexities in processing satellite imagery, features on imagery may not be at the same location as they are in the real world. For reference, check existing features in OpenStreetMap data and compare them with the imagery or download GPS tracks. To download GPS tracks from OpenStreetMap, check the "Raw GPS" box in the download dialog. If you observe an offset in the imagery, you can correct for it by selecting the "New offset" item in the "Imagery" menu.
     56
     57=== Editing in JOSM ===
     58JOSM 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 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.
     59
     60=== Adding a Node or a Way ===
     61The 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
     63To 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
     65Then 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.
    3766
    3867A series of joined nodes forms a way.
    3968
    40 '''Adding Tags'''
     69=== Adding Tags ===#AddingTags
     70Ways 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.
    4171
    42 Ways or nodes on their own are not of much use unless they are ''tagged'' to say what they represent. The Map Features web page [http://wiki.openstreetmap.org/index.php/Map_features Map Features] shows and explains all the current tags that could be used on a point or way.
     72The 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`''.
    4373
    44 The Properties Pane: The first step in adding tags is to be sure the Properties Pane is open on the right hand side of JOSM. The 8th button on the left (an icon with a wrench over a document) should be highlighted. If it is not highlighted, click the wrench button or hit "Alt+Shift+P." You will see the  Properties Pane, which has three buttons: 1) a plus sign with "Add" next to it, 2) "Edit" and 3) "Delete."
     74You 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**.
    4575
    46 To edit the properties of a node or way (such as adding a tag) in the Properties Panel, the way or node must be selected.
    47 1. Enter Select mode by clicking the first of the left-hand icons or hitting the "S" key.
    48 2. Highlight the way or point you wish to select. Click the "Add" button.
    49 3. A 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).
    50 4. Click OK. You have now tagged your way.
     76To 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.
     771. ''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.''
     781. ''Highlight the way or point you wish to select. Click the [[JOSMImage(dialogs/add,20,middle,link=)]]**Add** button.''
     791. ''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).''
     801. ''Click OK. You have now tagged your way. You can add several tags to one object.
     81''
     82[[Image(poi-restourant.gif,left,link=)]]
     83[[Image(poi-fountain.gif,link=)]]
     84
     85 \\ \\ \\
     86
     87=== Presets ===#Presets
     88Instead of adding tags manually you can also use [wikitr:/Help/Concepts/Object#presets Presets].
     89
     90All presets can be found:
     911. at the [wikitr:/Help/Menu main menu] (shown on the left below)
     921. at the [wikitr:/Help/MainToolbar main toolbar] (no picture below)
     931. with the `F3` shortcut (pop-up menu shown below on the right)
     94
     95[[Image(presets-from-main-menu.png,link=)]]
     96[[Image(presets-f3-search.png,link=)]]
     97
     98Presets 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]):
     99
     100[[Image(presets-in-tag-toggle.png,link=)]]
     101
     102=== Left mouse click on respective preset heading will open complete preset view ===#Leftmouseclickonrespectivepresetheadingwillopencompletepresetview
     103
     104[[Image(single-preset-shown-in-context-of-tagsmemberships-single-object.png,nolink)]]
     105
     106=== Uploading to OSM ===#UploadingtoOSM
     107If 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
     109This 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 seldom special cases.
     110
     111Before 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.
     112
     113[[Image(uploading data.gif,link=)]]
     114
     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].''
     116
     117If you need more details or have questions about upload process, it is precisely covered at [wikitr:/Help/Action/Upload Upload data].
    51118
    52119
    53 
    54 == Uploading to OSM ==
    55 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)]].
    56 
    57 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 of your edits. This description will be saved with your data on the server and provides information, for example, for the [http://openstreetmap.org/browse Recent Changes list].
    58 
    59 Click on "Upload changes" and your data will be uploaded, saved and visible to everyone else.
    60 
    61 See [wiki:Help/Action/Upload Upload to OSM] for further information on uploading.
     120== Thank you! ==
     121Thanks 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.
    62122
    63123
     124== What's next ==
     125=== Results of your job ===
     126* 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)
    64128
    65 == Conventions in Creating Certain Types of Ways ==
     129=== 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, fisherman 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.
     132* 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* OpenStreetMap is about the whole planet in the same way how your clock about the current time.
    66134
    67 A couple of other points about creating ways.
    68135
    69 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.
    70 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'''.
    71 1. Key-and-value tagging is case sensitive. All keys should be entered in '''lower case'''.
     136= External links =
     137* [https://www.mapbox.com/mapping/ Mapping with OpenStreetMap] with animations by Mapbox team covers mostly the same topics.
     138* [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
     140
     141= See also =
     142* [wikitr:/Help/Concepts/Object Objects in OSM data model]
     143
    72144
    73145----
    74 Back to [wiki:/Help Main Help]
     146Back to [wikitr:/Help Main Help]