(Redirected from OpenStreetMap)
Jump to: navigation, search
Openstreetmap logo.svg

OpenStreetMap and Wikimedia are collaborating at multiple levels, many times thanks to individual efforts of volunteers, sometimes through formal projects involving the Wikimedia Foundation or chapters.

Let's map this collaboration. Every entry should have a wiki page, a bug report or a URL somewhere.

Current Status[edit | edit source]

Maps servers are live at (not linking because it will show an error on click due to referer check)

They are in a "EXPERIMENTAL" mode, which means we are actively working on them, changing some features, and sometimes introduce breaking changes. Also this means that they will NOT handle Wikipedia traffic. Moreover, it is restricted to be used only from * and * (referer header must be either missing or set to these values)

Maps are capable of serving tiles & static images. For tiles, use{z}/{x}/{y}.png or with the optional scaling factor -{z}/{x}/{y}@{scale}x.png. The static images are at{z}_{lat}_{lon}_{width}x{height}.png (also with an optional scaling factor)

Use cases[edit | edit source]

Please add any other use-cases you think would be beneficial, including links to anything similar.
Also, please indicate who would benefit/what community would like to participate, and if you want to take part in this effort
  • An editor wants to easily add a map to a Wikipedia article without leaving the Wikipedia site.
  • A reader wants to zoom and pan a map in a Wikipedia article.
  • A reader wants to see a zoomable, pannable map immediately when they click geo-coordinates on an article.
  • An editor wants to add geographic information about the location where they currently are.
  • A reader wants to navigate articles with an atlas (instead of typing a page name or URL, zoom and pan a map, and click pins)
  • A reader wants to browse Wikimedia Commons images on a map.
  • A reader wants to visualize geospatial data (country and city outlines, river courses, habitats for animals etc.)
  • An article shows interactive historical maps for certain areas. The map can contain annotation layers, POIs, routes, data layers etc. to illustrate the article topic. An editor wants to create these maps. (Taking part: Susannaanas (talk))
  • A historical map file can be displayed overlaid on a slippy map in the file display (file page / media viewer). Wikimaps design doc. (Taking part: Susannaanas (talk))
  • A reader/Commons user/editor wants to find scanned maps by selecting the area on a slippy map. Wikimaps design doc. (Taking part: Susannaanas (talk))
  • A reader can explore complex shapes (highways, geographic borders etc.) inside the infoboxes much better by using a slippymap than a static image. (need support for: kml, geoJSON, topoJSON)
  • An editor wants to add and edit maps using VisualEditor. We already have some proof of concept code so we just need some API endpoints. ESanders (WMF)
  • User Mey2008's WikiVoyage dynamic maps, such as POI Map, Art Map, and Monument Map (RU).
  • Show Raster imagery of earth, e.g. from Natural Earth, and other planets/celestial bodies. Overlay them with useful info.
  • An editor want's to add coordinate information to a photo on Commons or wants to easily justify it.
  • An editor wants to specify a map on wikidata so it can be reused on any of the wikiarticles associated with that wikidata item. One wikidata item may have multiple associated maps - location map, current borders, historic borders (start date =?), etc. each with a specification stored on wikidata. These specifications specify what layers are to be used, from where (OSM or OHM or other) but probably don't include the map data.
  • An user of Wikivoyage want to have a strong combination of an article and a map as a travel guide.
  • An editor want to create a complex, individual map to show relations of objects that are mention in a article, see UMAP.
  • A user want to see the map in a language that he can read, see OSM:Multilingual_maps_Wikipedia_project.

Mobile app use cases[edit | edit source]

  • User is able to see the map of the nearby points of interests from the mobile app
  • User is able to explore points of interest next to the current article
  • User is able to view articles similar to the current one on the map (based on Wikidata class)
  • Mobile map is a complete replacement for the wikivoyage interface - layers for each type of element (eat, museum, sleep etc.) shown on the map with linking to element data on wikidata, localised by wikidata in your language. You will be able to access and edit wikivoyage info without ever going to the wikivoyage wikis.

Production maps cluster[edit | edit source]

The Production maps cluster is in development by the WMF Discovery team. The implementation has various components including:

  • Kartotherian Github /Gerrit - a server capable of providing map tiles in vector (pbf) or raster (png) formats, as well as static map snapshots of any size for a given location.
  • Tilerator Github/Gerrit - a distributed backend tile generation service with a jobque
  • A flexible sources system to set up the needed storage and processing pipeline

A version of the tile server is now in operation at

  • It serves tiles at URLs such as (bitmap) or .../791.json (OSM data – waterways, roads, place labels, etc.).
  • It can scale images up to 4 times (for high res screens), e.g. .../791@2x.png
  • It can provide static maps with a given size and scaling, e.g.
  • For now, it can only accepts requests from the domains in
  • is a simple map server that serves the Leaflet JavaScript library and some static files to provide a pannable, zoomable map using the Production maps cluster.
  • Please adapt your own labs tools to use! Set your tool's domain to *

Other projects[edit | edit source]

Key Performance Indicators[edit | edit source]

We all know maps are important part of the knowledge eco-system, but to better serve the community, we should invest our efforts into addressing the maps use cases that are more used than others. In order to find such use cases, here are some key performance indicators we should track.

  • Discovery contributions
    • Amount of articles surfaced through a tile generated map that a user chose to read
    • Amount of articles that could have a map but don't
  • Overall map usage
    • Amount of individual sessions that fully loaded a tile generated map within a wiki page broken down for all tile services & tools
    • Amount of user interaction (zoom, drag, etc) for a tile generated map within a wiki page broken down for all tile services & tools

Wishlist[edit | edit source]

See also[edit | edit source]