OpenStreetMap logo OpenStreetMap

MapRoulette Insider - Creating a Challenge

Posted by mvexel on 6 November 2018 in English.

In this post, part of the MapRoulette Insider series, I will show you how to create a MapRoulette Challenge yourself.

The first thing you need is a Challenge idea. Good challenges have tasks that:

  • Are easy to solve (typically less than one minute)
  • Do not require local knowledge
  • Involve only one or two OSM objects

My example challenge meets those criteria. I ask mappers to review motorway_junction nodes in the United States that have name tags. This is uncommon in the U.S. Often mappers will add a name tag that has the destination information on it, so the information renders on the map:

This Overpass query selects all these nodes.

area[name="United States of America"]->.a; node["highway"="motorway_junction"]["name"](area.a); out meta;

With that query in hand, I can go to MapRoulette and click ‘Create’ at the top. This takes you to your MapRoulette Projects page. By default you will only have one Project. Click on its name to select it as the home for your new Challenge. At the top of the Project page, you will find the ‘Add Challenge’ link, click that to start the wizard to add a new Challenge.

The Wizard has 4 pages, but only the first two require your full attention :)

On the first page you enter the title, description and instruction for your challenge, as well as some metadata that will be used to help others find it and identify edits made by mappers using the Challenge:

  • Visible Whether the Challenge will be listed. If no, you can still share the Challenge URL and it will work.
  • Name A descriptive name for the challenge. I used Review named motorway junctions in USA. A good title describes what the challenge is about is a few words.
  • Description Some text to describe in more words what the challenge is about. This field supports markdown and appears in the expanded challenge information when mappers browse for interesting challenges:

I used Motorway junction nodes are not commonly tagged with name. This challenge asks mappers to review those nodes, removing the name where it’s not applicable.

  • Blurb Feel free to skip this. An even shorter description of what the challenge is about. I used Review named motorway junction nodes
  • Instruction This is perhaps the most important text. Here you tell mappers exactly what the task is you want them to perform. Be specific and use links (this field supports markdown as well) to the OSM wiki or other external sources where needed. This text is shown next to the map of the task location. I used This motorway_junction node has a name tag. This is uncommon, see the OSM wiki for details. If this name tag does not represent a ‘name of the junction or interchange’, the name tag should be removed. If you’re not sure, you can skip the task.. Note how I use markdown features to make the instructions easy to read and comprehensive.
  • Changeset Description This field will be used to pre-fill the changeset description in the editor. I used reviewing named motorway junctions. A #maproulette hashtag will be added unless you change that default setting below.
  • Changeset Source This field will be used to pre-fill the changeset source field in the editor. If your task involves using any external data, you should list it here. I used maproulette;overpass.
  • Difficulty You can leave this at ‘Normal’ unless your tasks are particularly easy or hard. We may change this system in the near future..
  • Category This helps the user find challenges they are interested in. There is a dropdown menu on the main Challenge list that lets users narrow down the list by category. For this challenge I used Roads / Pedestrian / Cycleways.
  • Keywords These also help users find interesting challenges. They are used in the free text search field. I used junction, name, motorway and exit.

When all this is filled out, you can proceed to screen 2, where you supply the source data for the tasks. This can be a GeoJSON file or URL, or an Overpass query. If you use an Overpass query, make sure you don’t use any Overpass Turbo specific language such as {{geocodeArea:...}}. Test your query in Overpass Turbo first.

The final two screens let you add rules to prioritize certain tasks over others based on OSM tags, and let you define some view related settings for your challenge. The defaults are sensible but please do review them and tweak as needed. Make sure that the query only returns the nodes or ways that you want mappers to review, and ideally the number of objects returned should be no more than a couple thousand.

When you click ‘Finish’, MapRoulette will query Overpass in the background and populate your challenge. Depending on how heavy the Overpass query is, this can take a few seconds to a couple of minutes. When it finishes, you will see a map with your tasks, a complete list of tasks and some more challenge information.

