Jump to content

Կաղապար:Location map many/doc

Վիքիպեդիայից՝ ազատ հանրագիտարանից

Կաղապար:Location map many creates a location map as a composite image of an existing map, with multiple markers and optional labels superimposed onto it. This template functions in the style of Կաղապար:Location_map, but allows multiple markers and labels (rather than just one marker).

For an unlimited list of markers/labels, see: Կաղապար:Location map+, which specifies points as a coded template list of markers/labels.

Օգտագործման ձևը

[խմբագրել կոդը]

The first unnamed parameter (shown as {{{1}}} below) specifies a map definition. If {{{1}}} is Spain, the map image and coordinates are based on the values defined for Spain in Մոդուլ:Location map/data/Spain if it exists, or in Կաղապար:Location map Spain otherwise.

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

Պարամետրեր

[խմբագրել կոդը]
Map display parameters
Պարամետրեր Description
{{{1}}} Required. Use the name of the map as the first unnamed parameter. For example, specifying England will use the values for England in Մոդուլ:Location map/data/England if it exists, or {{Location map England}} otherwise. See the examples below.
width Determines the width of the map in pixels. The default is 240. Do not include px, for example: width=300, not width=300px.
float Specifies the position of the map on the page. Valid values are left, right, center and none. The default is right.
border Specifies the color of the 1px map border. The default is lightgrey (see web colors). If set to none, no border will be generated. This parameter is seldom used.
caption 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 caption is defined but is not assigned a value, the map will not be framed and no caption will be displayed. If caption is not defined, the map will not be framed and a default caption will be generated. The default caption is created from the label parameter (or the current page name if label not defined) and the name parameter from map definition template. See the examples below.
alt Alt text for map; used by screen readers, see WP:ALT.
relief Any non-blank value (1, yes, etc.) will cause the template to display the map specified in the map definition template as image1, which is usually a relief map. See the example at Location map+/relief.
AlternativeMap Allows the use of an alternative map. The image must have the same edge coordinates as the location map template. See the example at Location map+/AlternativeMap.
overlay_image Allows an overlay to be superimposed on the map. This parameter is seldom used. See the example at Location map+/overlay.
Label and mark parameters
Պարամետրեր Description
label1
...
label9
The text of the label to display next to the mark. A wiki link can be used. The default if not specified is no label, just the marker.
label1_size
...
label9_size
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 %, for example: label_size=80, not label_size=80%.
position1
...
position9
The position of the label relative to the mark. Valid values are left, right, top and bottom. The default is right.
background1
...
background9
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.
mark1
...
mark9
The name of an image to display as the mark. The default is Red pog.svg (). See examples at Commons:Location markers and Commons:Category:Map icons.
mark1size
...
mark9size
The size of the mark in pixels. The default is 8. Do not include px, for example: marksize=10, not marksize=10px.
link1
...
link9
Specifies a 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.
lat1_deg
...
lat9_deg
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.
lat1_min
...
lat9_min
The minutes of latitude.
lat1_sec
...
lat9_sec
The seconds of latitude. Usually not necessary.
lat1_dir
...
lat9_dir
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).
lon1_deg
...
lon9_deg
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.
lon1_min
...
lon9_min
The minutes of longitude.
lon1_sec
...
lon9_sec
The seconds of longitude. Usually not necessary.
lon1_dir
...
lon9_dir
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.

When a marker's mark#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 Diamond_sheer_red_20.gif (marksize=20) to show a red diamond on the image: or use: Cercle_rouge_100%.svg to show a red circle or a larger black diamond: Diamond_sheer_black_37.gif as sized with a larger marksize=37 or similar number to resize the diamond somewhat:

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 multiple 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. 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.

Location maps can be found using these sources:

Սպասարկող:PrefixIndex/Module:Location map/data/ - Checked before a map template is searched for. New maps should be created here rather than creating new templates.
List of templates - 1050 templates available when the list was generated.
Category:Location map templates - templates sorted by category.
Սպասարկող:WhatLinksHere/Template:Location map/Info - a search that might help.
Սպասարկող:Prefixindex/Template:Location_map_ - another search that might help.

Creating new map definitions

[խմբագրել կոդը]

See Creating a new map definition.

Օրինակներ

[խմբագրել կոդը]

Map with label "Pag" and "Anytown" (degrees)

