OSM Tasking Manager

From OpenStreetMap Wiki
Jump to: navigation, search
Available languages — OSM Tasking Manager
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 may need to setup your editor when you start a new job.

iD Editor

The task bounding box should display automatically in iD.

JOSM - Setup and Offset DB

Potlatch 2 - Adding Grid Square

Open vector p2.png
Grid in p2.png

Potlatch will not automatically display the task bounding box, but you can do so by following this procedure:

  1. In the Tasking Manager, select a square and click Start Mapping to lock it
  2. In the Tasking Manager, select Edit with JOSM (if a window appears saying "JOSM remote control did not respond..." just click OK).
  3. Below the Edit with JOSM button, text will say "Tip: Download the following .gpx file...". Download the .gpx file, and note where it is saved.
  4. In the Tasking Manager, change from Edit with JOSM to Edit with Potlatch 2. Potlatch should open in a new tab.
  5. In Potlatch, select Background, then Vector File...
  6. In the Load Vector File window, at the bottom next to File, click Open, and navigate to the .gpx file you just downloaded
  7. In the Load Vector File window, make sure the box is checked in the Show column for the .gpx file, then close the window
  8. Potlatch should now display the boundary as a square (probably cyan). Note that Potlatch will still load data outside the boundary.
TM myprojects.png

Feedback from the validator

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.