You can now click ‘Start’ on the top to go directly to your challenge and try it out!

Discussion

Comment from Túllio on 7 September 2019 at 14:17

Congratulations for the initiative! I would like to create a challenge to update tags in Brazil, but I still don’t know how to use GeoJSON. Could you give me a hand?

Comment from Mateusz Konieczny on 15 July 2020 at 20:03

GeoJSON docs are a bit hidden in challenge creation progress.

For example

You can also reference feature properties from your GeoJSON with simple mustache tags: e.g. {{address}} would be replaced with the value of the address property, allowing for basic customization of instructions for each task. This field is required.

Comment from Leslie2021 on 3 February 2021 at 22:19

I don’t have an Add Challenge button at the top of the Create & Manage/ Project page. How do I activate it? Leslie2021 DOT

Comment from mvexel on 3 February 2021 at 23:24

Hi Leslie2012 – the screenshots in this post are older and the interface has changed some. If you click on your user profile and then on ‘Create and Manage’ you should see your default project. If you click on that you should see something like this

That is where you would create a new Challenge from.

Let me know if you have any questions.

Comment from tekim on 28 December 2021 at 18:21

Hi Martijns, Is there any way that MapRoulette could be used to do an import (after going through the appropriate reviews and approvals of course)? This would require the feature to be imported, such as a building footprint, be loaded into the editor (JOSM, iD) along with the existing OSM data so that the user can review whether the feature should be imported (in JOSM two data layers can be merged). Thanks, Mike

Comment from mvexel on 28 December 2021 at 18:38

Hi Mike, if you want to do a ‘manual import’, say, having mappers evaluate and import building footprints one by one, yes, that can certainly be done. This is described in https://learn.maproulette.org/documentation/creating-cooperative-challenges/#content — however, the only editor that currently supports this is JOSM. Let me know if you need any help with this, Martijn

Comment from Airfall on 22 October 2022 at 01:46

Hey mvexel, I don’t know if you’re the right person to ask about creating Map Roulette challenges, but this is the first thread I could find. I’m trying to set up some challenges to keep track and work on adding buildings to unmapped neighborhoods. However, when I make an overpass query that calls the neighborhood relation and then the residential landuse features in that area, Map Roulette seems to call the nodes that make up the ways instead of the actual ways themselves.

For example, if I have an overpass query of

rel(9572358); map_to_area -> .a; way(area.a)[landuse=residential]; (._;>;); out;

https://overpass-turbo.eu/s/1mWW

it desplays exactly what I want, the residential areas within the selected relation, but, when I copy paste that into Map Roulette to make a challenge it spits out the nodes instead.

https://maproulette.org/browse/challenges/29696

I’ve tried setting the overpass target type in the challenge creation to “Ways” as well but that just outputs an error message that I don’t have any ways called in the query. I was wondering if I’m making a mistake and calling the nodes somehow instead of the ways. I’ve tried to edit the overpass query so many times, but it will always seem to only display nodes when I put it into Map Roulette. Just wondering if someone who’s used it more has some idea what part I’m messing up in, no rush or anything though (I know this is some serious necro-posting on a 4-year-old thread, super sorry about that!).

Thanks and all the best!

Airfall

Comment from mvexel on 22 October 2022 at 03:10

Airfall: Try out geom instead of ; (._;>;); out;.

See ‘Beware of recursions’ on this page in the docs.

Hope this helps!

Comment from Airfall on 27 October 2022 at 02:23

That did it! Thank you so much mvexel! You’re the best!

Comment from ealp on 17 June 2023 at 15:42

Hi Martijn, I’m helping to set up a project for a mapathon in Mexico that aims to add POIs related to public infrastructure and services for women. I can easily create projects, but I don’t think I have the option to add challenges:
Alt text When I go to “manage challenges” it only lets me add existing challenges, not create them. Do I need to get approved to have this functionality?

Log in to leave a comment