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.).

Please see Tasking Manager at LearnOSM Many sections of this wiki entry are now out of date, and the entry at LearnOSM is more recent & should be referred to.

Setting up your editor

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

JOSM Offset_db

For using the JOSM offset database see OSM Tasking Manager/Offset_db

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

Feedback from the validator

TM myprojects.png

To see only the projects you have already worked on, tick the 'Your projects' box.

Locating just the squares (Tasks) you have completed

TM myprojects 1.png

Click on the heading for one of the projects you have completed a square(s) for , then click on the Stats tab, and scroll down until you can see the users that have worked on this project, locate your user name in the list, and hover the mouse pointer (don't click, just put the cursor over) over your username. All of the squares that have been completed will fade, leaving only your squares visible. Move the mouse over the the square you completed, then click on the square & you can see all the comments relating to that square. If the square is green, it has been validated & the validators comments / feedback are visible to you. There may be links for you to follow if any feedback is being given.

Validating a task

Please see OSM_Tasking_Manager/Validating_data

Further Help

Job in progress on OSM Tasking Manager

If you need further help on mapping an area see:

Beginners Guides to mapping with H.O.T


LearnOSM is the principle guide recommended by HOT. As well as overviews of the process there are specific sections on;

In development & mainly dealing with JOSM, but also includes information which will be useful when using the iD editor, guide in development. Use with caution - this is still in the 'construction phase', but it may help you if you are just starting to learn to map for H.O.T. Work in progress can be found at User:Tallguy/Thoughts_&_ideas/Beginners_guide


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-manager2

Issues & bugs area also managed on github: https://github.com/hotosm/osm-tasking-manager2/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)

Operational installations of the Tasking Manager

note: Some instances are with Tasking Manager v2; others are still under Tasking Manager v1.