Extension:MultiMaps/Documentation

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

To add a map to a wiki page need to write the magic word multimaps and specify the necessary parameters.

The syntax for the magic word multimaps is:

{{#multimaps: param_name=param_value
|[ ... ]
}}

param_name - it may be a element to be added to the card ('marker' by default), or the property of the map
param_value - is data that is assigned to the specified parameter

General

To display a map at N10° and E10°:

{{#multimaps: 10, 10
}}

Map elements

To add an element to the card, use the following syntax:

{{#multimaps: |element_name=element_item}}

element_name - should be the name one of the following elements: Marker, Line, Polygon, Rectangle, Circle.
element_item - parameters required to display the item on the map, such as coordinates, pop-up text, colors, etc...

element_name - is not case sensitive, can be both singular and the plural (marker, markers)
element_item - can be a single item and the items list. List separator of items specified in the variable $egMultiMaps_SeparatorItems, the default is ";"

Parameters in element_item are separated by a character specified in the variable $egMultiMaps_DelimiterParam, the default is "~".

The first and mandatory parameter is the geographical coordinates of the element. They can be written as a decimal fraction degrees or specifying the minutes and seconds (55.755831, 37.617673 or 55°45'20.9916", 37°37'3.6228"). If sides of the world is not specified, the default is the first north, second east. Sides of the world specified the corresponding character before or after the value (N55.755831°, E37.617673° or 55°45'20.9916"N, 37°37'3.6228"E)

Latitude and longitude values are separated by a character specified in the variable $egMultiMaps_OptionsSeparator, the default is ",".

Geographic coordinates can be a delimited list of values specified in the variable $egMultiMaps_CoordinatesSeparator, the default is ":".

Instead of geographic coordinates, you can specify the address. This address will be converted to the coordinates using the appropriate Geocoding Service. Examples ["empty" links]: Leaflet, Google, Yandex^{[citation needed]}

The other parameters can also be specified without a name, if they go in the order of priority set. Parameter has the following syntax: "param_name=param_value".

For example, you can set the marker icon in the following ways:

{{#multimaps: 10,10~ ~ ~MyIcon.png}}

{{#multimaps: 10,10~icon=MyIcon.png}}

Marker

Syntax:

{{#multimaps: 
| Marker = Coordinates ~ Title ~ Text ~ Icon
}}

Line

Syntax:

{{#multimaps: 
| Line = Coordinates ~ Title ~ Text ~ Color ~ Weight ~ Opacity
}}

Polygon

Syntax:

{{#multimaps: 
| Polygon = Coordinates ~ Title ~ Text ~ Color ~ Weight ~ Opacity ~ FillColor ~ FillOpacity ~ Fill
}}

Rectangle

Syntax:

{{#multimaps: 
| Rectangle = Coordinates ~ Title ~ Text ~ Color ~ Weight ~ Opacity ~ FillColor ~ FillOpacity ~ Fill
}}

Circle

Syntax:

{{#multimaps: 
| Circle = Coordinates : radius ~ Title ~ Text ~ Color ~ Weight ~ Opacity ~ FillColor ~ FillOpacity ~ Fill
}}

Map properties

You can set the following properties for the map:

service
height
width
zoom
maxzoom
minzoom
center

Service

At the moment, you can display a map with the map services leaflet (for accessing openstreetmap.org), google and yandex

Syntax:

{{#multimaps: [ ... ]
| service = name_of_service
}}

List of available services is defined in the variable $egMultiMaps_MapServices

Height

The height of the map window can be specified using height.

Syntax:

{{#multimaps: [ ... ]
| height = 100px
}}

The height can be also specified in percent. This works similar as specifying heights in w:CSS.

Width

The width of the map display is specified using width.

Zoom

Zoom specifies the zoom level of the map when the page is presented to the user. The user can then change it using <span class="nowrap" title="<translate nowrap> This is not a clickable button; it illustrates the button one should find.</translate>" style="padding:.2em .6em; border:1px solid; border-color:#AAA #555 #555 #AAA; border-radius: 3px; background-color: #F2F2F2; background-image: linear-gradient(to bottom, #FCFCFC, #E0E0E0); ">+ and <span class="nowrap" title="<translate nowrap> This is not a clickable button; it illustrates the button one should find.</translate>" style="padding:.2em .6em; border:1px solid; border-color:#AAA #555 #555 #AAA; border-radius: 3px; background-color: #F2F2F2; background-image: linear-gradient(to bottom, #FCFCFC, #E0E0E0); ">- or the mouse wheel. OpenStreetMap tiles are available from zoom 0 through 19 for instance.

Syntax:

{{#multimaps: [ ... ]
| zoom = 4
}}

Maxzoom/Minzoom

This property allows the editing user to limit the available zoom range for a page reader setting a minimum and a maximum.

Syntax:

{{#multimaps: [ ... ]
| maxzoom = 10
| minzoom = 3
}}

Center

The center property sets the map center to a given latitude and longitude. By default it takes two comma-separated values (latitude, longitude). The difference between using the very first argument and the center argument, is that this one does not create a marker at the specified location.

Syntax:

{{#multimaps:
| center = 10.2,52.9
}}