Maps (MediaWiki extension)

Category:MediaWiki extension Maps (MediaWiki extension)
Extension name	Maps
About this article / disclaimer	This is not official documentation
Logo
Screenshot
Location of the main author	Gent, Belgium
Coordinates of the main authors	51.053829, 3.725012
Developers	Jeroen De Dauw, others
Licences
Description	Maps is a MediaWiki extension that provides the ability to visualize geographic data with dynamic, JavaScript based, mapping API's. It has built-in support for geocoding, displaying maps, displaying markers, adding pop-ups, and more.
Mediawiki requirements	1.17.* or higher for version 2.0, 1.21 alpha or higher or the 3.0 development version
Dependencies	ParamProcessor
Related extensions (documented here)	Semantic Maps
Related extensions
Discussion
Language support	Many
Status
First release date	2009/07/01
Last release date (as of 2013/08/22!)	2013/08/01
Last version number	2.0.1 (stable, 12/2012), 3.0 (alpha)
Programming language	PHP
Alternatives
Website	home page
Publications
Support websites	web site
Example websites	http://semantic-mediawiki.org/wiki/Maps
Last edited	2013/08/22

Introduction

Maps is a MediaWiki extension that provides the ability to visualize geographic data with dynamic, JavaScript based, mapping API's such as Google Maps and OpenLayers in your wiki pages. It has built-in support for geocoding, displaying maps, displaying markers, adding pop-ups, and more. Maps allows extensive customization of your maps, either per map, or via a general setting affecting all maps on your wiki. It is used by the Semantic Maps extension. (Maps, retrieved Aug 2013.

Geocoding

Geocoding allows to work with addresses instead of coordinates, i.e. geocoding can convert something like 40 boulevard du Pont d'Arve, Geneva into coordinates.

Live example:

