Slippy Map MediaWiki Extension

From OpenStreetMap Wiki
Jump to navigation Jump to search
Logo.png
This page describes a historic artifact in the history of OpenStreetMap. It does not reflect the current situation, but instead documents the historical concepts, issues, or ideas.
Reason for being historic
The authors declared the software to be deprecated.


Slippy Map MediaWiki Extension
Slippy map MediaWiki extension-small.PNG
Authors: Harry Wood, Firefishy, JeLuF, raimond spekking
Status: Unmaintained
Source code: Firefishy/SlippyMap GitHub

disused wiki extension to display slippy maps, replaced with MultiMaps extension

This page describes a Slippy Map MediaWiki extension. See MediaWiki extension for details of other ideas / enhancements we could develop. This extension embedded an OpenLayers slippy map into the contents of the wiki page.

Wiki users could add a 'slippymap' tag into the page wiki-text. In this they could specify parameters 'lat', 'lon', 'z' (zoom level), 'w' (width in pixels), 'h' (height in pixels), and 'layer' (mapnik, transport, or cycle).

The extension spat out the JavaScript which launches OpenLayers within a sized DIV.

Syntax

The extension has been removed from all OSM(F) wikis, so the following markup will not work. The extension allowed anyone to embed a slippy map on a page with following syntax in the wikitext:

<slippymap lat="51.485" lon="-0.15" z="15" w="450" h="300" format="jpeg" layer="mapnik"/> 

To find the suitable lat/lon values, open a new browser window, look at the front page map and use the 'permalink' feature in the bottom right.

Note that the extension used to use an old format which is no longer supported: <slippymap>lat=51.485|lon=-0.15|z=11|w=450|h=330|layer=osmarender</slippymap> and all the wiki pages switched over to the new format.

Download & Installation

This extension is not maintained any longer. Hence, it is not recommended to install the extension outside of experimental setups.

MediaWiki Versions

Harry Wood originally created this to run on a really old v1.4 MediaWiki installation. The newer version probably isn't so backward compatible though.

Dependency note

This introduces a dependency between your wiki and the various OpenStreetMap tile servers. If OpenStreetMap ceases to provide images under these URLs, for whatever reason, then your wiki will still function, but it will show image errors.

We are offering no guarantees about the long-term continuation of this (or indeed any) OpenStreetMap service. Equally the extension code may be re-written, and you should aim to use the latest code available here. e.g. for security fixes.

There are a number of limitations and things which could be enhanced. The MediaWiki extension page has lots of ideas for this.

Known issues / ideas

  • Can't embed two different slippy maps on the same wiki page. This is because all the JavaScript variable names and the 'id=map' document object cease to be unique. Fixable with a bit of hacking.
  • 'Data from OpenStreetMap' overlayed text should be vertically positioned slightly lower
    • Have you looked at the possibility of overriding the attribution control to display what you want? It can be styled with CSS. Bobkare 14:50, 27 February 2008 (UTC)
  • It snaps to 0/0 lat/lon when you do something with mouse. Can't work out what exactly.
I think I know when this happens: click first on [wiki], close window and drag the map. --Willem1 19:22, 15 May 2009 (UTC)

Enhancement ideas

Add ideas here, or on the talk page

  • Support adding a marker or multiple pins.
    • Currently disabled while we decide best wiki syntax
    • Ideally follow the same g-maps extension syntax
    • Could provide a param option to disallow slippiness (useful?)
  • Display localized tiles from the Wikimedia Toolserver

Who was working on it

The extension code

The code has been re-homed in several confusing ways over the years. On this wiki page -> OSM's svn -> Mediawiki's SVN -> wikimedia gerrit -> GitHub (Firefishy/SlippyMap GitHub).

Also See