Templeeti:Infobox mapframe

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

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.

• A point marker will be displayed if local coordinates are supplied or if the page's Wikidata item does have an NJ mmekọrịta OpenStreetMap (P402) or a geoshape (P3896).
• Shapes/lines will be displayed if local coordinates are not supplied or if the Wikidata item has either an NJ mmekọrịta OpenStreetMap (P402) or a geoshape (P3896).
• No map will be shown if local coordinates are not supplied and if the Wikidata item does not have a nhazi ọnọdụ (P625).

• See Category:Infobox mapframe without OSM relation ID on Wikidata for pages which have items without an OSM Relation or a Geoshape.
• Troubleshooting shapes guidance is found at Module talk:mapframe/FAQ

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 shape/line features, if they are available at OpenStreet Map.

• If the Wikidata item does not specify an NJ mmekọrịta OpenStreetMap (P402), a point marker will be additionally shown.

Basic usage examples

Point feature (Wikidata coordinates):

{{Infobox mapframe |id=Q7270550}}

Line feature:

{{Infobox mapframe |id=Q1318331}}

Shape feature:

{{Infobox mapframe |id=Q61}}

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 a point marker will always been shown and shape/line features will be shown only if the Wikidata item has an NJ mmekọrịta OpenStreetMap (P402) or a geoshape (P3896).
• If |coord= is specified and |wikidata=yes is used, then the point marker and any shape/line features will always be shown (if available on OpenStreetMap).

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}} }}

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}} }}

Customizing which features are displayed

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}}

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}}

Show a geomask from a related Wikidata item

{{Infobox mapframe |geomask=}}

Set |geomask= to a Wikidata item id (Q-number), or property id (P-number) such as mba/obodo (P17)

Geomask examples

Use the item linked from the mba/obodo (P17) statement as a geomask:

{{Infobox mapframe |id=Q3239281 |geomask=P17}}

Use the item Hesse (Q1199) as a geomask:

{{Infobox mapframe |id=Q3239281 |geomask=Q1199}}

Setting the zoom level

The zoom level of the map can always be set by an editor via |zoom=. If not explicitly set, the zoom is determined automatically:

• If the Wikidata item has an NJ mmekọrịta OpenStreetMap (P402) or geoshape (P3896), then the center and zoom of the image is set to nicely frame the shape/line.
• If the Wikidata item has an Ọkwa mbugharị OpenStreetMap (P6592), it will be used as the zoom level
• Any of the following parameters will specify a zoom level:
  • |length_km=
  • |length_mi=
  • |width_km=
  • |width_mi=
  • |area_km2=
  • |area_mi2=
  • |area_ha=
  • |area_acre=
• The zoom will be set by specifying the |type= of the object, with the same usage as {{coord}}. For example, |type=city. In the case of a city, the population can determine the zoom by specifying |population=.

Zoom examples

Set zoom manually

{{Infobox mapframe|coord={{coord|37|45|N|119|32|W}}|zoom=8}}

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}}

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}}

Parameters

All parameters are optional.

• Basic {{Infobox mapframe}} parameters:
  • id – Id (Q-number) of Wikidata item to use. Default: item for current page
  • wikidata – Set to yes to show all shape/line features from OpenStreetMap. Default: not specified
