មើលកូដរបស់ ទំព័រគំរូ:Location map many/doc

'''Template:Location map many''' creates a location map as a [[m:Help:composite images|composite image]] of an existing map, with multiple (up to 9) markers and optional labels superimposed onto it.  This template functions in the style of [[Template:Location_map]], but allows 9 markers and labels (rather than just one marker).

For an unlimited list of markers/labels, see: ''[[Template:Location map+]]'', which specifies points as a coded template list of markers/labels.

== Usage ==
The first unnamed parameter (shown as <nowiki>{{{1}}}</nowiki> below) specifies a map definition template. If <nowiki>{{{1}}}</nowiki> is ''Spain'', the map image and coordinates are based on the values defined in [[Template:Location map Spain]].
{|
| <pre>
{{Location map many
| {{{1}}}
| width       = 
| float       = 
| border      = 
| caption     = 
| alt         = 
| relief      = 
| AlternativeMap = 
| <!--first label/marker-->
| label1      =  <!-- or: label -->
| label1_size =  <!-- or: label_size -->
| position1   =  <!-- or: position, pos1, pos -->
| background1 =  <!-- or: background, bg1, bg -->
| mark1       =  <!-- or: mark -->
| mark1size   =  <!-- or: marksize -->
| link1       =  <!-- or: link -->
| lat1_deg    =  <!-- or: lat_deg -->
| lat1_min    =  <!-- or: lat_min -->
| lat1_sec    =  <!-- or: lat_sec -->
| lat1_dir    =  <!-- or: lat_dir -->
| lon1_deg    =  <!-- or: lon_deg -->
| lon1_min    =  <!-- or: lon_min -->
| lon1_sec    =  <!-- or: lon_sec -->
| lon1_dir    =  <!-- or: lon_dir -->
| <!--second label/marker-->
| label2      = 
| label2_size = 
| position2   =  <!-- or: pos2 -->
| background2 =  <!-- or: bg2 -->
| mark2       = 
| mark2size   = 
| link2       = 
| lat2_deg    = 
| lat2_min    = 
| lat2_sec    = 
| lat2_dir    = 
| lon2_deg    = 
| lon2_min    = 
| lon2_sec    = 
| lon2_dir    = 
| <!--repeat as needed up to 9-->
}}
</pre>
|}

