Template documentation[view] [edit] [history] [purge]

This template adds a link, or frame, which will display map data – either from:

  • data stored in GeoJSON format on Commons
  • line/polygon features in OpenStreetMap.
  • coordinates, either supplied or from Wikidata
  • raw GeoJSON, preferably transcluded from another page



This template is intended for linear or polygon features, including (but not limited to):

  • Roads
  • Rivers
  • Subway or train lines
  • Ship courses
  • Flight paths
  • Explorers journeys
  • Animal habitats
  • Countries and their subdvisions

and more... This template can also be used to display point features on a map, i.e. coordinates.


Basic usage

Mapframe example
  • Additional parameters are available to customise the displayed map.

Full parameter set – data page


Full parameter set – raw data

|raw= <!-- preferably {{Wikipedia:Map data/subpage}} -->

Full parameter set – geoline/geoshape


Full parameter set – point features/coordinates



For overall displayసవరించు

How the template is displayed. Valid values are:
inline - Only displays the inline link (you can forego this, as it is the default)
title - Only displays the title link
inline,title - Displays the inline link as well as the title link
title,inline - Same as above
Text to display for the link (or caption if using mapframe); default is "Map"
Set to "no" to turn off the icon that appears next to the link
Zoom level, from 1 to 19 (larger numbers zoom in further); default is automatically determined by the map
(Note that automatically determined zoom level does not work for mapframe maps except when previewing the page – see phab:T193455)

Mapframe parameters (only work with inline display)

Set to "yes" to show a map frame instead of a link
Set to "yes" to show just the map without the surrounding frame, and without a caption (text parameter will be ignored)
Alignment with respect to the page: left, center, or right; default is right
Width of the map frame, default is 300
Height of the map frame, default is 200
(or frame-lat)
Optional - alternate latitude coordinate for initial placement of map
(or frame-lat)
Optional - alternate longitude coordinate for initial placement of map
If frame latitude and longitude are not set by parameters, then coordinates in |coord= will be used (if set), or coordinates will be retrieved from Wikidata (if available, for either the item specified in |id= parameter or for the page the template is placed on)

Raw GeoJSONసవరించు

Raw GeoJSON (preferably transcluded from a subpage of Wikipedia:Map data) as well as <maplink> functionality not available via the other parameters. See below for more information.

For each featureసవరించు

Multiple features can be displayed on a single map. For each additional feature, add a sequential number to the end of the parameter name. For example, the second uses parameters like |type2=, |id2=, etc., the third feature |type3=, |id3=, etc., and so on.

Type of data. Valid values are:
line – a geoline feature from OSM (e.g. a road)
shape – a geoshape feature from OSM (e.g. a state or province)
shape-inverse – a geomask feature from OSM (the inverse of a geoshape - allows an unobstructed view of the map beneath)
data – a geoJSON data page on Commons (parameter is optional in this case)
point – a point feature (coordinates)
(or ids)
Wikidata id (Q-number) of the point feature, Wikidata id that the OSM line/shape feature is tagged with. Separate multiple ids with a comma. Defaults to the current page's Wikidata id (if |from= not set).
The JSON (.map) file from Commons to display (excluding the Data: prefix)
Title of the feature (for features from OSM), displayed when the feature is clicked on; default is the page title
Description of the feature (for features from OSM), displayed when the feature is clicked on; optional
(or stroke-colour)
Color code for the color used to draw the feature (for features from OSM); default is #ff0000 (red)
Width for the lines used to draw the feature (for features from OSM); default is 6
Coordinates to display for a point feature. Use {{Coord}} template to specify coordinates. If not set, coordinates will be retrieved from Wikidata.
Name of Maki marker image to display at the point feature. See mw:Maps/Icons for options. If not set, a plain marker will be shown without an image.
(or marker-colour)
Color code (Hex triplet) specifying marker background color. Default is 5E74F3 ( )

Examples and tipsసవరించు

Multiple featuresసవరించు

Multiple features allow you to:

  • Use external data from both Wikimedia Commons and OpenStreetMap together
  • Apply different styles to different external data features from OpenStreetMap
  • Include multiple links to external data from Wikimedia Commons
|type=shape|id=Q3495894|title=Shape|description=Description of shape
|type2=line|id2=Q1318331|title2=Line|description2=Description of line
|type3=point|coord3={{coord|32|S|116|E}}|title3=Point|description3=Description of point



Mapframes can be included in infoboxes. Using |plain=yes to remove the outer frame is recommended.

For simple cases with a single feature, {{infobox mapframe}} can be used instead (see that template's documentation for details). మూస:Infobox Australian road

{{Infobox Australian road
| location = {{maplink |type=line |frame=yes |plain=yes |frame-align=center |frame-lat=-31.8262 |frame-long=115.7877 |zoom=9}}
  ...  (other parameters omitted)  ...

The raw parameterసవరించు

The "raw" parameter allows the same inputs as the full <maplink> function. It allows you to:

  • Use GeoJSON data directly
  • Use Wikidata queries to obtain information for the map
  • Use templates - if a map includes direct GeoJSON or many components, placing the data in a template will avoid cluttering the article text

See mw:Help:Extension:Kartographer for instructions.


  • When retrieving lines or shapes from OSM, you can't style the fill color or the opacity level of fills or strokes (unless you use the |raw= parameter)
  • The following code utilising the |raw= parameter won't work because the curly brace to close the GeoJSON is adjacent to the curly braces to close the template:
{{Maplink|raw= {"type": "ExternalData","service": "geoshape","ids": "Q13518258"}}}
To fix it, put a space before the two template braces or move them to a separate line.


  • {{Map link}}
  • {{Mapframe}}

See alsoసవరించు

"మూస:Maplink&oldid=2378846" నుండి వెలికితీశారు