[խմբագրել կոդը]
Location map many/docը գտնվում է Խորվաթիաում
Pag
Pag
Anytown_Anywhere
Anytown_Anywhere
Location map many/doc (Խորվաթիա)
{{Location map many | Խորվաթիա
| 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
}}

Map with 3 labels (decimal)

[խմբագրել կոդը]
Location map many/docը գտնվում է Խորվաթիաում
Pag
Pag
Anytown
Anytown
Anytown2
Anytown2
Location map many/doc (Խորվաթիա)
{{Location map many | Խորվաթիա
| 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
}}

Example map with red triangle

[խմբագրել կոդը]
Location map many/docը գտնվում է 100x100ում
Իսպանիոլա
Իսպանիոլա
Location map many/doc
Կուբա
Կուբա
Site of Hispaniola
{{Location map many | 100x100
| AlternativeMap = LocationJamaica.svg
| float = right
| width = 250
| caption = Site of '''Hispaniola'''
| label = Իսպանիոլա
  | 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 = Կուբա
  | pos3 = left
  | mark3size = 1
  | lat3_deg = 59.2
  | lon3_deg = 68.0
}}

Map with some labels outside map

[խմբագրել կոդը]
Location map many/docը գտնվում է Խորվաթիաում
Pag
Pag
Anytown
Anytown
Anytown2
Anytown2
Հյուսիսային Խորվաթիա
Location map many/doc (Խորվաթիա)
{{Location map many | Խորվաթիա
| width = 260
| float = right
| label = Pag | position=right
  | marksize = 8
  | lat_deg = 44.44
  | lon_deg = 15.05
| label2 = Anytown
  | pos2 = bottom
  | bg2 = yellow
  | lat2_deg = 47.40
  | lon2_deg = 12.80
  | outside2 = 1 <!-- we know this point is outside the map, so don't warn about it -->
| label3 = Anytown2
  | pos3 = top
  | bg3 = lightgreen
  | lat3_deg = 41.98
  | lon3_deg = 18.43
  | outside3 = 1 <!-- we know this point is outside the map, so don't warn about it -->
| label4 = Հյուսիսային Խորվաթիա 
  | pos4 = left
  | bg4 = lightgreen
  | mark4size = 0
  | lat4_deg = 46.22
  | lon4_deg = 17.7
}}

Map with 9 markers (decimal)

[խմբագրել կոդը]
Location map many/docը գտնվում է Խորվաթիաում
Pag
Pag
Anytown
Anytown
Anytown2
Anytown2
44.0 (latitude)
44.0 (latitude)
44.5
44.5
45.0
45.0
45.5
45.5
46.0
46.0
ԽՈՐՎԱԹԻԱ
ԽՈՐՎԱԹԻԱ
Location map many/doc (Խորվաթիա)
{{Location map many | Խորվաթիա
| 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 = ''ԽՈՐՎԱԹԻԱ''
  | label9_size = 165
  | mark9size = <!--label only-->1
  | lat9_deg = 42.60
  | lon9_deg = 14.4
}}

Map with a custom label and text background

[խմբագրել կոդը]
Location map many/docը գտնվում է Խորվաթիաում
Imotski
Imotski
Imotski in Խորվաթիա
{{Location map many | Խորվաթիա
| width = 280
| float = right
| caption = Imotski in Խորվաթիա
| label = Imotski
| position = right
| background = #FFFFDD
| lat_deg = 43.44
| lon_deg = 17.21
}}

Map with enlarged marker and label

[խմբագրել կոդը]
Location map many/docը գտնվում է Խորվաթիաում
Pag
Pag
Pag Island in Խորվաթիա
{{Location map many | Խորվաթիա
| width = 260
| float = right
| caption = Pag Island in Խորվաթիա
| label = Pag
| label_size = 200
| position = right
| marksize = 14
| background = #FFFFDD
| lat_deg = 44.44
| lon_deg = 15.05
}}

Map with no caption

[խմբագրել կոդը]
Location map many/docը գտնվում է Բոսնիա և Հերցեգովինաում
Brčko
Brčko
{{Location map many | Բոսնիա_և_Հերցեգովինա
| width = 150
| float = right
| caption =
| label = Brčko
| position = left
| lat_deg = 44.87
| lon_deg = 18.81
}}

Western Hemisphere

[խմբագրել կոդը]
Location map many/docը գտնվում է Միացյալ Թագավորությունում
Lockerbie
Lockerbie
Lockerbie in Scotland
{{Location map many | Մեծ Բրիտանիա
| 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
}}

