Make any GeoJSON file into a MapRoulette challenge with little effort.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Create a MapRoulette challenge from a GeoJSON file or gist with little effort!


  • Clone the repo
  • cd geojson2maproulette
  • Install the requirements: pip install -r requirements.txt


Let me explain how this works with an example. OSM user bitnapper proposed a challenge for adding multilingual names to places in Ireland a while ago. If I understand her or his request correctly, these are OSM place nodes that have a name tag but perhaps not a name:ga tag for the Irish name. (name will hold the local name, which is nearly always the English name.) These nodes can be isolated with an Overpass Turbo query like so:

Untitled<script async src="//" charset="utf-8"></script>

Overpass Turbo lets you save the result as a GeoJSON gist easily using the export function:

Untitled<script async src="//" charset="utf-8"></script>

To make it a bit more manageable, I adapted the query to only cover county Cork - still over 2400 nodes. Here it is exported to a gist:

Untitled<script async src="//" charset="utf-8"></script>

It's nice of Github to show this on a map, but what we need is the actual GeoJSON. This is accessible by clicking the Raw button. This will lead you to the URL of the raw GeoJSON, which is what we need as input. (We could also have saved it as a local file. geojson2maproulette supports that too.)

Now we have the first ingredient ready. The second ingredient is a configuration file for geojson2maproulette. For some examples, look in the samples/ directory. You will also find the configuration file we use for this example there. The configuration files are in the easy to understand YAML format, and the samples should be descriptive enough to get you started. Here is the config file for our example in full:

# the base URL for the MapRoulette server API to call
server: "http://localhost:5000/api"

# server API admin credentials. Can be anything if you're testing on localhost.
user: devuser
password: mylittlesony

# source file or URL. You can give a list of URLs too, all data will be gathered and added to the same challenge.
source_url: ""
# source_file: ....

# source geojson property key to use as your task identifier (optional, will use random UUID if not given)
# identifier_property = ...

# Challenge metadata, see for background
slug: cork_multilingualnames
title: Places without Gaelic names in Cork
instruction: See task
help: "Many `place` nodes in Ireland have only a `name` but not the corresponding `name:ga` representing the Gaelic name. Please help complete the multilingual map of Ireland by adding these names if you know them."

# task level instruction, can include {} as placeholders to be expanded by an equal number of properties from the GeoJSON file
  text: "The is place has a `name` tag **{}** but no `name:ga` tag for the Gaelic name. If you know it, please add it. Or perhaps [Google knows]({}+gaelic)?"
    - name
    - name

The first section provides the server API endpoint and API credentials. You can get those for by getting in touch with me.

The next part is the link to the GeoJSON source file. This can be a single URL or a list. Alternatively you can provide a local file here as well.

Lastly, the challenge metadata. See the MapRoulette tutorial for more details about these important fields. The most tricky part here is perhaps the instruction. I am using an instruction unique to each task, and I want to use the content of the name tag in the instruction text. For that I use {} as placeholders in the instruction string, and the keys of the GeoJSON properties to use to expand these placeholders.