Extension:MultiMaps

MediaWiki extensions manual

MultiMaps Release status: stable
Implementation	Parser extension
Description	Allows users to display maps and coordinate data using multiple mapping services
Author(s)	Pavel Astakhov (pastakhovtalk)
Latest version	0.7.3 (2019-06-15)
PHP	5.3+
Database changes	No
License	GNU General Public License 2.0 or later
Download	Download extension Git [?]: Download Git master browse repository (GitHub) commit history repository contributors (GitHub) code review
Example	osmwiki:Wiki:Maps
Parameters $egMultiMaps_AllowGeocoderTests $egMultiMaps_CoordinatesSeparator $egMultiMaps_DefaultZoom $egMultiMaps_DelimiterParam $egMultiMaps_DelimiterParam $egMultiMaps_GoogleApiKey $egMultiMaps_Height $egMultiMaps_IconAllowFromDirectory $egMultiMaps_IconPath $egMultiMaps_MapServices $egMultiMaps_SeparatorItems $egMultiMaps_Width $egMultiMaps_YandexApiKey
Tags multimaps
Hooks used ParserFirstCallInit UnitTestsList
Translate the MultiMaps extension
Check usage and version matrix.
Issues	Open tasks · Report a bug

The MultiMaps extension allows users to display maps and coordinate data using multiple mapping services. Currently available maps are openstreetmap (by service leaflet), google, yandex and they can display markers, lines, polygons, rectangles, circles. Starting in version 0.7.3, it is also possible to assign an additional URL to a service.

If possible, the parameter syntax will be compatible with Maps extension.

Documentation

Main page: Documentation

To quickly display a map with all-default settings at position N10° and E10°, write:

{{#multimaps: 10, 10
}}

Example

Example available at:

• schoolwiki
• OpenStreetMap wiki

Installation

• Download and place the file(s) in a directory called MultiMaps in your extensions/ folder.

• Add the following code at the bottom of your LocalSettings.php:

  require_once "$IP/extensions/MultiMaps/MultiMaps.php";
  

•  Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration

Configuration settings (defaults defined in Settings.php)

Parameter	Default	Comment
$egMultiMaps_AllowGeocoderTests	false
$egMultiMaps_MapServices	[ 'Leaflet', 'Google', 'Yandex', 'Wikimedia' => [ 'service' => 'Leaflet', 'attribution' => '<a href="https://wikimediafoundation.org/wiki/Maps_Terms_of_Use">Wikimedia maps</a> | Map data &copy; <a href="osm.org/copyright">OpenStreetMap contributors</a>', 'source' => 'https://maps.wikimedia.org/osm-intl/{z}/{x}/{y}.png', ] ];	lists all map services provided to the wiki users, first entry is default Since version 0.7.3 it is possible to specify different tile addresses and attribution notices and link them to a service as seen with Wikimedia. The source attribute is provided in Leaflet notation here. For TMS sources, use {-y}.
$egMultiMaps_DefaultZoom	14	default zoom level of map displays, can be configured individually for each map using zoom parameter
$egMultiMaps_SeparatorItems	';'
$egMultiMaps_DelimiterParam	'~'
$egMultiMaps_OptionsSeparator	','	delimiter between latitude and longitude
$egMultiMaps_CoordinatesSeparator	':'	Geographic coordinates can be a delimited list of values ​​specified in the variable.
$egMultiMaps_Width	'auto'	default height of map displays, can be configured individually for each map using width parameter
$egMultiMaps_Height	'350px'	default height of map displays, can be configured individually for each map using height parameter
$egMultiMaps_IconAllowFromDirectory	false	If true, allow specify an icon for the marker from the directory
$egMultiMaps_IconPath	"$wgScriptPath/mapicons"	provide a source for map icons using a URL

An overview of OpenStreetMap-based map styles is located at osmwiki:Tile servers. Please always remember to review their usage policy before using.

See also

• Extension:Maps
• WMF's maps terms of use
• OpenStreetMap's tile usage policy