Country that crosses 180° meridian

[խմբագրել կոդը]
Location map many/docը գտնվում է Ռուսաստանում
Uelen
Uelen
Location map many/doc (Ռուսաստան)
{{Location map many | Ռուսաստան
| 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
}}

Marker examples

[խմբագրել կոդը]
Location map many/docը գտնվում է Ուկրաինաում
Pfeil oben.svg
Pfeil oben.svg
Pfeil unten.svg
Pfeil unten.svg
Pfeil rechts.svg
Pfeil rechts.svg
Pfeil links.svg
Pfeil links.svg
Pfeil rechts oben.svg
Pfeil rechts oben.svg
Pfeil rechts unten.svg
Pfeil rechts unten.svg
Pfeil links oben.svg
Pfeil links oben.svg
Pfeil links unten.svg
Pfeil links unten.svg
Point carte.svg
Point carte.svg
Square city locator.png
Square city locator.png
Solid red square.svg
Solid red square.svg
Solid blue.svg
Solid blue.svg
Fadenkreuz.svg
Fadenkreuz.svg
Crosshairs Red.svg
Crosshairs Red.svg
Purple pog.svg
Purple pog.svg
Yellow pog.svg
Yellow pog.svg
Map-Pin.png
Map-Pin.png
Dot-yellow.svg
Dot-yellow.svg
Blue-circle.gif
Blue-circle.gif
Flashspot.gif
Flashspot.gif
Location dot blue.svg
Location dot blue.svg
Location dot black.svg
Location dot black.svg
Arrows 12x12 nw.svg
Arrows 12x12 nw.svg
Arrows 12x12 ne.svg
Arrows 12x12 ne.svg
Fire.svg
Fire.svg
Black triangle2.svg
Black triangle2.svg
Blue Fire.svg
Blue Fire.svg
City locator Montagne.svg
City locator Montagne.svg
Cercle rouge 100%.svg
Cercle rouge 100%.svg
White flag icon.svg
White flag icon.svg
Legenda miejsce bitwy.svg
Legenda miejsce bitwy.svg
X solid black 17.gif
X solid black 17.gif
Some symbols that show up well
Location map many/docը գտնվում է Ուկրաինաում
City locator 0.svg
City locator 0.svg
City locator 1.svg
City locator 1.svg
City locator 2.svg
City locator 2.svg
City locator 6.svg
City locator 6.svg
City locator 7.svg
City locator 7.svg
City locator 8.svg
City locator 8.svg
City locator 9.svg
City locator 9.svg
City locator 10.svg
City locator 10.svg
City locator 11.svg
City locator 11.svg
City locator 13.svg
City locator 13.svg
City locator 21.svg
City locator 21.svg
City locator 29.svg
City locator 29.svg
Point rouge croix frontier vert green.svg
Point rouge croix frontier vert green.svg
Wikipedia-Marker-4.png
Wikipedia-Marker-4.png
StarArrowOR.svg
StarArrowOR.svg
Castle.svg
Castle.svg
Crime symbol handgun czeska80px.gif
Crime symbol handgun czeska80px.gif
Gwiazda LnM.svg
Gwiazda LnM.svg
Nuclear plant.svg
Nuclear plant.svg
Quake pointer.svg
Quake pointer.svg
Rotonda S7.svg
Rotonda S7.svg
Wikipedia-Marker-isle.svg
Wikipedia-Marker-isle.svg
BSicon dB+Slg.svg
BSicon dB+Slg.svg
BSicon ANCHOR.svg
BSicon ANCHOR.svg
BSicon fAKRZu2.svg
BSicon fAKRZu2.svg
Location map many/doc
BSicon xtZOLL.svg
BSicon xtZOLL.svg
Unesco Cultural Heritage logo.svg
Unesco Cultural Heritage logo.svg
Mining symbol.svg
Mining symbol.svg
Zoo icon.jpg
Zoo icon.jpg
Vattenfall blue.svg
Vattenfall blue.svg
SymbolAirport.svg
SymbolAirport.svg
Random map icons. The "marksize=" option is needed to make some of them show up.
See Wikimedia pointer symbols: commons:Category:Map pointers.

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 "<div style="position: absolute; z-index: 2; top: XX.X%; left: YY.Y%; ...>"
  • 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;">".
  • Within that division the marker/label sub-divisions are coded as:
  • <div style="position: relative text-align: center; ...">.
  • 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.