• Customise which features are displayed:
  • point – Turn off display of point feature by setting to none. Force point marker to be displayed by setting to on. Default: not specified
  • shape – Turn off display of shape feature by setting to none. Force display of shape by setting to on. Use an inverse shape (geomask) instead of a regular shape by setting to inverse. Default: not specified
  • line – Turn off display of line feature by setting to none. Force display of line by setting to on. 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 mba/obodo (P17), P131 for dị na ngalaba nhazi mpaghara (P131)). Default: not specified
  • switcher – set to auto or geomasks or zooms to enable Template:Switcher-style switching between multiple mapframes. Default: not specified
    • auto – switch geomasks found in ebe (P276) and dị na ngalaba nhazi mpaghara (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 parameter
    • zooms – switch between "zoomed in"/"zoomed midway"/"zoomed out", where "zoomed in" is the default zoom (with a minimum of 3), "zoomed out" is 1, and "zoomed midway" is the average
• 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.1
  • stroke-color or stroke-colour – Color of line features, and outlines of shape features. Default: #ff0000
    • line-stroke-color or line-stroke-colour – Color of line features. Default: #ff0000
    • shape-stroke-color or shape-stroke-colour – Color of outlines of shape features. Default: #ff0000
  • stroke-width – Width of line features, and outlines of shape features. Default: 2
    • shape-stroke-width – Width of outlines of shape features. Default: 2
    • line-stroke-width – Width of line features. 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
  • 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: 1
  • 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.25
  • 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 / not specified / not specified / not specified
  • frame-coordinates or frame-coord – Alternate latitude and longitude coordinates for initial placement of map, using {{coord}}. Default: derived from item coordinates
  • type – Set the type of the object, with the same usage as {{coord}}. Default: not specified
  • population – Set the population, useful with type="city", for {{Infobox dim}}. Default: not specified

• 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

Use within templates

Please use Module:Infobox mapframe#Automatic maps in infoboxes.

Template Data

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Infobox mapframe in articles based on its TemplateData.

TemplateData for Infobox mapframe

TemplateData documentation used by VisualEditor and other tools

Enweghị nkọwa.

Ụdị ụkpụrụ

Oke		Nkọwa	Dee	Ọnọdụ
Show mapframe map	mapframe	Specify yes or no to show or hide the map, overriding the default Nke éjị bịdó no Ịhe àtụ̀ yes	Eriri	Na-atụ aro
Mapframe caption	caption	Caption for the map. If geomask is set, then the default is "Location in <<geomask's label>>"	Eriri	Nhọrọ
Custom mapframe	custom	Use a custom map instead of the automatic mapframe. Specify either a {{maplink}} template, or another template that generates a mapframe map, or an image name. If used, other mapframe parameters will be ignored.	Àtụ	Nhọrọ
Mapframe Wikidata item	id id qid	Id (Q-number) of Wikidata item to use. Nke éjị bịdó (item for current page)	Eriri	Nhọrọ
Mapframe coordinates	coordinates coord coordinates coord	Coordinates to use, instead of any on Wikidata. Use the {{Coord}} template. Nke éjị bịdó (coordinates from Wikidata) Ịhe àtụ̀ {{Coord|12.34|N|56.78|E}}	Àtụ	Nhọrọ
Mapframe shapes from Wikidata	wikidata	et to yes to show shape/line features from the wikidata item, if any, when coordinates are specified by parameter Ịhe àtụ̀ yes	Eriri	Nhọrọ
Mapframe point feature	point	Override display of mapframe point feature. Turn off display of point feature by setting to "none". Force point marker to be displayed by setting to "on"	Eriri	Nhọrọ
Mapframe shape feature	shape	Override display of mapframe shape feature. Turn off by setting to "none". Use an inverse shape (geomask) instead of a regular shape by setting to "inverse"	Eriri	Nhọrọ
Mapframe width	frame-width width	Frame width in pixels Nke éjị bịdó 270	Ọnụ ọgụgụ	Nhọrọ
Mapframe height	frame-height height	Frame height in pixels Nke éjị bịdó 200	Ọnụ ọgụgụ	Nhọrọ
Mapframe shape fill	shape-fill	Color used to fill shape features Nke éjị bịdó #606060	Eriri	Nhọrọ
Mapframe shape fill opacity	shape-fill-opacity	Opacity level of shape fill, a number between 0 and 1 Nke éjị bịdó 0.1	Ọnụ ọgụgụ	Nhọrọ
Mapframe stroke color	stroke-color stroke-colour	Color of line features, and outlines of shape features Nke éjị bịdó #ff0000	Eriri	Nhọrọ
Mapframe stroke width	stroke-width	Width of line features, and outlines of shape features Nke éjị bịdó 2	Ọnụ ọgụgụ	Nhọrọ
Mapframe line stroke color	line-stroke-color line-stroke-colour	Color of line features Nke éjị bịdó #ff0000	Eriri	Nhọrọ
Mapframe line stroke width	line-stroke-width	Width of line features Nke éjị bịdó 5	Ọnụ ọgụgụ	Nhọrọ
Mapframe shape stroke color	shape-stroke-color shape-stroke-colour	Color of outlines of shape features Nke éjị bịdó #ff0000	Eriri	Nhọrọ
Mapframe shape stroke width	shape-stroke-width	Width of outlines of shape features Nke éjị bịdó 2	Ọnụ ọgụgụ	Nhọrọ
Mapframe marker	marker	Marker symbol to use for coordinates; see [[mw:Help:Extension:Kartographer/Icons]] for options Ịhe àtụ̀ museum	Eriri	Nhọrọ
Mapframe marker color	marker-color marker-colour	Background color for the marker Nke éjị bịdó #5E74F3	Eriri	Nhọrọ
Mapframe geomask	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, or P131 for located in the administrative territorial entity) Ịhe àtụ̀ Q100	Áhà ihü:	Nhọrọ
Mapframe geomask stroke color	geomask-stroke-color geomask-stroke-colour	Color of outline of geomask shape Nke éjị bịdó #555555	Eriri	Nhọrọ
Mapframe geomask stroke width	geomask-stroke-width	Width of outline of geomask shape Nke éjị bịdó 1	Ọnụ ọgụgụ	Nhọrọ
Mapframe geomask fill	geomask-fill	Color used to fill outside geomask features Nke éjị bịdó #606060	Eriri	Nhọrọ
Mapframe geomask fill opacity	geomask-fill-opacity	Opacity level of fill outside geomask features, a number between 0 and 1 Nke éjị bịdó 0.25	Ọnụ ọgụgụ	Nhọrọ
Mapframe 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. NB: default may also be set by Kartographer automatically based on the features rendered. Nke éjị bịdó 10 Ịhe àtụ̀ 12	Ọnụ ọgụgụ	Nhọrọ
Mapframe length (km)	length_km	Object length in kilometres, for automatically determining zoom level. ONLY use ONE of the available parameters for length or area	Ọnụ ọgụgụ	Nhọrọ
Mapframe length (mi)	length_mi	Object length in miles, for automatically determining zoom level. ONLY use ONE of the available parameters for length or area	Ọnụ ọgụgụ	Nhọrọ
Mapframe area (km^2)	area_km2	Object arean square kilometres, for automatically determining zoom level. ONLY use ONE of the available parameters for length or area	Ọnụ ọgụgụ	Nhọrọ
Mapframe area (mi^2)	area_mi2	Object area in square miles, for automatically determining zoom level. ONLY use ONE of the available parameters for length or area	Ọnụ ọgụgụ	Nhọrọ
Mapframe frame coordinates	frame-coordinates frame-coord	Alternate latitude and longitude coordinates for initial placement of map, using {{coord}} Ịhe àtụ̀ {{Coord|12.35|N|56.71|E}}	Àtụ	Nhọrọ
Mapframe switcher	switcher	Set to "auto" or "geomasks" or "zooms" to enable Template:Switcher-style switching between multiple mapframes. IF SET TO auto – 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. IF SET TO geomasks – switch between the geomasks specified as a comma-separated list of Wikidata items (Q-numbers) in the geomask parameter. IF SET TO zooms – switch between "zoomed in"/"zoomed midway"/"zoomed out", where "zoomed in" is the default zoom (with a minimum of 3), "zoomed out" is 1, and "zoomed midway" is the average.	Eriri	Nhọrọ
Mapframe line feature	line	Turn off display of line feature by setting to none. Force display of line by setting to on.	Eriri	Nhọrọ
Mapframe type	type	Type of the object rendered in the mapframe, like with {{coord}}.	Eriri	Nhọrọ

Tracking category

• Category:Pages using infobox mapframe with unknown parameters (0)
• Category:Pages using infobox mapframe with missing coordinates (0)
• Category:Pages using infobox mapframe with forced centering (0)

See also

• Wikipedia:Mapframe maps in infoboxes, inclusion of this kind of functionality in infoboxes by default
• Wikipedia:Maps for Wikipedia, a list of mapping tools available on Wikipedia

The above documentation is transcluded from Templeeti:Infobox mapframe/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this template.