In this QuickStart Guide we will practice some of the basics of editing in JOSM with task _____.
[show task link: EXAMPLE-http://tasks.hotosm.org/project/971#task/29]
This is a good practice task because it’s relatively simple-- highways, settlements and buildings take priority.
Start JOSM and in the top menu (under JOSM) go to preferences and from there we will click on the "settings from the remote control feature" (second from the bottom), which allows JOSM to be controlled from HOT
Here we just want to make sure "enable remote control" is selected.
Next we want to add a plugin so while still in the preferences window we go to the 4th option from the top “configure available plugins”
Next we click the “Download" list button to download and display a list of available plugins. They’ll load in alphabetical order. Select the buildings_tool and click the OK button below.
It will let us know it’s been downloaded.
And now we go to task page on the Tasking Manager Site: http://tasks.hotosm.org/project/917
(show link)
If you haven’t already log in to OpenStreetMap in the right hand corner, logging in allows us to edit.
Read the instructions. Click on a tile, click on “start mapping”, select edit with JOSM.
Switch windows back to JOSM and you'll find its pulled in the existing OSM map for the tile from the OSM server.
In the top menu select Imagery and then Bing. Note that in the mapping instructions it tells us the imagery source is from Bing.
###A Basic Note on Navigating JOSM
Now we will trace over the image. We’ll use two buttons in top left corner. The first is the select button; its shortcut is the letter S
We will also use the draw nodes button and its shortcut is A.
See a chart of JOSM shortcuts at this link: http://josm.openstreetmap.de/wiki/DevelopersGuide/ShortcutsList
Zoom into the image. Some prefer to zoom into so that 90 meters shows on the scale.
The following is a quick way to get started drawing map features and adding tags/labels afterwards.
Next, you draw around each settlement but don’t tag it. If you're lucky enough to find a road joining settlements draw the highway in again but don't tag it. As you go draw around each settlement you see on the road. Stick to one type of highway omit the others for the moment.
For rectangle buildings press b for the building plug-in, now find the longest side and mouse click one corner, follow the edge to the next corner then click again, now drag the mouse to the other side. Click once more and the building is done and correctly tagged for HOT.
Next we will add labels to our edits with tags. Go to the upload button is the fourth button from the left near Tools.
When you click this button it will try to automatically validate your data and give you a warning since we haven’t added tags. Click cancel the upload.
Back in the JOSM editor on the right you'll see a Validation Results box. When we click on the warnings it will show the ways and highways we left untagged.
Select untagged ways. Above in the tags box select Add landuse=residential to them all.
Then select the validation button to save these tag label changes.
If we were working with highways we could try the same thing.
[OR insert highway example here]
Now upload again.
You'll notice that JOSM already has the source of the image filled in and the HOT tile etc. It may ask for your osm username and password again.
Now you can go back, draw other features and then tag them after JOSM runs its automated validation warns you, then you can tag them all at once.
There is a lot more to JOSM but this guide's objective is to get you going productively quickly.
Special Thanks to John for coming up with the basis for this tutorial.