##How to get started contributing to a Humanitarian OpenStreetMap Team task
OpenStreetMap (OSM) is an open-source map of the world that anyone can edit. But like any map, it's incomplete.
The Humanitarian OpenStreetMap Team (HOT) helps organize people to improve the OSM map for crisis areas, mostly so aid workers can find their way around and make decisions about undermapped places. The data in these crisis areas is often very poor, or completely non-existent. Therefore any contribution you make at all will be a vast improvement, and could materially help people who are on the ground right now, looking at this data as you edit it, and deciding where to go and who to help.
There are many HOT tasks active at once. As of August 2014, the highest-priority tasks are Gaza and areas affected by the West African Ebola outbreak.
###Tasks and Tools
The HOT Tasking Manager has a list of current tasks. They all split a given area into a number of sub-tasks. Each of these areas needs some kind of mapping work – common tasks include tracing roads or buildings from satellite imagery, or identifying residential areas. Some tasks are easier than others; if you don't feel up to one of them, simply cancel out and try another!
All of these tasks involve editing OpenStreetMap. The two most popular tools for doing this are iD, a web-based tool created by Mapbox, and JOSM, a java app pronounced "jaws-um". Both have their quirks: iD has a very user-friendly interface which requires zero setup but doesn't allow much in the way of power usage, which can result in slower (but safer) mapping; and JOSM is notoriously user-surly but is super-fast for some situations, once you get all the kinks ironed out.
###Setting Up JOSM
As iD is fairly self-explanatory, I'll list a few tricks to get JOSM working for you. Here's a sample process to get JOSM set up to easily map buildings, as in the Gaza tasks.
- Create an OpenStreetMap account.
- Install or update Java.
- Install JOSM.
- Start JOSM and open Edit > Preferences.
- In the "Connection Settings" pane (globe icon), enter your OSM login information.
- In the "Plugins" pane (power plug icon), click the "Download list" button.
- Search for "Buildings" in the plugins list, and when it is found, check the box.
- Click the "Update Plugins" button, and when prompted, restart JOSM.
- In the "Remote Control" pane (third from the bottom), check the "Enable remote control" box.
That should be the extent of the setup.
###Choosing a Task
- In the HOT Tasking Manager, select a project, and read the instructions.
- Click either the "Start Contributing" button at the bottom or the "Contribute" button/tab at the top.
- Select a task – you may have to zoom in on the map to see individual task tiles, and you may wish to choose one inside a pink "high priority" area.
- Click "Start Mapping" to lock the task, and proceed to the editor-picking screen.
- Choose "JOSM" from the dropdown, using the small black arrow to the right of the editor name.
- Click the "Edit with JOSM" button.
This will open the editor and load the satellite imagery and any existing OpenStreetMap data. You may need to manually switch to JOSM to see it.
###Editing the Map
These are the shortcuts I use:
- right-click to pan
- mousewheel to zoom
- "S" select tool
- "B" buildings tool
- "A" line-drawing tool
- control-shift to rotate a selected object
- "P" to separate a selected node from a selected line
- "J" to join a selected node to a selected line
About the buildings tool: this speeds the drawing of a right rectangle with a "buildings = yes" tag. If you select an existing right-rectangular-area with the "S" select tool, and then draw a building with the "B" buildings tool, it will auto-align the new building to the old one.
When you are finished, click the "Upload button" (fourth from the left in the toolbar).
If there are no problems:
- Add a comment such as "Added buildings" in the space for comments.
- For the data source field, click the "obtain from current layers" link.
If problems are detected, further action may be required. "Unnamed ways" are generally fine to ignore, but "Crossing buildings" or "Untagged ways" should be fixed. If those problems exist:
- Cancel the upload window.
- Check the "Validation Results" pane in the lower-right of the app, and expand the "Warnings" list entry until you find groups of ways.
- Select the group with the "Select" button or by double-clicking the list entry.
- Zoom to the problem area with the "3" key, and fix the problem.
- If the problem is an untagged way, select the line, then go to the "Tags" pane in the upper-right corner of the app and click the "+ Add" button.
- Add a tag: the key will be "highway" and the value will most likely be "residential", "service", or "track". Check neighboring roads to see what the local convention is.
- Re-attempt the upload.
When the upload is successful, return to the tasking manager and click the "Mark the task as done" button.
It's no problem if you don't finish the task; just upload what you've done and unlock the task so others can work on it.
###Words of Encouragement
The satellite pictures are sometimes difficult to interpret, but don't worry too much about drawing the perfect line or shape – your work will be reviewed and modified by others, and improved with time. And remember, these are crisis areas, not tax records or voting districts – these maps will be read by people who may be in a hurry, in the dark, or in danger. In West Africa, even a rough line on a map is an expression of hope. In Gaza, many of the buildings to be mapped are already gone; but we mark the fact of their construction. Accuracy is nice, but it isn't the point.
If you'd like to see examples of the quality of work that passes muster, check out one of the green "validated" tasks. Don't worry, clicking the "Review the work" button doesn't commit you to anything – it just locks the task as though you were editing it. Load it like normal, and simply unlock the task again when you're done.
This can be hard work, but flow state is possible. If you have any trouble with this process, send me a note and I'll try to help troubleshoot. I welcome feedback on the instructions. (Thanks to @fishpatrol and @eldang!)
If you'd like a more detailed introduction to the world of OSM, there are quite a few overviews and tutorials, notably:
- MapGive's Learn To Map tutorial - http://mapgive.state.gov/learn-to-map/
- OSM's collection of video tutorials - http://wiki.openstreetmap.org/wiki/Video_tutorials
- OSM's Beginner Guide - http://learnosm.org/en/beginner/
Good luck, and thank you.
Peter (@meetar) firstname.lastname@example.org