![]() | This is a documentation subpage for Template:Infobox mapframe. It may contain usage information, categories and other content that is not part of the original template page. |
![]() | This template is used on approximately 90,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
![]() | This template uses Lua: |
![](http://upload.wikimedia.org/wikipedia/commons/thumb/f/ff/Wikidata-logo.svg/40px-Wikidata-logo.svg.png)
Related pages |
---|
This template generates a mapframe map, suitable for infoboxes, with minimal user input. This template only works with single features (points, lines, or shapes); use {{maplink}}
if more advanced options, such as displaying multiple features, are required.
If coordinates are not supplied, they will be fetched from the page's Wikidata item. In such cases, if |point=
is not set, then a point feature marker is displayed at those coordinates unless the Wikidata item has an OpenStreetMap relation ID (P402) specified.
- See Category:Infobox mapframe without OSM relation ID on Wikidata for pages which have items without OpenStreetMap relation ID (P402)
- Troubleshooting shapes guidance is found at Module talk:mapframe/FAQ
Usage
editNote: When in mainspace, parameter |id=
is not required (except to use a different page's data)
Basic
edit{{Infobox mapframe}}
When used without parameters, or with only |id=
, the map will display either a shape, line, or point feature, depending on the data available on Wikidata and OpenStreetMap.
- If the Wikidata item does not specify a OpenStreetMap relation ID (P402) value, then a point marker will be displayed by default in addition any OSM shape or line feature.
- If the Wikidata items does not specify a coordinate location (P625) or a geoshape (P3896) value, then no map will be displayed
Basic usage examples
|
---|
Point feature (Wikidata coordinates): {{Infobox mapframe |id=Q7270550}}
{{Infobox mapframe |id=Q1318331}}
{{Infobox mapframe |id=Q61}}
|
Using specified coordinates instead of Wikidata
editPoint feature only, no shapes or lines:
{{Infobox mapframe |coord=}}
Point feature and shape/line feature if available:
{{Infobox mapframe |wikidata=yes |coord=}}
Specify coordinates using the {{Coord}}
templates, e.g. |coord=
{{Coord|32.1|S|116.2|E}}
- If
|coord=
is specified, then by default only that coordinate will be displayed (no line or shape features) - If
|coord=
is specified and|wikidata=yes
is used, then those coordinate will be displayed, along with any line or shape features linked to the Wikidata item.
Customizing which features are displayed
editInverse shape
edit{{Infobox mapframe |shape=inverse}}
Replace the shape with an inverse-shape (geomask) by setting |shape=inverse
Turn point marker on or off
editForce point marker to be displayed:
{{Infobox mapframe |point=on}}
Prevent point marker from being displayed:
{{Infobox mapframe |point=none}}
Turn shape feature off
editPrevent shape feature from being displayed:
{{Infobox mapframe |shape=none}}
Turn line feature off
editPrevent line feature from being displayed:
{{Infobox mapframe |line=none}}
Show a geomask from a related Wikidata item
edit{{Infobox mapframe |geomask=}}
Set |geomask=
to a Wikidata item id (Q-number), or property id (P-number) such as country (P17)
Geomask examples
|
---|
Use the item linked from the country (P17) statement as a geomask: {{Infobox mapframe |id=Q3239281 |geomask=P17}}
{{Infobox mapframe |id=Q3239281 |geomask=Q1199}}
|
Determine zoom from object length or area
editUse |length_km=
or |length_mi=
or |area_km2=
or |area_mi2=
Parameters
editAll parameters are optional.
- Basic parameters:
- id – Id (Q-number) of Wikidata item to use. Default: item for current page
- coordinates or coord – Coordinates to use, instead of any on Wikidata. Use the {{Coord}} template, e.g.
|coord=
. Default: coordinates from Wikidata{{Coord|12.34|N|56.78|E}}
- wikidata – Set to
yes
to show shape/line features from the wikidata item, if any, when|coord=
is set. Default: not specified
- Customise which features are displayed:
- shape – Turn off display of shape feature by setting to
none
. Use an inverse shape (geomask) instead of a regular shape by setting toinverse
. Default: not specified - point – Turn off display of point feature by setting to
none
. Force point marker to be displayed by setting toon
. Default: not specified - line – Turn off display of line feature by setting to
none
. Default: not specified - geomask – Wikidata item to use as a geomask (everything outside the boundary is shaded darker). Can either be a specific Wikidata item (Q-number), or a property that specifies the item to use (e.g.
P17
for country (P17),P131
for located in the administrative territorial entity (P131)). Default: not specified - switcher – set to
auto
orgeomasks
orzooms
to enable Template:Switcher-style switching between multiple mapframes. Default: not specifiedauto
– switch geomasks found in location (P276) and located in the administrative territorial entity (P131) statements on the page's Wikidata item, searching recursively. E.g. an item's city, that city's state, and that state's country.geomasks
– switch between the geomasks specified as a comma-separated list of Wikidata items (Q-numbers) in the geomask parameterzooms
– switch between "zoomed in"/"zoomed midway"/"zoomed out", where "zoomed in" is the default zoom (with a minimum of3
), "zoomed out" is1
, and "zoomed midway" is the average
- shape – Turn off display of shape feature by setting to
- Other optional parameters:
- frame-width or width – Frame width. Default: 270
- frame-height or height – Frame height. Default: 200
- shape-fill – Color used to fill shape features. Default: #606060
- shape-fill-opacity – Opacity level of shape fill, a number between 0 and 1. Default: 0.5
- stroke-color or stroke-colour – Color of line features, and outlines of shape features. Default: #ff0000
- stroke-width – Width of line features, and outlines of shape features; default is "5". Default: 5
- marker – Marker symbol to use for coordinates; see mw:Help:Extension:Kartographer/Icons for options. Default: not specified (i.e. blank)
- Can also be set to
blank
to override any default marker symbol
- Can also be set to
- marker-color or marker-colour – Background color for the marker. Default: #5E74F3
- geomask-stroke-color or geomask-stroke-colour – Color of outline of geomask shape. Default: #555555
- geomask-stroke-width – Width of outline of geomask shape. Default: 2
- geomask-fill – Color used to fill outside geomask features. Default: #606060
- geomask-fill-opacity – Opacity level of fill outside geomask features, a number between 0 and 1. Default: 0.5
- zoom – Set the zoom level, from "1" (map of earth) to "18" (maximum zoom in), to be used if the zoom level cannot be determined automatically from object length or area. Default: 10
- length_km or length_mi or area_km2 or area_mi2 – Determine zoom level by passing in object's length (in kilometres or miles) or area (in square kilometres or square miles). Default: not specified
- frame-coordinates or frame-coord – Alternate latitude and longitude coordinates for initial placement of map, using {{coord}}. Default: derived from item coordinates
- Deprecated parameters
- frame-lat or frame-latitude – Alternate latitude coordinate for initial placement of map; default is derived from item coordinates
- frame-long or frame-longitude – Alternate longitude coordinate for initial placement of map; default is derived from item coordinates
Examples for use within templates
editInfobox hospital
|
---|
{{Infobox hospital}} (as of 5 October 2019) |image3 = {{yesno|{{{mapframe|yes}}}|no=|yes={{Infobox mapframe
|zoom={{{mapframe-zoom|}}}
|frame-width={{{mapframe-width|}}}
|frame-height={{{mapframe-height|}}}
|marker={{{mapframe-marker|hospital}}}
|marker-color={{{mapframe-marker-color|{{{mapframe-marker-colour|}}}}}}
|frame-lat={{{mapframe-lat|{{{mapframe-latitude|}}}}}}
|frame-long={{{mapframe-long|{{{mapframe-longitude|}}}}}}
|stroke-color={{{mapframe-stroke-color|{{{mapframe-stroke-colour|}}}}}}
}}
}}
|caption3 = {{yesno|{{{mapframe|yes}}}|no=|yes={{{mapframe-caption|}}}}}
|
Infobox power station
|
---|
{{Infobox power station}} (as of 2 April 2019): | image2 = {{#ifeq:{{{location_map|}}}|no|<!-- -->|{{Infobox mapframe
|id = {{{qid|}}}
|coord = {{{coordinates|}}}
|frame-width = {{Digits|1={{#if:{{{image_size|}}}|{{{image_size|}}}|300px}}}}
|marker = industrial
|zoom = {{#if:{{{location_map_geomask|}}}|{{{location_map_zoom|}}}|{{{location_map_zoom|5}}}}}
|geomask = {{#ifeq:{{{location_map_geomask|}}}|Yes|P17|<!-- -->}}
|geomask-stroke-width = {{#ifeq:{{{location_map_geomask|}}}|Yes|0.5|<!-- -->}}
|geomask-stroke-colour = {{#ifeq:{{{location_map_geomask|}}}|Yes|#000000|<!-- -->}}
|geomask-fill = {{#ifeq:{{{location_map_geomask|}}}|Yes|#BABABA|<!-- -->}}
}}}}
| caption2 = {{#ifeq:{{{location_map|}}}|no|<!-- -->|{{#if:{{{coordinates|}}}{{#property:P625}}|{{{location_map_caption|}}}}}}}
|
Infobox Australian road
|
---|
{{Infobox Australian road}} (as of 5 October 2019): | data3 = {{#ifexist:media:{{{location|}}}<!--
-->|[[File:{{{location}}}|270px|frameless|alt={{{location_alt|{{{loc_alt|{{{alt|}}}}}}}}}]]<!--
-->|{{{location|<!--
-->{{yesno| {{{mapframe|yes}}}<!--
-->|no=<!--
-->|yes={{Infobox mapframe | length_km={{{length|}}} }}<!-- Tracking category:
-->{{main other|{{#if:{{#property:P625}}|[[Category:Infobox Australian road articles with an infobox mapframe map|{{#if:{{{coordinates_a|}}}|π}}{{PAGENAME}}]]}}}}<!--
-->}}<!--
-->}}}<!--
-->}}
|
FAQ
edit- If the problem also occurs when using plain
<mapframe>...</mapframe>
tags, then it should be reported on Phabricator (you can log in with you Wikipedia account). See mw:How to report a bug for instructions (for the tags, use Maps). (Alternatively, you can try mw:Help talk:Extension:Kartographer) - If the problem only occurs with Wikipedia's template/module, or you're not sure, report it here. (Alternatively, you can try Wikipedia:Village pump (technical))
That preview mode shows an interactive map is a bug, phab:T203863 (and also a performance issue). Further explanation can be found in the comments on phab:T202793.
- The feature on OSM needs to be tagged with the Wikidata id, per mw:Help:Extension:Kartographer/OSM. It is not enough to just set OpenStreetMap relation ID (P402) on the Wikidata item.
- Only certain OSM relations (those with type=multipolygon, type=route, type=waterway and type=boundary) can be used, and not others like buildings and public transport master routes. See mw:Help:Extension:Kartographer/OSM#Limitation and phab:T156433.
- It can take 1 or 2 days after tagging on OSM before the data is available here.
- Wikimedia occasionally has problems replicating OSM data (e.g. phab:T218097), or intentionally disables replication due to other problems (e.g. phab:T243609)
|raw=
parameter is showing error messages of "The time allocated for running scripts has expired." What can be done?TemplateData
editTemplateData for Infobox mapframe
parameters
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
No description.
|
See also
edit- Wikipedia:Maps for Wikipedia, a list of mapping tools available on Wikipedia