Fyrimynd:Infobox map/doc

This helper template provides a way to display a map in an Infobox. Optionally a location marker can be included.

Usage

Parameter descriptions

Field name	Description
map	The name of the map to be displayed. This is the only required parameter.
map_width	The width of the map image to be displayed. For example, map_width=220 and not map_width=220px.
default_width	When this template is used in another template, e.g. an infobox, the default width of the map image preferred by the infobox should be specified here. For example, map_width=220. When used with location maps, this value may be modified by a certain value if specified in the location map template. The default value is 220px.
relief	Selects a relief map when assigned any value. This only works when the geographical coordinates method is used and then only for a few maps. See Map display methods.
map_alt	Alt text for the map. A visually impaired reader who uses a screen reader will have access to this text. See WP:ALT.
map_caption	The caption that appears below the map if one is required.
mark	The image file that will be used to mark the location on the map. The default is Red pog.svg. See below.
mark_width	The width of the marker image to be displayed. For example, mark_width=8 and not mark_width=8px. The default width is 8px.
label	A text message that will be displayed next to the marker.
label_position	The position of a label with respect to the marker. Valid values are left, right, top, bottom and none.
lat long	Specifies the latitude and longitude of the location when the geographical coordinates method is used. This value may be specified as a signed decimal degree.
lat_deg lat_min lat_sec lat_dir lon_deg lon_min lon_sec lon_dir	Specifies the latitude and longitude of the location when the geographical coordinates method is used. This value may be specified in dms+hemisphere format.
x y	Specifies the position of the location marker. The coordinates of the marker in pixels based on a map width of 1000 pixels. The template will scale these values for proper display. See below.
x% y%	Specifies the position of the location marker. x% specifies the percentage of the distance across the image from the left edge and y% specifies the percentage of the distance down from the top edge. See below.

Map display methods

There are three methods which can display a mark to on a map. These examples use {{Infobox park}} which uses this template as a back end.

Display a marker on a map using a template and geographic coordinates

A marker can be superimposed on a map using one of a set of special map templates. To display a marker the geographic coordinates must be specified using the parameters lat_d, long_d, etc. See the documentation for {{Location map}}. The parameters for this template map to a subset of the parameters used by {{Location map}}. A map template can be found using these sources:

List of templates - Many of the listed items are redirects and a few templates may not function as expected.

Category:Location map templates - templates sorted by category.

Special:WhatLinksHere/Template:Location map/Info - a search that might help.

Special:Prefixindex/Template:Location map - another search that might help.

All of the names begin with the words "Location map" followed by the area covered. The value you need to specify is the area name. The map template for the Canada is Location map Canada. In this case specify map=Canada.

Four Corners, Canada
Mynd:Canada Example using geographic coordinates
Koordinatir	60°00′00″N 102°00′00″W

{{Infobox park
| name = Four Corners, Canada
| map = Canada
| map_caption = Example using geographic coordinates
| lat_d = 60 | lat_m = 00 | lat_s = 00 | lat_NS = N
| long_d = 102 | long_m = 00 | long_s = 00 | long_EW = W
}}

Display a marker on any map image using the x and y parameters

The values for the x and y parameters are the pixel coordinates of the location mark when the image is scaled to a width of 1000 pixels.

x is the pixel offset for the mark from the left edge of an image 1000px wide.

y is the pixel offset for the mark from the top edge of an image 1000px wide.

There are at least two ways of obtaining these values:

1. Download the image from the image's file page to your computer. Open the image in a graphics editor, such as GIMP or XnView. Scale (resize) the image to a width of 1000px and then note the x, y coordinates when the cursor points to the desired location. Use these values directly.
2. Download the image from the image's file page to your computer. Open the image in any image viewer that displays the coordinates of the cursor position, such as Paint from Microsoft. Note the x, y coordinates when the cursor points to the location. Then:

1000 · x'/w = x  and  1000 · y'/w = y

where x' and y' are the cursor coordinates, w is the width of the image displayed on your computer and x and y are the values to assign to the x and y parameters.

Four Corners, Canada
Example using the x and y parameters

{{Infobox park
| name = Four Corners, Canada
| map = Canada location map.svg
| map_caption = Example using the x and y parameters
| x = 369
| y = 487
}}

Display a marker on any map image using the x% and y% parameters

x% specifies the percent of the distance across the image from the left edge.

y% specifies the percent of the distance down from the top edge.

In the following example the marker is 36.9% of the way across and 57.4% of the way down.

Four Corners, Canada
Example using the x% and y% parameters

{{Infobox park
| name = Four Corners, Canada
| map = Relief map of Canada.png
| map_caption = Example using the x% and y% parameters
| x% = 36.9
| y% = 57.4
}}

Display any image

Another option allows the display of any image without a location mark.

Average regional brazil nut output (kg/ha)

{{Infobox
| above =
| image2 = {{Infobox map
           | map         = Braziloutput.png
           | map_alt     = A world map showing regions that produce Brazil nuts.
           | map_caption =
           | map_width   = 200
           }}
}}

Marks

A mark can be any image file. The default mark is Red pog.svg and it works well because it is easy to pick up visually on most maps. Some examples are below. Click on an image to see the file description page.

See Location markers for other examples. Currently, using mark_width=n for n > 8 is not advised when a label is specified.

Geographical coordinates

To display coordinates in the Infobox two methods can be used. The template {{Infobox coord}} can be used to display coordinates entered using the method discussed above. If the X,Y method is used to display a marker then the template {{coord}} can be used. For examples of coordinate entry see coordinate examples.

TemplateData

Hetta er TemplateData dokumentatiónin fyri hesa fyrimynd, ið verður brúkt av VisualEditor og øðrum tólum.

Infobox map

No description.

Template parameters

Parameter		Description	Type	Status
Map	map	The name of the map to be displayed	String	required
Map Width	map_width	The width of the map image to be displayed.	Number	optional
Default Width	default_width	When this template is used in another template, the default width is given using this parameter	Number	optional
Relief	relief	Selects a relief map when assigned any value	String	optional
Map Alternative Text	map_alt	Alternative text to be displayed if the map isnt displayed for whatever reasons	String	optional
Map Caption	map_caption	Caption for the map	String	optional
Mark	mark	The image file that will be used to mark the location on the map	Page name	optional
Mark Width	mark_width	The width of the marker image to be displayed	Number	optional
Label	label	A text message that will be displayed next to the marker.	String	optional
Label Position	label_position	The position of a label with respect to the marker	String	optional
Latitude	lat	Latitude of the map	Number	optional
Longitude	long	Longitude of the map	Number	optional
X	x	Specifies the position of x location marker	Number	optional
Y	y	Specifies the position of y location marker	Number	optional
X%	x%	x% specifies the percentage of the distance across the image from the left edge	Number	optional
Y%	y%	y% specifies the percentage of the distance down from the top edge	Number	optional

Sí eisini

• {{Location map}}
• {{Superimpose}}
• Category:Pages using Template:Infobox map needing attention (hidden tracking/maintenance category)