Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
74 lines (51 sloc) 7.57 KB

Map making workshop – from Wikidata to interactive off-Wiki maps in three steps

Latest update: 21 November 2019

Workshop description

In this 90-120 minutes workshop you will learn how to make both flat, clustered, layered, embedded, interactive, on-Wiki and off-Wiki maps from sets of geo-referenced (P625) items in Wikidata.

You will do this in 3 modules of approx. 30-40 minutes each:

  • Module 1: You will start by making various basic flat and clustered maps in Wikidata using SPARQL queries. Next you will make some layered maps, where groups of items can be toggled on/off in the map.
  • Module 2: After having explored maps in the Wikidata query interface, you are now ready to learn how to embed Wikidata-driven maps in other Wikimedia projects, such as Wikipedia and Commons (examples). In addition to SPARQL we will look at OpenStreetMap, GeoJSON and the Mediawiki Kartographer extension.
  • Module 3: Finally you will learn the steps for creating interactive, layered Wikidata-driven maps that can be used off-Wiki, ie. in regular HTML pages. In addtition to the above tools & techniques, we will use some basic Python, Jupyter Notebooks (PAWS), Jupyter-Leaflet and Jupyter-widgets.

See the full outline of the workshop for a more detailed description.

Intended audiences

While this workshop is tech-focused and will discuss basic Wikidata, Wikipedia and Wikimedia Commons techniques and programming tools, it is meant to be approachable by beginning Wikidata contributors and programmers. The workshop leader, by no means an advanced Python programmer nor Wikidata nor SPARQL guru himself, is providing examples and code snippets that you can easily adapt yourself with basic SPARQL, Wikidata and Python skills, to make them work for your own datasets.

As the workshop is comprised of three 30-40 minute modules, you can decide to skip the modules that you find too advanced (or basic) for your individual knowledge level.

Learning objectives

After the workshop you will

  • Understand the steps to make basic flat and layered maps in Wikidata, based on geo-referenced (P625) items and SPARQL queries (Module 1, basic)
  • Understand steps to embed maps in Wikimedia sites like Wikipedia, Wikimedia Commons and Wikidata (Module 2, intermediate)
  • Understand the steps to create Wikidata-based maps than can be used in other (non-Wiki) websites (Module 3, advanced)
  • Have access to map making resources, SPARQL examples and Python code snippets you can build upon for your own projects.

Required preparations

In order to have an effective workshop, you will need to do some preparations before you start:

  • Identify a geo-referenced (P625) set of coherent items in Wikidata to work with. Aim for 100-500 items or so. (some examples)
  • Create an account on Wikidata/ Wikimedia, if not yet done so.
  • For Module 3, set up a working PAWS server and notebook (Help 1, Help 2, Help 3) – only needed if you plan to do this module. Instead of running this notebook cloud-based on PAWS, you can also run it on a local Jupyter Notebooks installation, such as Anaconda

Workshop outline & resources

For entire workshop

For Module 2

For Module 3

Workshop leader and contact details

This workshop is given by Olaf Janssen, Wikimedia coordinator of the national library of The Netherlands


So far, this workshop was given during

Note 21 Nov 2019: The above pdfs might contain some broken links and/or outdated screenshots due to recent updates of the workshop materials. Always check the generic workshop pfd for the most up to date slides .

It will also be given during

Reusing workshop materials

You are free to reuse all workshop materials, as they are available under the license Creative Commons Attribution-ShareAlike 4.0 International

CC-BY-SA logo

You can’t perform that action at this time.