OSM Tasking Manager

From OpenStreetMap Wiki
Jump to: navigation, search
Available languages
English русский
Job in progress on OSM Tasking Manager
The OSM Tasking Manager is a mapping tool designed and built for the Humanitarian OSM Team collaborative mapping. The purpose of the tool is to divide up a mapping job into smaller tasks that can be completed rapidly. It shows which areas need to be mapped and which areas need the mapping validated.

This approach facilitates the distribution of tasks to the various mappers in a context of emergency. It also permits to control the progress and the homogeinity of the work done (ie. Elements to cover, specific tags to use, etc.).

Logging On

The OSM Tasking Manager requires you to logon using your OSM ID.


Jobs are setup as the need arises. Each job will have a description of what is required and if necessary details of how to add the relevant imagery into JOSM/Potlatch.

Each Job is then subdivided into a number of tasks designed to be manageable in size.


Setting up your editor

To use the Tasking Manager efficiently you will need to setup your editor when you start a new job. See:

Taking a Task

To take a task select the job from the Tasking Manager homepage.

  • An Area to work on will be allocated automatically when you click the Take a Task button. If you have indicated that you are an advanced mapper, then this may be an area to do or an area to validate, otherwise you will be given an area to do.
  • Alternatively, you may click a square on the map to select the Area to be allocated. This let you work in contiguous areas.

OSM Tasking Manager Take a Task.png

New to mapping for HOT

If you are about to start mapping for HOT for the first time it is suggested you chose the Task which is the top task in the 'Featured Jobs' list, and that you select a square which is as close to the top of the grid as you can. Validators will be checking this area most frequently ready to provide advice and feedback.

Doing a task

When doing a task you should map all the features indicated on the job description.

If you are unable to complete all of the area then you should upload the features you have added to the map and 'unlock' the task. This will enable other mappers to pickup the area and continue.

OSM Tasking Manager Job Done.png

Adding the grid square to Potlatch

  • Open the task in potlatch2 as normal.
  • Go back and find the "Link to .osm file" link on the Tasking Manager job page. Right click to copy the URL of the link
  • In Potlatch2, click the Background button and Vector File

Open vector p2.png

  • In the text box next to File and the button "open" paste in the URL into the box. (1)
  • Click the fetch button (2) on the right of this text box. A new "export.osm" entry should appear in the list, and the square should appear on the map
  • Uncheck "select" from the column on the left for this export.osm (3)

Grid in p2.png

Finishing a square

  • Once you have completed the area upload the data in OSM, then mark the square as complete by clicking on the green icon & add a description.
  • If it's not complete, then unlock it & add a comment about what needs to be done.
TM Task done.png

Feedback - When your square has been validated it will turn green or back to white

To see what the validator has typed in the square, click on it

TM Feedback.png

Validating a task

Worth reading so you know what happens & what is being considered. See OSM_Tasking_Manager/Validating_data

Further Help

Partially mapped & validated task on OSM Tasking Manager

If you need further help on mapping an area see:


The tasking manager was designed and built for the Humanitarian OpenStreetMap Team and is still under active development.

The main developer is User:Pgiraud

Source code (Python) is on github: https://github.com/hotosm/osm-tasking-manager

Issues & bugs area also managed on github: https://github.com/hotosm/osm-tasking-manager/issues

A dev/testing instance of the task manager is running here: http://tasks-dev.hotosm.org Sometimes this is with a later version of the code (Note. Don't use the jobs/tasks on here to track actual mapping. It's a separate test database)