Changes

Jump to navigation Jump to search
4,589 bytes added ,  04:34, 14 March 2018
Add TempateData
{{Documentation subpage}}
__NOTOC__ __NOEDITSECTION__
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
===Function===
This template acts as a frame for an external map. Javascript is used to replace "mapdiv" with an iframe. See [[Wikivoyage:How to use dynamic maps]] and [[Wikivoyage:Dynamic maps Expedition]] for more information.

===Usage===

: <code><nowiki>{{Mapframe|1|2|zoom=|height=|width=|layer=|staticmap=|align=|name=}}</nowiki></code>

====Required parameters====
: <code> |1 </code> latitude of the map's centre, valid range: -90.0 to 90.0
: <code> |2 </code> longitude of the map's centre, valid range: -180.0 to 180.0

====Optional parameters====
: <code> |zoom= </code> zoom level, default=14, valid range: 0 to 18 or auto (0=Earth, 18=city block, auto=showing all markers)
: <code> |height= </code> height of map frame, default is 420px - should be at least 370 to provide enough space for the layers menu to expand
: <code> |width= </code> width of map frame, default is 420px
: <code> |staticmap= </code> static map image, a normal png or svg file
: <code> |align= </code> alignment of map frame, default is right (other values are "left" and "center")
: <code> |name= </code> name of the location as you want it to appear in the caption - default display is the article title with parent page and disambiguation removed. For an example of this parameter's usage, see [[Amsterdam/Binnenstad]].
: <code> |layer= </code> see [[Wikivoyage:How to use dynamic maps#Mapframe]]

===Examples===
<pre style="white-space: pre-wrap;"> {{Mapframe|51.47766|0.00115}}</pre>
<pre style="white-space: pre-wrap;"> {{Mapframe|zoom=auto}} (lat/long is not required)</pre>
<pre style="white-space: pre-wrap;"> {{Mapframe|51.47766|0.00115|zoom=14|height=400|width=400}}</pre>
<pre style="white-space: pre-wrap;"> {{Mapframe|51.47766|0.00115|zoom=14|height=400|width=400 |layer=W|staticmap=map.png}}</pre>
<pre style="white-space: pre-wrap;"> {{Mapframe|51.47766|0.00115|zoom=14|height=400|width=400 |layer=MLSCG|align=center|name=the Binnenstad}}</pre>

===Associated template===
* {{tl|mapshape}} - Used to create a mask, shape or line using data from the OpenStreetMap database; useful for city or region borders, or for showing routes.
* {{tl|mapmask}} - Used to create a mask using manually entered latitude/longitude pairs; useful for drawing city or region borders that aren't available from OpenStreetMap.

===Code===
* [[Module:Map]] used to create &lt;mapframe> tag with all of the parameters

<templatedata>
{
"params": {
"1": {
"label": "Latitude",
"description": "Latitude of the map's centre, -90 to 90",
"type": "number",
"example": "51.47766",
"suggested": true
},
"2": {
"label": "Longitude",
"description": "Longitude of the map's centre, -180 to 180",
"example": "0.00115",
"type": "number",
"suggested": true
},
"zoom": {
"label": "Zoom level",
"description": "Zoom level from 0-18 (0=Earth, 18=city block, auto=fit all markers)",
"example": "14",
"type": "number",
"suggested": true
},
"align": {
"label": "Alignment",
"description": "Alignment of the map frame, left/right/center",
"example": "center",
"type": "string",
"default": "right"
},
"name": {
"label": "Name",
"description": "Name of the location as you want it to appear in the caption",
"default": "Article title",
"example": "the Binnenstad"
},
"staticmap": {
"label": "Static map image",
"description": "A PNG or SVG file to serve as the static map image",
"example": "map.png",
"type": "wiki-file-name"
},
"width": {
"label": "Width",
"description": "Width of map frame",
"example": "400",
"type": "number",
"default": "420"
},
"height": {
"label": "Height",
"description": "Height of map frame",
"example": "400",
"type": "number",
"default": "420"
},
"layer": {
"label": "Layer",
"description": "List of layers to show, see [[Wikivoyage:How to use dynamic maps#Mapframe]]",
"example": "MLSCG",
"type": "string"
}
},
"paramOrder": [
"1",
"2",
"zoom",
"width",
"height",
"name",
"align",
"layer",
"staticmap"
],
"description": "This template acts as a frame for an external map. Javascript is used to replace \"mapdiv\" with an iframe. See [[Wikivoyage:How to use dynamic maps]] and [[Wikivoyage:Dynamic maps Expedition]] for more information.",
"format": "inline"
}
</templatedata>

<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Dynamic map templates]]
</includeonly>
Anonymous user

Navigation menu