{{#geocode:40 bd du Pont-d'Arve, Genève}}

gives: 46° 11' 41.42" N, 6° 8' 24.91" E

{{#geocode:location=40 bd du Pont-d'Arve, Genève|format=float}}

gives: 46.194839 N, 6.140253 E

{{#geocode:location=40 bd du Pont-d'Arve, Genève|format=float|directional=no}}

gives: 46.194839, 6.140253

See more example in the official manual

Displaying Maps

In order to display map with one or more markers, you can either enter addresses that will be resolved by a geocoding service (see above) or coordinates.

One either can use a parser function or XML code.

Parser function:

{{#display_map:....}}

XML code:

<display_map>...</display_map>

Simple syntax example:

{{#display_map:<your location>|height=<some height>|service=<your service>|zoom=<zoom-level>}}

Read the official documentation, though there are new parameters which are not yet documented.

Simple examples

Most basic use example (result not shown):

{{#display_map:Genève}}

{{#display_map:}}

Below are some simple examples using height and width and zoom parameters.

{{#display_map:Geneva, Switzerland|height=200px|width=400px|zoom=8}}

Loading map...

{"minzoom":false,"maxzoom":false,"mappingservice":"leaflet","width":"auto","height":"350px","centre":false,"title":"","label":"","icon":"","lines":[],"polygons":[],"circles":[],"rectangles":[],"copycoords":false,"static":false,"zoom":false,"defzoom":14,"layers":["OpenStreetMap"],"image layers":[],"overlays":[],"resizable":false,"fullscreen":false,"scrollwheelzoom":true,"cluster":false,"clustermaxzoom":20,"clusterzoomonclick":true,"clustermaxradius":80,"clusterspiderfy":true,"geojson":"","clicktarget":"","imageLayers":[],"locations":[{"text":"","title":"","link":"","lat":46.2017559,"lon":6.1466014,"icon":""}],"imageoverlays":null}

{{#display_map:Geneva, Switzerland|height=200px|width=400px|service=openlayers}}

Loading map...

{"minzoom":false,"maxzoom":false,"mappingservice":"leaflet","width":"400px","height":"200px","centre":false,"title":"","label":"","icon":"","lines":[],"polygons":[],"circles":[],"rectangles":[],"copycoords":false,"static":false,"zoom":false,"defzoom":14,"layers":["OpenStreetMap"],"image layers":[],"overlays":[],"resizable":false,"fullscreen":false,"scrollwheelzoom":true,"cluster":false,"clustermaxzoom":20,"clusterzoomonclick":true,"clustermaxradius":80,"clusterspiderfy":true,"geojson":"","clicktarget":"","imageLayers":[],"locations":[{"text":"","title":"","link":"","lat":46.2017559,"lon":6.1466014,"icon":""}],"imageoverlays":null}

Simple examples using multiple points

Some addresses of University of Geneva (a city "campus")

{{
#display_map:
40 bd. du Pont-d'Arve,Geneva, Switzerland;
Rue du Général-Dufour 24, 1204 Genève;
Rue De Candolle 5, 1205 Genève;
Bd des Philosophes 22, 1205 Genève;
Rue de Saint-Ours 5, 1205 Genève;
Rue de Candolle 2, 1205 Genève;
Route de Drize 9, 1227 Carouge;
Rue Michel-Servet 1, 1206 Genève;
Rue Barthélemy-Menn 19, 1205 Genève;
Quai Ernest-Ansermet 24, 1205 Genève;
Quai Ernest-Ansermet 30, 1205 Genève
| height=200px|width=400px
}}

Loading map...

{"minzoom":false,"maxzoom":false,"mappingservice":"leaflet","width":"auto","height":"350px","centre":false,"title":"","label":"","icon":"","lines":[],"polygons":[],"circles":[],"rectangles":[],"copycoords":false,"static":false,"zoom":false,"defzoom":14,"layers":["OpenStreetMap"],"image layers":[],"overlays":[],"resizable":false,"fullscreen":false,"scrollwheelzoom":true,"cluster":false,"clustermaxzoom":20,"clusterzoomonclick":true,"clustermaxradius":80,"clusterspiderfy":true,"geojson":"","clicktarget":"","imageLayers":[],"locations":[{"text":"","title":"","link":"","lat":46.1948392,"lon":6.1402529,"icon":""},{"text":"","title":"","link":"","lat":46.1997991,"lon":6.1426647,"icon":""},{"text":"","title":"","link":"","lat":46.1990401,"lon":6.1443962,"icon":""},{"text":"","title":"","link":"","lat":46.1963343,"lon":6.147363559526811,"icon":""},{"text":"","title":"","link":"","lat":46.1990749,"lon":6.1434531,"icon":""},{"text":"","title":"","link":"","lat":46.1761166,"lon":6.1405942,"icon":""},{"text":"","title":"","link":"","lat":46.1935534,"lon":6.1511917,"icon":""},{"text":"","title":"","link":"","lat":46.1907464,"lon":6.1444312,"icon":""},{"text":"","title":"","link":"","lat":46.1970656,"lon":6.1346224,"icon":""},{"text":"","title":"","link":"","lat":46.1979519,"lon":6.1325215,"icon":""}],"imageoverlays":null}

Google Maps layer map

(doesn't work, probably some configuration missing ...)

Loading map...

{"minzoom":false,"maxzoom":false,"mappingservice":"leaflet","width":"auto","height":"350px","centre":false,"title":"","label":"","icon":"","lines":[],"polygons":[],"circles":[],"rectangles":[],"copycoords":false,"static":false,"zoom":false,"defzoom":14,"layers":["traffic","bicycling","transit"],"image layers":[],"overlays":[],"resizable":false,"fullscreen":false,"scrollwheelzoom":true,"cluster":false,"clustermaxzoom":20,"clusterzoomonclick":true,"clustermaxradius":80,"clusterspiderfy":true,"geojson":"","clicktarget":"","imageLayers":[],"locations":[{"text":"","title":"","link":"","lat":46.1948392,"lon":6.1402529,"icon":""}],"imageoverlays":null}

Installation and configuration

Installation

In order to install a bleeding edge 3.0 alpha version, we did the following in this wiki:

• Upgrade PHP to 5.3.10 (i.e. the default in Ubuntu 12.04)
• Upgrade both the Wiki and all SMW extensions to developer (alpha) code

cd extensions:
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/DataValues.git
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/Validator.git
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/Maps.git

Configuration

You can use Maps out of the box. However, some services require API keys and according configuration settings in LocaSettings.php.

Links

• https://semantic-mediawiki.org/wiki/User:Jeroen_De_Dauw/Describe
• https://semantic-mediawiki.org/wiki/User:Jeroen_De_Dauw/Mapsdoc