Template:Mapframe/doc

From Northumberland Climbing
< Template:Mapframe
Revision as of 07:51, 30 July 2020 by Ianbirtwistle (talk | contribs) (1 revision imported)
Jump to navigation Jump to search

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

{{Mapframe|1|2|zoom=|height=|width=|layer=|staticmap=|align=|name=}}

Required parameters

|1 latitude of the map's centre, valid range: -90.0 to 90.0
|2 longitude of the map's centre, valid range: -180.0 to 180.0

Optional parameters

|zoom= zoom level, default=14, valid range: 0 to 18 or auto (0=Earth, 18=city block, auto=showing all markers)
|height= height of map frame, default is 420px - should be at least 370 to provide enough space for the layers menu to expand
|width= width of map frame, default is 420px
|staticmap= static map image, a normal png or svg file
|align= alignment of map frame, default is right (other values are "left" and "center")
|name= 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.
|layer= see Wikivoyage:How to use dynamic maps#Mapframe

Examples

 {{Mapframe|51.47766|0.00115}}
 {{Mapframe|zoom=auto}} (lat/long is not required)
 {{Mapframe|51.47766|0.00115|zoom=14|height=400|width=400}}
 {{Mapframe|51.47766|0.00115|zoom=14|height=400|width=400 |layer=W|staticmap=map.png}}
 {{Mapframe|51.47766|0.00115|zoom=14|height=400|width=400 |layer=MLSCG|align=center|name=the Binnenstad}}

Associated template

  • {{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.
  • {{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 <mapframe> tag with all of the parameters

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.

Template parameters

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
Latitude1

Latitude of the map's centre, -90 to 90

Example
51.47766
Numbersuggested
Longitude2

Longitude of the map's centre, -180 to 180

Example
0.00115
Numbersuggested
Zoom levelzoom

Zoom level from 0-18 (0=Earth, 18=city block, auto=fit all markers)

Example
14
Numbersuggested
Widthwidth

Width of map frame

Default
420
Example
400
Numberoptional
Heightheight

Height of map frame

Default
420
Example
400
Numberoptional
Namename

Name of the location as you want it to appear in the caption

Default
Article title
Example
the Binnenstad
Unknownoptional
Alignmentalign

Alignment of the map frame, left/right/center

Default
right
Example
center
Stringoptional
Layerlayer

List of layers to show, see [[Wikivoyage:How to use dynamic maps#Mapframe]]

Example
MLSCG
Stringoptional
Static map imagestaticmap

A PNG or SVG file to serve as the static map image

Example
map.png
Fileoptional