== Parameters ==
{| class="wikitable" style="width:100%;"
! colspan="2" style="background-color:lightblue" | Map display parameters
|-
! Parameter
! Description
|-
| <tt>{{{1}}}</tt>
| '''Required'''. Use the name of the map as the first unnamed parameter. For example, specify ''England'' to use the values in {{tl|Location map England}}. See the [[#Examples|examples]] below.
|-
| <tt>width</tt>
| Determines the width of the map in [[pixel]]s. The default is 240. '''Do not''' include <code>px</code>, for example: <code>width=300</code>, not <code>width=300px</code>.
|-
| <tt>float</tt>
| Specifies the position of the map on the page. Valid values are <code>left</code>, <code>right</code>, <code>center</code> and <code>none</code>. The default is <code>right</code>''.
|-
| <tt>border</tt>
|  Specifies the color of the 1px map border. The default is ''lightgrey'' (see [[web colors]]). If set to <code>none</code>, no border will be generated. This parameter is seldom used.
|-
| <tt>caption</tt>
| The text of a caption to be displayed below the map. Specifying a caption will cause the map to be displayed with a frame. If <code>caption</code> is defined but is not assigned a value, the map will not be framed and no caption will be displayed. If <code>caption</code> is not defined, the map will not be framed and a default caption will be generated. The default caption is created from the <tt>label</tt> parameter (or the current page name if label not defined) and the <tt>name</tt> parameter from map definition template. See the [[#Examples|examples]] below.
|-
| <tt>alt</tt>
| Alt text for map; used by [[screen reader]]s, see [[WP:ALT]].
|-
| <tt>relief</tt>
| Any non-blank value (1, yes, etc.) will cause the template to display the map specified in the map definition template as <tt>image1</tt>, which is usually a [[Relief mapping (computer graphics)|relief map]]. See the example at [[Template:Location map+/relief|Location map+/relief]].
|-
| <tt>AlternativeMap</tt>
| Allows the use of an alternative map. The image must have the same edge coordinates as the location map template. See the example at [[Template:Location map+/AlternativeMap|Location map+/AlternativeMap]].
|-
| <tt>overlay_image</tt>
| Allows an overlay to be superimposed on the map. This parameter is seldom used. See the example at [[Template:Location map+/overlay|Location map+/overlay]].
|-
! colspan="2" style="background-color:lightblue" | Label and mark parameters
|-
! Parameter
! Description
|-
| <tt>label1</tt><br/>...<br/><tt>label9</tt>
| The text of the label to display next to the mark. A [[Wiki markup|wiki link]] can be used. The default if not specified is no label, just the marker.
|-
| <tt>label1_size</tt><br/>...<br/><tt>label9_size</tt>
| The font size to use for the label, given as a percentage of the normal font size (<100 = smaller, >100 = larger). The default is 90. Do not include <code>%</code>, for example: <code>label_size=80</code>, not <code>label_size=80%</code>.
|-
| <tt>position1</tt><br/>...<br/><tt>position9</tt>
| The position of the label relative to the mark. Valid values are <code>left</code>, <code>right</code>, <code>top</code> and <code>bottom</code>. The default is <code>right</code>''.
|-
| <tt>background1</tt><br/>...<br/><tt>background9</tt>
| The background color to use for the label. See [[Web colors]]. The default is no background color, which shows the map image behind the label.
|-
| <tt>mark1</tt><br/>...<br/><tt>mark9</tt>
| The name of an image to display as the mark. The default is [[:File:Red pog.svg|Red pog.svg]] ([[File:Red pog.svg|8px]]). See examples at [[Commons:Location markers]] and [[Commons:Category:Map icons]].
|-
| <tt>mark1size</tt><br/>...<br/><tt>mark9size</tt>
| The size of the mark in [[pixel]]s. The default is 8. Do not include <code>px</code>, for example: <code>marksize=10</code>, not <code>marksize=10px</code>.
|-
| <tt>link1</tt><br/>...<br/><tt>link9</tt>
| Specifies a [[Wiki markup|wiki link]] which will be followed if the reader clicks on the mark. The name of the linked article is displayed when the mouse pointer hovers over the mark.
|-
| <tt>lat1_deg</tt><br/>...<br/><tt>lat9_deg</tt>
| '''Required'''. The degrees of [[latitude]]. This value can be specified using [[decimal degrees]] and when this format is used minutes and seconds should not be specified.
|-
| <tt>lat1_min</tt><br/>...<br/><tt>lat9_min</tt>
| The minutes of latitude.
|-
| <tt>lat1_sec</tt><br/>...<br/><tt>lat9_sec</tt>
| The seconds of latitude. Usually not necessary.
|-
| <tt>lat1_dir</tt><br/>...<br/><tt>lat9_dir</tt>
| N if north (default value) or S for south of the [[Equator]]. Other values will be disregarded. Not required if using signed decimal degrees (i.e. negative numbers for southern latitude).
|-
| <tt>lon1_deg</tt><br/>...<br/><tt>lon9_deg</tt>
| '''Required'''. The degrees of [[longitude]]. This value can be specified using [[decimal degrees]] and when this format is used minutes and seconds should not be specified.
|-
| <tt>lon1_min</tt><br/>...<br/><tt>lon9_min</tt>
| The minutes of longitude.
|-
| <tt>lon1_sec</tt><br/>...<br/><tt>lon9_sec</tt>
| The seconds of longitude. Usually not necessary.
|-
| <tt>lon1_dir</tt><br/>...<br/><tt>lon9_dir</tt>
| E for east (default value) or W for west of the [[Prime Meridian]]. Other values will be disregarded. Not required if using signed decimal degrees (i.e. negative numbers for western longitude).
|}

Note: For brevity, parameters "pos" & "bg" are aliases (for "position" & "background"), with pos2, bg2, pos3, bg3, etc.

== Markers ==
When a marker's mark<small>#</small>size=0, then that marker is skipped and only the related label is displayed, without the marker.

Each mark, mark2, mark3 (etc.) can be another image-symbol, such as [[:File:Diamond_sheer_red_20.gif|Diamond_sheer_red_20.gif]] (marksize=20) to show a red diamond on the image: [[Image:Diamond_sheer_red_20.png|20px]] or use: [[:File:Cercle_rouge_100%.svg|Cercle_rouge_100%.svg]] to show a red circle [[File:Cercle rouge 100%.svg|20px]] or a larger black diamond: [[:File:Diamond_sheer_black_37.gif|Diamond_sheer_black_37.gif]] as sized with a larger marksize=37 or similar number to resize the diamond somewhat: [[File:Diamond_sheer_black_37.png|37px]]
: ''See Wikimedia pointer symbols:'' [[:commons:Category:Map pointers]].

== Advisory messages ==
The degrees of latitude/longitude are validated, to show error messages, but location minutes can be set very large to place markers outside the map (with no warnings). Due to the numerous details of specifying 9 markers/labels, the latitude and longitude are checked to lie within the actual map limits specified in ''Template:Location_map_<parameter1>''.  Each marker/label is checked and can list a warning message (under the map), such as:
:::: Latitude#4 (45.68) < map min(53.74).

Processing continues, with that marker actually placed off-map, and all latitude/longitude parameters are checked, for a total of 18 possible advisory messages.  Only degrees of latitude/longitude are checked, so a value of 63 minutes would be valid to indicate 1 extra degree + 3 minutes, and setting lon_min=200 could still place a marker off-map (right-side) with no warning message.  Also, large markers or long labels can spill over the edges of a map, allowing markers to point inward from outside the map.  In such cases, a map could be centered by itself on the page ("float=center") to avoid overlapping the edge markers onto any surrounding article text.

== Available maps ==
Partial list of live templates named ''Template:Location_map_<locname>'' (without "Template:" prefix here, A-F):

[[Special:Prefixindex/Template:Location_map_]]

== Creating new maps ==
#Find an appropriate blank map in [[equirectangular projection]] (otherwise, coordinates will drift off, typically further north)
#Create a template named "Template:Location_map_''locname''" (copy the content of any other map template into it and enter appropriate values).
#Set default parameter values (using those parameter names), such as setting "mark" with image-file name and "marksize" for pixels wide/tall, or set default label font size ("label_size = 78" percent).
#Parameter names not used by "[[Template:Location_map]]" will be ignored by it, and only used for multiple-markers (such as defaulting "label2_size = 78" percent, or "mark2size=7" pixels).

== Examples ==

=== Map with label "Pag" and "Anytown" (degrees) ===
{{Location map many | Croatia
| width = 280
| float = right
| label = Pag
  | marksize = 8
  | pos = right
  | bg = yellow
  | lat_deg = 44 | lat_min = 26
  | lon_deg = 15 | lon_min = 3
| label2 = Anytown_Anywhere
  | mark2 = Rouge-Admin JollyRoger.svg
  | mark2size = 45
  | pos2 = top
  | bg2 = white
  | lat2_deg = 46 | lat2_min = 30
  | lon2_deg = 17 | lon2_min = 30
}}
<pre style="width: 35em;">
{{Location map many | Croatia
| width = 280
| float = right
| label = Pag
  | marksize = 8
  | pos = right
  | bg = yellow
  | lat_deg = 44 | lat_min = 26
  | lon_deg = 15 | lon_min = 3
| label2 = Anytown_Anywhere
  | mark2 = Rouge-Admin JollyRoger.svg
  | mark2size = 45
  | pos2 = top
  | bg2 = white
  | lat2_deg = 46 | lat2_min = 30
  | lon2_deg = 17 | lon2_min = 30
}}
</pre>
{{clear}}

=== Map with 3 labels (decimal) ===
{{Location map many | Croatia
| width = 260
| float = right
| label = Pag
  | pos = right
  | marksize = 8
  | lat_deg = 44.44
  | lon_deg = 15.05
| label2 = Anytown
  | pos2 = bottom
  | bg2 = yellow
  | mark2size = 8
  | lat2_deg = 45.86
  | lon2_deg = 17.50
| label3 = Anytown2
  | pos3 = top
  | bg3 = lightgreen
  | lat3_deg = 46.23
  | lon3_deg = 18.43
}}
<pre style="width: 35em;">
{{Location map many | Croatia
| width = 260
| float = right
| label = Pag
  | pos = right
  | marksize = 8
  | lat_deg = 44.44
  | lon_deg = 15.05
| label2 = Anytown
  | pos2 = bottom
  | bg2 = yellow
  | mark2size = 8
  | lat2_deg = 45.86
  | lon2_deg = 17.50
| label3 = Anytown2
  | pos3 = top
  | bg3 = lightgreen
  | lat3_deg = 46.23
  | lon3_deg = 18.43
}}
</pre>
{{clear}}

=== Example map with red triangle===
{{Location map many | 100x100
| AlternativeMap = LocationJamaica.svg
| float = right
| width = 250
| caption = Site of '''Hispaniola'''
| label = Hispaniola
  | position = left
  | background = #CCDDFF
  | marksize = 1
  | lat_deg = 38.2
  | lon_deg = 69.3
| label2 =
  | mark2 =Diamond_sheer_red_37.png
  | mark2size = 42
  | lat2_deg = 52.2
  | lon2_deg = 73.9
| label3 = Cuba
  | pos3 = left
  | mark3size = 1
  | lat3_deg = 59.2
  | lon3_deg = 68.0
}}
<pre style="width: 35em;">
{{Location map many | 100x100
| AlternativeMap = LocationJamaica.svg
| float = right
| width = 250
| caption = Site of '''Hispaniola'''
| label = Hispaniola
  | position = left
  | background = #CCDDFF
  | marksize = 1
  | lat_deg = 38.2
  | lon_deg = 69.3
| label2 =
  | mark2 =Diamond_sheer_red_37.png
  | mark2size = 42
  | lat2_deg = 52.2
  | lon2_deg = 73.9
| label3 = Cuba
  | pos3 = left
  | mark3size = 1
  | lat3_deg = 59.2
  | lon3_deg = 68.0
}}
</pre>
{{clear}}

=== Map with some labels outside map ===
{{Location map many | Croatia
| width = 260
| float = right
| label = Pag | position=right
  | marksize = 8
  | lat_deg = 44.44
  | lon_deg = 15.05
| label2 = Anytown
  | pos2 = bottom
  | bg2 = yellow
  | marksize = 8
  | lat2_deg = 47.40
  | lon2_deg = 12.80
| label3 = Anytown2
  | pos3 = top
  | bg3 = lightgreen
  | lat3_deg = 41.98
  | lon3_deg = 18.43
| label4 = North Croatia
  | pos4 = left
  | bg4 = lightgreen
  | mark4size = 0
  | lat4_deg = 46.22
  | lon4_deg = 17.7
}}
<pre style="width: 35em;">
{{Location map many | Croatia
| width = 260
| float = right
| label = Pag | position=right
  | marksize = 8
  | lat_deg = 44.44
  | lon_deg = 15.05
| label2 = Anytown
  | pos2 = bottom
  | bg2 = yellow
  | marksize = 8
  | lat2_deg = 47.40
  | lon2_deg = 12.80
| label3 = Anytown2
  | pos3 = top
  | bg3 = lightgreen
  | lat3_deg = 41.98
  | lon3_deg = 18.43
| label4 = North Croatia
  | pos4 = left
  | bg4 = lightgreen
  | mark4size = 0
  | lat4_deg = 46.22
  | lon4_deg = 17.7
}}
</pre>
{{clear}}

=== Map with 9 markers (decimal) ===
{{Location map many | Croatia
| width = 260
| float = right
| label = Pag
  | position = right
  | lat_deg = 44.44
  | lon_deg = 15.05
| label2 = Anytown
  | label2_size = 110
  | pos2 = bottom
  | background2 = yellow
  | lat2_deg = 45.86
  | lon2_deg = 17.50
| label3 = Anytown2
  | label3_size = 290
  | pos3 = top
  | background3 = green
  | lat3_deg = 46.23
  | lon3_deg = 18.43
| mark4 =Diamond_sheer_black_20.png
  | mark4size = 19
  | label4 = 44.0 (latitude)
  | lat4_deg = 44.00
  | lon4_deg = 13.5
| mark5 =Diamond_sheer_black_20.png
  | mark5size = 20
  | label5 = 44.5
  | lat5_deg = 44.50
  | lon5_deg = 13.5
| mark6 =Diamond_sheer_black_20.png
  | mark6size = 20
  | label6 = 45.0
  | lat6_deg = 45.00
  | lon6_deg = 13.5
| mark7 =Diamond_sheer_black_20.png
  | mark7size = 20
  | label7 = 45.5
  | lat7_deg = 45.50
  | lon7_deg = 13.5
| mark8 =Diamond_sheer_black_20.png
  | mark8size = 20
  | label8 = 46.0
  | lat8_deg = 46.00
  | lon8_deg = 13.5
| label9 = ''CROATIA''
  | label9_size = 165
  | mark9size = <!--label only-->1
  | lat9_deg = 42.60
  | lon9_deg = 14.4
}}
<pre style="width: 35em;">
{{Location map many | Croatia
| width = 260
| float = right
| label = Pag
  | position = right
  | lat_deg = 44.44
  | lon_deg = 15.05
| label2 = Anytown
  | label2_size = 110
  | pos2 = bottom
  | background2 = yellow
  | lat2_deg = 45.86
  | lon2_deg = 17.50
| label3 = Anytown2
  | label3_size = 290
  | pos3 = top
  | background3 = green
  | lat3_deg = 46.23
  | lon3_deg = 18.43
| mark4 =Diamond_sheer_black_20.png
  | mark4size = 19
  | label4 = 44.0 (latitude)
  | lat4_deg = 44.00
  | lon4_deg = 13.5
| mark5 =Diamond_sheer_black_20.png
  | mark5size = 20
  | label5 = 44.5
  | lat5_deg = 44.50
  | lon5_deg = 13.5
| mark6 =Diamond_sheer_black_20.png
  | mark6size = 20
  | label6 = 45.0
  | lat6_deg = 45.00
  | lon6_deg = 13.5
| mark7 =Diamond_sheer_black_20.png
  | mark7size = 20
  | label7 = 45.5
  | lat7_deg = 45.50
  | lon7_deg = 13.5
| mark8 =Diamond_sheer_black_20.png
  | mark8size = 20
  | label8 = 46.0
  | lat8_deg = 46.00
  | lon8_deg = 13.5
| label9 = ''CROATIA''
  | label9_size = 165
  | mark9size = <!--label only-->1
  | lat9_deg = 42.60
  | lon9_deg = 14.4
}}
</pre>
{{clear}}

=== Map with a custom label and text background ===
{{Location map many | Croatia
| width = 280
| float = right
| caption = Imotski in Croatia
| label = Imotski
| position = right
| background = #FFFFDD
| lat_deg = 43.44
| lon_deg = 17.21
}}
<pre style="width: 35em;">
{{Location map many | Croatia
| width = 280
| float = right
| caption = Imotski in Croatia
| label = Imotski
| position = right
| background = #FFFFDD
| lat_deg = 43.44
| lon_deg = 17.21
}}
</pre>
{{clear}}

=== Map with enlarged marker and label ===
{{Location map many | Croatia
| width = 260
| float = right
| caption = Pag Island in Croatia
| label = Pag
| label_size = 200
| position = right
| marksize = 14
| background = #FFFFDD
| lat_deg = 44.44
| lon_deg = 15.05
}}
<pre style="width: 35em;">
{{Location map many | Croatia
| width = 260
| float = right
| caption = Pag Island in Croatia
| label = Pag
| label_size = 200
| position = right
| marksize = 14
| background = #FFFFDD
| lat_deg = 44.44
| lon_deg = 15.05
}}
</pre>
{{clear}}

=== Map with no caption ===
{{Location map many | Bosnia
| width = 150
| float = right
| caption =
| label = Brčko
| position = left
| lat_deg = 44.87
| lon_deg = 18.81
}}
<pre style="width: 35em;">
{{Location map many | Bosnia
| width = 150
| float = right
| caption =
| label = Brčko
| position = left
| lat_deg = 44.87
| lon_deg = 18.81
}}
</pre>
{{clear}}

=== Western Hemisphere ===
{{Location map many | United Kingdom
| width = 180
| float = right
| caption = Lockerbie in Scotland
| label = Lockerbie
| position = right
| lat_deg = 55 | lat_min=07 | lat_sec=16 | lat_dir=N
| lon_deg = 3 | lon_min=21 | lon_sec=19 | lon_dir=W
}}
<pre style="width: 38em;">
{{Location map many | United Kingdom
| width = 180
| float = right
| caption = Lockerbie in Scotland
| label = Lockerbie
| position = right
| lat_deg = 55 | lat_min=07 | lat_sec=16 | lat_dir=N
| lon_deg = 3 | lon_min=21 | lon_sec=19 | lon_dir=W
}}
</pre>
{{clear}}

=== Country that crosses 180° meridian ===
{{Location map many | Russia
| width = 400
| float = right
| label = Uelen
| position = left
| background = #FFFFDD
| lat_deg = 66  | lat_min = 09 | lat_dir = N
| lon_deg = 169 | lon_min = 48 | lon_dir = W
}}
<pre style="width: 28em;">
{{Location map many | Russia
| width = 400
| float = right
| label = Uelen
| position = left
| background = #FFFFDD
| lat_deg = 66  | lat_min = 09 | lat_dir = N
| lon_deg = 169 | lon_min = 48 | lon_dir = W
}}
</pre>
{{clear}}

==Implementation notes==
The map with markers/labels is implemented as nested HTML divisions. The map-image is in an HTML division, containing each point as a percent-locator division containing a marker-image sub-division plus a label sub-division.  Each point is calculated (for a percent-locator division) with X or Y coordinate "XX.X%" or "YY.Y%" as follows:

* The div-tag is "&lt;div style="position: absolute; z-index: 2; top: XX.X%; left: YY.Y%; ...&gt;"
* For placing latitude, the calculation is:
:* XX.X% = 100 * (top - (lat_deg + latmin/60 +latsec/3600) ) / (top - bottom)
:* If lat_deg is empty, the combined decimal latitude is used from "lat".
:* If lat_dir is "S" (south), the latitude is multiplied by -1.
:* (Note latitude is positioned in reverse, from top of map downward.)
* For placing longitude, the calculation is:
:* YY.Y% = 100 * ( (lon_deg + lonmin/60 +lonsec/3600) - left ) / (right - left)
:* If lon_deg is empty, the combined decimal longitude is used as "long".
:* If lon_dir is "W" (west), the longitude is multiplied by -1.
* The div-tag is ended as "height: 0; width: 0; margin: 0; padding: 0;"&gt;".
* Within that division the marker/label sub-divisions are coded as:
:* &lt;div style="position: relative text-align: center; ..."&gt;.
* For label position, the options are shifted as:
:* when position=left, adds "left: -6.5em; text-align: right;"
:* when position=right, adds "left: 0.5em; text-align: left;"
:* when position=top, adds "top:-2.65em; left:-3em; text-align: center;"
:* when position=bottom, adds "top:-0.15em; left: -3em; text-align: center;" to div-tag.

==See also==
* [[Template:Location map]] - placing one marker/label by latitude/longitude.
* [[Template:Location map+]] - placing unlimited list of markers/labels.
* [[:Commons:Category:Map pointers]] - list of the many Wikimedia Commons pointer symbols.
<includeonly>
[[Category:Graphic templates]]
[[Category:Location map templates| ]]

[[bn:টেমপ্লেট:Location map many]]
[[ca:Plantilla:Location map many]]
[[cy:Nodyn:Location map many]]
[[diq:Şablon:Location map many]]
[[en:Template:Location map many]]
[[eo:Ŝablono:Situo sur mapo/multaj]]
[[ko:틀:위치 지도 여럿]]
[[hi:साँचा:Location map many]]
[[ja:Template:Location map many]]
[[mk:Шаблон:ПозКарта повеќе]]
[[ms:Templat:Location map many]]
[[ne:ढाँचा:Location map many]]
[[pt:Predefinição:Mapa de localização muitos]]
[[te:మూస:Location map many]]
[[vi:Bản mẫu:Location map many]]
[[yo:Àdàkọ:Location map many]]
[[es:Plantilla:Mapa de localización múltiple]]
[[fa:الگو:Location map many]]
[[fi:Malline:Location map Monta]]
</includeonly><noinclude>
[[Category:Exclude in print]]
</noinclude>