Template:Maplink/doc

Template:Documentation subpage Template:High-use

Ten szablon używa języka skryptowego Lua. Wywołuje Module:Mapframe and Module:Transcluder.

Template:Uses Wikidata Template:Sister project

This template adds a link, or frame, which will display a map from OpenStreetMap together with specified map data. The map and data can be viewed in a scrollable and zoomable fullscreen window. The map data can come from:

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

Note:

If you have a very large/slow map, you should use the mapframe extension tag directly instead of this template, as was done in Special:Diff/970846012. The reason for this is that using the template to call the extension tag will result in the map rendering counting as Lua time, which may result in time exceeded errors.
GeoJSON files cannot currently be directly uploaded. Instead, on Commons, create a page that is in the Data: namespace and ends in .map – see mw:Help:Map Data for further information.
To make OpenStreetMap (OSM) features available, add the Wikidata key to the OSM relation (and wait 1 or 2 days) – see mw:Help:Extension:Kartographer#External_data, mw:Help:Extension:Kartographer/OSM and Module talk:mapframe/FAQ for further information.

Template:Notice

Uses

This template is intended to show points as well as linear or polygon features on a map, including (but not limited to):

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

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

Usage

Basic usage

Data page on Commons Template:Small:
Template:Tlx (specify .map data page in from=, excluding Data prefix)
<maplink>: Couldn't parse JSON: Syntax error
Template:Small:
Template:Tlx (specify raw GeoJSON, preferably transcluded from a subpage of Wikipedia:Map data)
<maplink>: The JSON content is not valid GeoJSON+simplestyle. The list below shows all attempts to interpret it according to the JSON Schema. Not all are errors.
/0/ids: Does not match the regex pattern ^Q[1-9]\d{0,19}(\s*,\s*Q[1-9]\d{0,19})*$
/0/ids: String value found, but an array is required
/0/ids: Failed to match exactly one schema
/0/title: The property title is required
/0/service: Does not have a value in the enumeration ["page"]
/0: Failed to match exactly one schema
/0/geometries: The property geometries is required
/0/type: Does not have a value in the enumeration ["GeometryCollection"]
/0/type: Does not have a value in the enumeration ["MultiPolygon"]
/0/type: Does not have a value in the enumeration ["Point"]
/0/type: Does not have a value in the enumeration ["MultiPoint"]
/0/type: Does not have a value in the enumeration ["LineString"]
/0/type: Does not have a value in the enumeration ["MultiLineString"]
/0/type: Does not have a value in the enumeration ["Polygon"]
/0/coordinates: The property coordinates is required
/0/geometry: The property geometry is required
/0/type: Does not have a value in the enumeration ["Feature"]
/0/features: The property features is required
/0/type: Does not have a value in the enumeration ["FeatureCollection"]

from OSM:

