Difference between revisions of "Template:Infobox mapframe/doc"
imported>Ɱ (add link - these various templates were never that accessible to each other) |
imported>Evad37 (update) |
||
| Line 19: | Line 19: | ||
===Basic=== | ===Basic=== | ||
| − | Point (Wikidata): | + | <pre>{{Infobox mapframe}}</pre> |
| + | When used without parameters, or with only {{para|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 {{Q|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 {{Q|P625}} value, then no map will be displayed | ||
| + | {{cot|Basic usage examples}} | ||
| + | Point feature (Wikidata coordinates): | ||
<pre>{{Infobox mapframe |id=Q7270550}}</pre> | <pre>{{Infobox mapframe |id=Q7270550}}</pre> | ||
{{Infobox mapframe |id=Q7270550}} | {{Infobox mapframe |id=Q7270550}} | ||
| − | + | Line feature: | |
| − | |||
| − | |||
| − | Line: | ||
<pre>{{Infobox mapframe |id=Q1318331}}</pre> | <pre>{{Infobox mapframe |id=Q1318331}}</pre> | ||
{{Infobox mapframe |id=Q1318331}} | {{Infobox mapframe |id=Q1318331}} | ||
| − | Shape: | + | Shape feature: |
<pre>{{Infobox mapframe |id=Q61}}</pre> | <pre>{{Infobox mapframe |id=Q61}}</pre> | ||
{{Infobox mapframe |id=Q61}} | {{Infobox mapframe |id=Q61}} | ||
| − | ===Determine zoom from object length in kilometres or miles | + | {{cob}} |
| + | |||
| + | ===Using specified coordinates instead of Wikidata=== | ||
| + | Point feature only, no shapes or lines: | ||
| + | <pre>{{Infobox mapframe |coord=}}</pre> | ||
| + | Point feature and shape/line feature if available: | ||
| + | <pre>{{Infobox mapframe |wikidata=yes |coord=}}</pre> | ||
| + | |||
| + | Specify coordinates using the {{tlx|Coord}} templates, e.g. {{para|coord|2={{tlx|Coord|32.1|S|116.2|E}}}} | ||
| + | *If {{para|coord}} is specified, then by default only that coordinate will be displayed (no line or shape features) | ||
| + | *If {{para|coord}} is specified and {{para|wikidata|yes}} is used, then those coordinate will be displayed, along with any line or shape features linked to the Wikidata item. | ||
| + | {{cot|Specified coordinates examples}} | ||
| + | Point feature (with coordinates specified, no shape/line feature from Wikidata item): | ||
| + | <pre>{{infobox mapframe |coord={{coord|31|56|S|115|58|E}} }}</pre> | ||
| + | {{infobox mapframe |id=Q45935 |coord={{coord|31|56|S|115|58|E}} }} | ||
| + | Point feature (with coordinates specified, along with shape/line feature from Wikidata item): | ||
| + | <pre>{{infobox mapframe |wikidata=yes |coord={{coord|31|56|S|115|58|E}} }}</pre> | ||
| + | {{infobox mapframe |id=Q45935 |wikidata=yes |coord={{coord|31|56|S|115|58|E}} }} | ||
| + | {{cob}} | ||
| + | |||
| + | ===Customizing feature display=== | ||
| + | ====Inverse shape==== | ||
| + | <pre>{{Infobox mapframe |shape=inverse}}</pre> | ||
| + | Replace the shape with an inverse-shape (geomask) by setting {{para|shape|inverse}} | ||
| + | {{cot|Inverse shape example}} | ||
| + | <pre>{{Infobox mapframe |id=Q61 |shape=inverse}}</pre> | ||
| + | {{Infobox mapframe |id=Q61 |shape=inverse}} | ||
| + | {{cob}} | ||
| + | |||
| + | ====Turn point marker on or off==== | ||
| + | Force point marker to be displayed: | ||
| + | <pre>{{Infobox mapframe |point=on}}</pre> | ||
| + | Prevent point marker from being displayed: | ||
| + | <pre>{{Infobox mapframe |point=none}}</pre> | ||
| + | |||
| + | ====Turn shape feature off==== | ||
| + | Prevent shape feature from being displayed: | ||
| + | <pre>{{Infobox mapframe |shape=none}}</pre> | ||
| + | |||
| + | ====Turn line feature off==== | ||
| + | Prevent line feature from being displayed: | ||
| + | <pre>{{Infobox mapframe |line=none}}</pre> | ||
| + | |||
| + | ===Show a geomask from a related Wikidata item=== | ||
| + | <pre>{{Infobox mapframe |geomask=}}</pre> | ||
| + | Set {{para|geomask}} to a Wikidata item id (Q-number), or property id (P-number) such as {{Q|P17}} | ||
| + | {{cot|Geomask examples}} | ||
| + | Use the item linked from the {{q|P17}} statement as a geomask: | ||
| + | <pre>{{Infobox mapframe |id=Q3239281 |geomask=P17}}</pre> | ||
| + | {{Infobox mapframe |id=Q3239281 |geomask=P17}} | ||
| + | Use the item {{q|Q1199}} as a geomask: | ||
| + | <pre>{{Infobox mapframe |id=Q3239281 |geomask=Q1199}}</pre> | ||
| + | {{Infobox mapframe |id=Q3239281 |geomask=Q1199}} | ||
| + | {{cob}} | ||
| + | |||
| + | ===Determine zoom from object length or area=== | ||
| + | Use {{para|length_km}} or {{para|length_mi}} or {{para|area_km2}} or {{para|area_mi2}} | ||
| + | {{cot|Zoom from length/area examples}} | ||
| + | Determine zoom from object length in kilometres or miles | ||
<pre>{{Infobox mapframe |id=Q1318331 |length_km=5.6}}</pre> | <pre>{{Infobox mapframe |id=Q1318331 |length_km=5.6}}</pre> | ||
<pre>{{Infobox mapframe |id=Q1318331 |length_mi=3.5}}</pre> | <pre>{{Infobox mapframe |id=Q1318331 |length_mi=3.5}}</pre> | ||
{{Infobox mapframe |id=Q1318331 |length_km=5.6}} | {{Infobox mapframe |id=Q1318331 |length_km=5.6}} | ||
| − | + | Determine zoom from object area in square kilometres or square miles | |
<pre>{{Infobox mapframe |id=Q100 |area_km2=232.14}}</pre> | <pre>{{Infobox mapframe |id=Q100 |area_km2=232.14}}</pre> | ||
<pre>{{Infobox mapframe |id=Q100 |area_mi2=89.63}}</pre> | <pre>{{Infobox mapframe |id=Q100 |area_mi2=89.63}}</pre> | ||
{{Infobox mapframe |id=Q100 |area_km2=232.14}} | {{Infobox mapframe |id=Q100 |area_km2=232.14}} | ||
| − | + | {{cob}} | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
===Parameters=== | ===Parameters=== | ||
| Line 71: | Line 107: | ||
;frame-height | ;frame-height | ||
:Frame height; default is "200" | :Frame height; default is "200" | ||
| + | ;shape-fill | ||
| + | :Color used to fill shape features; default is "#606060" | ||
| + | ;shape-fill-opacity | ||
| + | :Opacity level of shape fill, a number between 0 and 1; default is "0.5" | ||
;stroke-color | ;stroke-color | ||
:''or '''stroke-colour''''' | :''or '''stroke-colour''''' | ||
| Line 88: | Line 128: | ||
;geomask-stroke-width | ;geomask-stroke-width | ||
:Width of outline of geomask shape, default is "2" | :Width of outline of geomask shape, default is "2" | ||
| + | ;geomask-fill | ||
| + | :Color used to fill outside geomask features; default is "#606060" | ||
| + | ;geomask-fill-opacity | ||
| + | :Opacity level of fill outside geomask features, a number between 0 and 1; default is "0.5" | ||
;zoom | ;zoom | ||
:Set the zoom level, from "1" to "18", to used if the zoom level cannot be determined automatically from object length or area. Default is "10". | :Set the zoom level, from "1" to "18", to used if the zoom level cannot be determined automatically from object length or area. Default is "10". | ||
| Line 100: | Line 144: | ||
:Alternate longitude coordinate for initial placement of map; default is derived from item coordinates | :Alternate longitude coordinate for initial placement of map; default is derived from item coordinates | ||
| − | ==Examples== | + | ==Examples for use within templates== |
{{cot|Infobox hospital}} | {{cot|Infobox hospital}} | ||
{{tl|Infobox hospital}} (as of [https://en.wikipedia.org/w/index.php?title=Template:Infobox_hospital&oldid=919731352 5 October 2019]) | {{tl|Infobox hospital}} (as of [https://en.wikipedia.org/w/index.php?title=Template:Infobox_hospital&oldid=919731352 5 October 2019]) | ||
Revision as of 10:23, 6 May 2020
| 40px | This is a documentation subpage for Template:Infobox mapframe. It contains usage information, categories and other content that is not part of the original template page. |
| 30px | This template uses Lua: |
Template:Uses Wikidata Template:Tracks Wikidata Template:Sister project
| 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.
Note that a point feature marker is displayed at the coordinates of the page's Wikidata item, unless the item has an Lua error in Module:Wd at line 196: attempt to index field 'wikibase' (a nil value). (P402) specified.
- See Category:Infobox mapframe without OSM relation ID on Wikidata for pages which have items without Lua error in Module:Wd at line 196: attempt to index field 'wikibase' (a nil value). (P402)
Contents
Usage
Note: When in mainspace, parameter |id= is not required (except to use a different page's data)
Basic
{{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 Lua error in Module:Wd at line 196: attempt to index field 'wikibase' (a nil value). (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 Lua error in Module:Wd at line 196: attempt to index field 'wikibase' (a nil value). (P625) value, then no map will be displayed
Basic usage examples
|
|---|
|
Point feature (Wikidata coordinates): {{Infobox mapframe |id=Q7270550}}
Lua error in Module:Infobox_mapframe at line 40: attempt to index field 'wikibase' (a nil value). Line feature: {{Infobox mapframe |id=Q1318331}}
Lua error in Module:Infobox_mapframe at line 40: attempt to index field 'wikibase' (a nil value). Shape feature: {{Infobox mapframe |id=Q61}}
Lua error in Module:Infobox_mapframe at line 40: attempt to index field 'wikibase' (a nil value). |
Using specified coordinates instead of Wikidata
Point 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=yesis used, then those coordinate will be displayed, along with any line or shape features linked to the Wikidata item.
Specified coordinates examples
|
|---|
|
Point feature (with coordinates specified, no shape/line feature from Wikidata item): {{infobox mapframe |coord={{coord|31|56|S|115|58|E}} }}
Lua error in Module:Infobox_mapframe at line 40: attempt to index field 'wikibase' (a nil value). Point feature (with coordinates specified, along with shape/line feature from Wikidata item): {{infobox mapframe |wikidata=yes |coord={{coord|31|56|S|115|58|E}} }}
Lua error in Module:Infobox_mapframe at line 40: attempt to index field 'wikibase' (a nil value). |
Customizing feature display
Inverse shape
{{Infobox mapframe |shape=inverse}}
Replace the shape with an inverse-shape (geomask) by setting |shape=inverse
Inverse shape example
|
|---|
{{Infobox mapframe |id=Q61 |shape=inverse}}
Lua error in Module:Infobox_mapframe at line 40: attempt to index field 'wikibase' (a nil value). |
Turn point marker on or off
Force point marker to be displayed:
{{Infobox mapframe |point=on}}
Prevent point marker from being displayed:
{{Infobox mapframe |point=none}}
Turn shape feature off
Prevent shape feature from being displayed:
{{Infobox mapframe |shape=none}}
Turn line feature off
Prevent line feature from being displayed:
{{Infobox mapframe |line=none}}
{{Infobox mapframe |geomask=}}
Set |geomask= to a Wikidata item id (Q-number), or property id (P-number) such as Lua error in Module:Wd at line 196: attempt to index field 'wikibase' (a nil value). (P17)
Geomask examples
|
|---|
|
Use the item linked from the Lua error in Module:Wd at line 196: attempt to index field 'wikibase' (a nil value). (P17) statement as a geomask: {{Infobox mapframe |id=Q3239281 |geomask=P17}}
Lua error in Module:Infobox_mapframe at line 40: attempt to index field 'wikibase' (a nil value). Use the item Lua error in Module:Wd at line 196: attempt to index field 'wikibase' (a nil value). (Q1199) as a geomask: {{Infobox mapframe |id=Q3239281 |geomask=Q1199}}
Lua error in Module:Infobox_mapframe at line 40: attempt to index field 'wikibase' (a nil value). |
Determine zoom from object length or area
Use |length_km= or |length_mi= or |area_km2= or |area_mi2=
Zoom from length/area examples
|
|---|
|
Determine zoom from object length in kilometres or miles {{Infobox mapframe |id=Q1318331 |length_km=5.6}}
{{Infobox mapframe |id=Q1318331 |length_mi=3.5}}
Lua error in Module:Infobox_mapframe at line 40: attempt to index field 'wikibase' (a nil value). Determine zoom from object area in square kilometres or square miles {{Infobox mapframe |id=Q100 |area_km2=232.14}}
{{Infobox mapframe |id=Q100 |area_mi2=89.63}}
Lua error in Module:Infobox_mapframe at line 40: attempt to index field 'wikibase' (a nil value). |
Parameters
Other optional parameters are:
- frame-width
- Frame width; default is "270"
- frame-height
- Frame height; default is "200"
- shape-fill
- Color used to fill shape features; default is "#606060"
- shape-fill-opacity
- Opacity level of shape fill, a number between 0 and 1; default is "0.5"
- stroke-color
- or stroke-colour
- Color of line features, and outlines of shape features; default is "#ff0000"
- stroke-width
- Width of line features, and outlines of shape features; default is "5"
- marker
- Marker symbol to use for coordinates; default is "marker", see mw:Help:Extension:Kartographer/Icons for other options
- marker-color
- or marker-colour
- Background color for the marker; default is "#5E74F3"
- 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.
P17for Lua error in Module:Wd at line 196: attempt to index field 'wikibase' (a nil value). (P17),P131for Lua error in Module:Wd at line 196: attempt to index field 'wikibase' (a nil value). (P131)) - geomask-stroke-color
- or geomask-stroke-colour
- Color of outline of geomask shape, default is "#555555"
- geomask-stroke-width
- Width of outline of geomask shape, default is "2"
- geomask-fill
- Color used to fill outside geomask features; default is "#606060"
- geomask-fill-opacity
- Opacity level of fill outside geomask features, a number between 0 and 1; default is "0.5"
- zoom
- Set the zoom level, from "1" to "18", to used if the zoom level cannot be determined automatically from object length or area. Default is "10".
- frame-coordinates
- or frame-coord
- Alternate latitude and longitude coordinates for initial placement of map, using {{coord}}; default is derived from item coordinates
- frame-lat (deprecated)
- or frame-latitude
- Alternate latitude coordinate for initial placement of map; default is derived from item coordinates
- frame-long (deprecated)
- or frame-longitude
- Alternate longitude coordinate for initial placement of map; default is derived from item coordinates
Examples for use within templates
Infobox 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}}]]}}}}<!--
-->}}<!--
-->}}}<!--
-->}}
|
See also
- Wikipedia:Maps for Wikipedia, a list of mapping tools available on Wikipedia