Template:Tlx (Wikidata id only required if another article's Wikidata page is to be used)
<maplink>: The JSON content is not valid GeoJSON+simplestyle. The list below shows all attempts to interpret it according to the JSON Schema. Not all are errors.
/0/ids: Does not match the regex pattern ^Q[1-9]\d{0,19}(\s*,\s*Q[1-9]\d{0,19})*$
/0/ids: String value found, but an array is required
/0/ids: Failed to match exactly one schema
/0/title: The property title is required
/0/service: Does not have a value in the enumeration ["page"]
/0: Failed to match exactly one schema
/0/geometries: The property geometries is required
/0/type: Does not have a value in the enumeration ["GeometryCollection"]
/0/type: Does not have a value in the enumeration ["MultiPolygon"]
/0/type: Does not have a value in the enumeration ["Point"]
/0/type: Does not have a value in the enumeration ["MultiPoint"]
/0/type: Does not have a value in the enumeration ["LineString"]
/0/type: Does not have a value in the enumeration ["MultiLineString"]
/0/type: Does not have a value in the enumeration ["Polygon"]
/0/coordinates: The property coordinates is required
/0/geometry: The property geometry is required
/0/type: Does not have a value in the enumeration ["Feature"]
/0/features: The property features is required
/0/type: Does not have a value in the enumeration ["FeatureCollection"]

from OSM:

Template:Tlx (Wikidata id only required if another article's Wikidata page is to be used)
<maplink>: The JSON content is not valid GeoJSON+simplestyle. The list below shows all attempts to interpret it according to the JSON Schema. Not all are errors.
/0/ids: Does not match the regex pattern ^Q[1-9]\d{0,19}(\s*,\s*Q[1-9]\d{0,19})*$
/0/ids: String value found, but an array is required
/0/ids: Failed to match exactly one schema
/0/title: The property title is required
/0/service: Does not have a value in the enumeration ["page"]
/0: Failed to match exactly one schema
/0/geometries: The property geometries is required
/0/type: Does not have a value in the enumeration ["GeometryCollection"]
/0/type: Does not have a value in the enumeration ["MultiPolygon"]
/0/type: Does not have a value in the enumeration ["Point"]
/0/type: Does not have a value in the enumeration ["MultiPoint"]
/0/type: Does not have a value in the enumeration ["LineString"]
/0/type: Does not have a value in the enumeration ["MultiLineString"]
/0/type: Does not have a value in the enumeration ["Polygon"]
/0/coordinates: The property coordinates is required
/0/geometry: The property geometry is required
/0/type: Does not have a value in the enumeration ["Feature"]
/0/features: The property features is required
/0/type: Does not have a value in the enumeration ["FeatureCollection"]

from OSM:

Template:Tlx (Wikidata id only required if another article's Wikidata page is to be used)
Lua error: Musisz podać współrzędne w |coord= albo w parach |lat= i |lon= (pobieranie z Wikidanych jest wyłączone lub niedostępne).. (coordinates):
...from Wikidata:
Template:Tlx (Wikidata id only required if another article's Wikidata page is to be used)

...from specified coordinates:
Template:Tlx (specify coordinates using Template:Tl template)
Lua error: page-not-found. from a page or section Template:Resize
...from the current page: Template:Tlx or Template:Tlx

...from another page: Template:Tlx or Template:Tlx
Lua error: Musisz podać współrzędne w |coord= albo w parach |lat= i |lon= (pobieranie z Wikidanych jest wyłączone lub niedostępne).. (centred on a point's coordinates):
...from Wikidata:
Template:Tlx (Wikidata id only required if another article's Wikidata page is to be used)

...from specified coordinates:
Template:Tlx (specify coordinates using Template:Tl template)
To show in a frame, add the parameter Template:Para: Template:Tlx.
Mapframe example

Template:AnchorAdditional parameters are available to customise the displayed map, such as Template:Para to remove the outer frame: Template:Tlx.
<mapframe>: The JSON content is not valid GeoJSON+simplestyle. The list below shows all attempts to interpret it according to the JSON Schema. Not all are errors.
/0/ids: Does not match the regex pattern ^Q[1-9]\d{0,19}(\s*,\s*Q[1-9]\d{0,19})*$
/0/ids: String value found, but an array is required
/0/ids: Failed to match exactly one schema
/0/title: The property title is required
/0/service: Does not have a value in the enumeration ["page"]
/0: Failed to match exactly one schema
/0/geometries: The property geometries is required
/0/type: Does not have a value in the enumeration ["GeometryCollection"]
/0/type: Does not have a value in the enumeration ["MultiPolygon"]
/0/type: Does not have a value in the enumeration ["Point"]
/0/type: Does not have a value in the enumeration ["MultiPoint"]
/0/type: Does not have a value in the enumeration ["LineString"]
/0/type: Does not have a value in the enumeration ["MultiLineString"]
/0/type: Does not have a value in the enumeration ["Polygon"]
/0/coordinates: The property coordinates is required
/0/geometry: The property geometry is required
/0/type: Does not have a value in the enumeration ["Feature"]
/0/features: The property features is required
/0/type: Does not have a value in the enumeration ["FeatureCollection"]

Overlays can also be displayed on top of the map: Template:Tlx
Lua error: Musisz podać współrzędne w |coord= albo w parach |lat= i |lon= (pobieranie z Wikidanych jest wyłączone lub niedostępne)..

Parameter set – data page

{{maplink
|display=
|from=
|zoom=
|text=
|icon=
}}

Parameter set – raw data

{{maplink
|display=
|raw= <!-- preferably {{Wikipedia:Map data/subpage}} -->
|zoom=
|text=
|icon=
}}

Parameter set – geoline/geoshape

{{maplink
|display=
|type=
|id=
|title=
|description=
|stroke-color=
|stroke-width=
|zoom=
|text=
|icon=
}}

Parameter set – point features/coordinates

{{maplink
|display=
|type=point
|id=
|title=
|description=
|coord=
|marker=
|zoom=
|text=
|icon=
}}

Parameter set – circles

{{maplink
|display=
|type=circle
|radius=  <!-- in metres, alternative parameters available for other units --> 
|id=
|title=
|description=
|coord=
|marker=
|zoom=
|text=
|icon=
}}

Parameters

For overall display

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: Text to display for the link (or caption if using mapframe); default is "Map"
icon: Set to "no" to turn off the icon that appears next to the link
zoom: Zoom level, from 1 to 19 (larger numbers zoom in further); default is automatically determined by the map, unless the only feature is a single point.

Mapframe parameters (only work with inline display)

frame

Set to "yes" to show a map frame instead of a link

plain: Set to "yes" to show just the map without the surrounding frame, and without a caption (text parameter will be ignored)
frame-align: Alignment with respect to the page: left, center, or right; default is right
frame-width: Width of the map frame in pixels, default is 300
frame-height: Height of the map frame in pixels, default is 200
frame-coordinates: (or frame-coord); Optional - coordinates of the center of the map. Use Template:Tl template to specify coordinates Template:Small. If not set, coordinates will be retrieved from Wikidata.
frame-latitude: (or frame-lat); (ignored if Template:Para or Template:Para is set); Optional - latitude coordinate for center of the map.
frame-longitude: (or frame-long); (ignored if Template:Para or Template:Para is set); Optional - longitude coordinate for center of the map.

Template:A note If frame latitude and longitude are not set by parameters, then frame coordinates can be determined automatically, either:

Based on the line and shape objects (if any have been specified), or
From the point feature specified in Template:Para (if set), or
Retrieved from Wikidata (if available – for either the item specified in Template:Para parameter, or for the page the template is placed on)

overlay

An image, or another map, to be displayed on top the map. E.g.

Template:Para or; Template:Para or; Template:Para; (see Template:Maplink/testcases/overlays to view examples)
overlay-horizontal-alignment: Horizontal alignment of overlay, either left or right; default is right
overlay-vertical-alignment: Vertical alignment of overlay, either top or bottom; default is bottom
overlay-horizontal-offset Template:Nobold overlay-vertical-offset: Optional – number of pixels to offset the overlay in from the edge of the map, e.g. 10 for a 10 pixel gap
overlay-border: CSS style for the border, e.g. 3px solid black; default is 1px solid white. The colour can be any web color name or hex code.

Raw GeoJSON

raw: 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 Template:Para, Template:Para, etc., the third feature Template:Para, Template:Para, etc., and so on. Higher numbers are drawn on top.

type

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)

named – all named coordinates in an page or section (Template:Tlx templates with Template:Para parameter)

circle – a circle centred on a point's coordinates

id

(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 Template:Para not set).

from

Source of map data:

If type is data or omitted: The JSON (.map) file from Commons to display (excluding the Data: prefix)
If type is named: Page name, or name#section, to get named coordinates from. If omitted, or specified as just #section, then current page will be used.

title: Title of the feature (for features from OSM), displayed when the feature is clicked on; default is the page title
description: Description of the feature (for features from OSM), displayed when the feature is clicked on; optional
stroke-color: (or stroke-colour); Color code for the color used to draw the feature (for features from OSM); default is #ff0000 (red)
stroke-width: Width for the lines used to draw the feature (for features from OSM); default is 6
stroke-opacity: Opacity for the lines used to draw the feature (for features from OSM) – a number between 0 (fully transparent) and 1 (fully opaque); default is 1
fill: Color code for the fill color of the feature (for shape or shape-inverse features from OSM); default is #000000 (black). Note that a semi-transparent version of the specified color will be used by default, allowing the map below to still be seen.
fill-opacity: Opacity for the fill color of the feature (for shape or shape-inverse features from OSM) – a number between 0 (fully transparent) and 1 (fully opaque); default is 0.5
Template:Anchorcoord: Coordinates to display for a point feature. Use Template:Tl template to specify coordinates Template:Small. If not set, coordinates will be retrieved from Wikidata.
marker: 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.
marker-color: (or marker-colour); Color code (Hex triplet) specifying marker background color. Default is 5E74F3 (Template:Color box)
marker-size: Size of the marker. Can be small, medium (default) or large.
radius: (or radius_m), or alternative parameters radius_km, or radius_mi, or radius_ft; Radius of the circle. In metres by default, or in kilometers or miles or feet if the alternative parameters are used.
edges: Number of edges used to construct the circle. Default is 32. Higher numbers will result in a smoother circle but use more Lua processing resources.

TemplateData

Adds a link, or frame, which will display map data

Template parameters
Parameter		Description	Type	Status
display	`display`	How the template is displayed Suggested values `inline` `title` `inline,title` Default inline	Unknown	optional
text	`text`	Text to display for the link (or caption if using mapframe) Default Map	Line	optional
icon	`icon`	Set to "no" to turn off the icon that appears next to the link	Boolean	optional
zoom	`zoom`	Zoom level, from 1 to 19 (larger numbers zoom in further); default is automatically determined by the map, unless the only feature is a single point.	Number	optional

Multiple map switcher

An option for Template:Switcher-style switching of multiple mapframes, where specified parameters like zoom, or frame coordinates, or a shape's item id are switched between different values. When using, ensure the number of values in each list are the same.

Instructions:

Add parameter switch to specify labels for the different options: a list separated by eitherTemplate:Code, or Template:Code if the labels contain commas, or Template:Code if the labels contain semi-colons. Each label will be displayed with a prefix of "Show ".
Example: Template:Para
For each parameter that is to be switched, set its value to Template:Kbd followed by a list of values to switch between, again separated by Template:Code or Template:Code or Template:Code
Example: Template:Para

Parameters frame, plain, and text should not be switched
Make sure each list has the same number of entries. The position of value in a Template:Kbd list corresponds to the same position in the list of labels set in Template:Para.

Example: Template:Mapframe

{{mapframe|frame=yes|type=point|id=Q100|text=Boston|zoom=SWITCH:4,9,14|switch=zoomed out, zoomed mid, zoomed in}}

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

Mapa

{{Maplink|frame=yes
|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
}}

Lua error: Musisz podać współrzędne w |coord= albo w parach |lat= i |lon= (pobieranie z Wikidanych jest wyłączone lub niedostępne)..

{{Maplink|frame=yes|plain=yes|frame-width=250|frame-height=280|zoom=6|frame-lat=29.185|frame-long=76.225
|type=shape-inverse|id=Q1174|title=Haryana
|type2=point|id2=Q200663|stroke-width=3|title2=Faridabad
}}

Infoboxes

Mapframes can be included in infoboxes. Using Template:Para to remove the outer frame is recommended.

For simple cases with a single feature, Template:Tlx can be used instead (see that template's documentation for details). Template: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.

Raw GeoJSON example

<maplink>: Couldn't parse JSON: Syntax error

{{maplink|raw={{Wikipedia:Map data/Main Roads Western Australia/Forrest Highway}}|text=Route map}}

(Link to GeoJSON data subpage: Wikipedia:Map data/Main Roads Western Australia/Forrest Highway)

Raw Wikidata query examples

Ten countries

{{maplink|frame=yes|text=Ten countries|raw={
  "type": "ExternalData",
  "service": "geoshape",
  "query": "
SELECT * WHERE {
  ?id wdt:P463 wd:Q1065 .
} LIMIT 10
"}
|frame-width=600|frame-height=400|frame-lat=25|frame-long=10|zoom=1
}}

Mapa

{{maplink|frame=yes|raw={
  "type": "ExternalData",
  "service": "geoshape",
  "query": "
SELECT ?id ?head
  (SAMPLE(?img) as ?img_) 
  (min(?partyId) as ?party) 
  (if(?party = '0', '#800000', if(?party = '1', '#000080', '#008000')) as ?fill)
  (concat('[[', substr(str(?link),31,500),  '{{!}}', ?headLabel, ']]') as ?title)
  (concat(?stateLabel, '\\n', '[[File:', substr(str(?img_), 52, 500), '{{!}}200px]]') as ?description)
WHERE {  
  ?id wdt:P31 wd:Q35657 .
  ?id wdt:P6 ?head .
  ?head wdt:P102 ?party .
  BIND(if(?party = wd:Q29468, '0', if(?party = wd:Q29552, '1', '2')) as ?partyId) 
  SERVICE wikibase:label {
    bd:serviceParam wikibase:language 'en' .
    ?head rdfs:label ?headLabel .
    ?id rdfs:label ?stateLabel .
  }
  OPTIONAL {
    ?head wdt:P18 ?img .
  }
  ?link schema:about ?head .
  ?link schema:isPartOf <https://en.wikipedia.org/> .
} GROUP BY ?id ?head ?headLabel ?link ?stateLabel
"}|frame-width=600|frame-height=400|frame-lat=52|frame-long=-110|zoom=3}}

Gotchas

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 Template:Para parameter)
The following code utilising the Template:Para 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.

Tutorials

FAQ

Module talk:Mapframe/FAQ

Log in / Join

Search

Template:Maplink/doc

Namespaces

More

Page actions

Contents

Uses

Usage

Parameters

For overall display

Raw GeoJSON

For each feature

TemplateData

Multiple map switcher

Examples and tips

Multiple features

Infoboxes

The raw parameter

Raw GeoJSON example

Raw Wikidata query examples

Gotchas

Tutorials

FAQ

Redirects

See also

Navigation

Navigation

Photos

Data

Wiki tools

Wiki tools

Log in / Join

Search

Template:Maplink/doc

Uses

Usage

Parameters

For overall display

Raw GeoJSON

For each feature

TemplateData

Multiple map switcher

Examples and tips

Multiple features

Infoboxes

The raw parameter

Raw GeoJSON example

Raw Wikidata query examples

Gotchas

Tutorials

FAQ

Redirects

See also

Navigation

Wiki tools

Page tools

Other projects

Categories