ढाँचा:OSM Location map/doc को स्रोत हेर

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{OSM Location map
| coord = {{Coord|52.6909|-1.2163}}
| zoom = 13
| width = 300        <!-- width and height of the frame. numeric input - do not add px -->
| height = 300
| caption = Old John Tower in [[Bradgate Park]], Leicestershire <!-- Text below the map -->

| minimap = file
| mini-file = Leicestershire UK location map.svg
| mini-width = 80
| mini-height = 60
| minipog-x = 37
| minipog-y = 27
| scalemark = 75

| mark-coord = {{Coord|52.69632|-1.22391}}    <!-- lat and lon location for the marker --> 
|  mark-size = 11
|      label = Old John Tower <!--label text. Default position is left of the marker-->
| label-size = 13
|label-color = #666655
|  label-pos = right
| mark-title = Old John
| mark-image = Old John (Leicestershire).jpg    <!-- | used within the full screen linked page -->
| mark-description = Hill top tower of Old John, in [[Bradgate Park]]

|      label1 = War memorial
|  label-pos1 = left
| label-size1 = 9
|label-color1 = #666655
| mark-coord1 = {{Coord|52.694944|-1.2254584}} <!-- lat and lon for the marker -->
|  mark-size1 = 7
| mark-title1 = War memorial at Bradgate
| mark-image1 = Leicestershire Yeomanry Memorial, Bradgate Park - geograph.org.uk - 885190.jpg
| mark-description1 = Leicestershire Yeomanry Memorial, [[Bradgate Park]]

|      label2 = BRADGATE PARK
|  label-pos2 = top
| mark-coord2 = {{Coord|52.6909|-1.2163}}    <!-- lat and lon location for the marker -->
|  mark-size2 = 0
| mark-title2 = Bradgate Park
| mark-image2 = Bradgate Park - geograph.org.uk - 885175.jpg
| mark-description2 = With its origins as a medieval deep park, [[Bradgate Park]] is now a popular visitor destination.

|      label3 = Bradgate 
|     labela3 = House
|  label-pos3 = bottom
| mark-coord3 = {{Coord|52.686698|-1.2111676}} <!-- lat and lon location for the marker -->
|  mark-size3 = 7
| mark-title3 = Bradgate House ruins
| mark-image3 = Bradgate House - geograph.org.uk - 883366.jpg
| mark-description3 = Ruins of the 16th century [[Bradgate House (16th century)|Bradgate House]], home of the Grey family

|      label4 = Cropston
|     labela4 = Reservoir
|label-color4 = #77A1CB
|label-angle4 = -38
|  label-pos4 = bottom
| mark-coord4 = {{Coord|52.695|-1.195}} <!-- lat and lon location for the marker -->
|  mark-size4 = 0
| mark-title4 = [[Cropston reservoir]]
| mark-image4 = Boathouse and Cropston Reservoir - geograph.org.uk - 48496.jpg
| mark-description4 = It was opened in May 1871 in a corner of Bradgate Park, to supply water for the growing town of Leicester.

|      label5 = Old John Car Park
|     labela5 = (Hunt's Hill)
|  label-pos5 = right
|       mark5 = BSicon PARKING.svg
| mark-coord5 = {{Coord|52.70037|-1.22784}} <!-- lat and lon location for the marker -->
|  mark-size5 = 11
| mark-title5 = Old John Car Park

|      label6 = Hallgates 
|  label-pos6 = bottom
|       mark6 = BSicon PARKING.svg
| mark-coord6 = {{Coord|52.69727|-1.1991620}} <!-- lat and lon location for the marker -->
|  mark-size6 = 11
| mark-title6 = Hallgates Car Park

|      label7 = 
|  label-pos7 = bottom
|       mark7 = BSicon PARKING.svg
| mark-coord7 = {{Coord|52.68356|-1.2277007}} <!-- lat and lon location for the marker -->
|  mark-size7 = 11
| mark-title7 = Newtown Linford Car Park
}}
This template provides a map in a frame, for any location and scale. At its simplest it can simply show the Open Street Map image and a scale indicator for a given area of land. Optionally a range of marker, label and annotation tools are available to include location markers, labels, numbered dots, a heading, caption, mini-locator map and overlays. The map also provides a link to a full-screen interactive 'maplink' version.

==Purpose== 
'''OSM Location map''' allows an editor to include a map in a frame for anywhere in the world, at any scale from the whole world down two one or two streets. It makes use of the Open Street Map mapping data, and enables a place-based page or topic to simply show the area being described, without the need for pre-determined map templates. The underlying map will be updated and improved automatically as the OSM data develops.

The template can also show multiple marks, images and labels (currently limited to ten). The template makes use of {{tl|Graph:Street map with marks}}, which allows unlimited numbers of marks and labels, utilises a different coding mark-up, and is particularly suited to using data directly from a [[Wikidata]] source.

The resulting framed map also has a link to a full-screen version, which opens at the same location, above the current page. This has a richer map interface, can be re-scaled and panned by the user, has optional thumbnail images and captions for the marker points, and can also access a wide range of maps, satellite images etc. (The fullscreen option uses the <nowiki><maplink></nowiki> mapping provision.)

A rough guide to the scale of the map is provided in the bottom left corner. This is only a guide, as the projection means the scale changes depending on the latitude. Some allowance has been made for this, but only in large 20 degree chunks.

{{OSM Location map
| coord = {{coord|53.41459|-4.3341279}}
|  zoom = 15
}}

== Usage ==
;Minimal version: an unadorned map centred on a latitude and longitiude coordinates, via a {{tl|coord}} value. Set the zoom to give a scale that fits the subject (0=whole world, 18=a street). With just these options set, all other parameters use the defaults, or are left unused. It gives a link to the full screen version.
{| 
|-
| <source lang="html">{{OSM Location map               <!--These parameters are the only essential items-->
| coord = {{coord|53.41459|-4.3341279}} <!--latitude and longitude - eg as a +/- decimal. -->
|  zoom = 15                              <!--(1=whole world, 18=a street)-->
}}</source>
|}
{{clear}}

;Single marker: Using mostly default settings, with a Red pog marker and label, and some additional info for use on the full screen version.
{{OSM Location map
| coord = {{coord|53.394|-4.450}}
| zoom = 13
| width = 300
| height = 150
| caption = The 'Llanfechell Triangle' standing stones are north-west of [[Llanfechell]].
| mark-coord = {{coord|53.3966|-4.46204}}
|      label = Llanfechell Triangle
|  label-pos = right
| mark-title = Llanfechell Triangle
| mark-image = The Llanfechell Triangle - geograph.org.uk - 1260817.jpg
| mark-description=Group of three prehistoric standing stones thought to date to the Bronze Age, at [[Llanfechell]], [[Anglesey]]
}}
{| 
|-
|<source lang="html">{{OSM Location map
| coord = {{coord|   |   }} <!-- {{coord}} has various formats for latitude and longitude -->
|  zoom =            <!-- (1=whole world, 18=a street)--> 
| width =            <!-- width and height of the frame. numeric input - do not add px -->
| height = 
| caption =          <!-- Text below the map. Can include [[wikilinks]] -->
| mark-coord =       <!-- use {{coord|  |  }} to set lat and lon location for the marker -->
|      label =       <!-- text alongside the mark -->
|  label-pos =       <!--default position is to the left. (or right, top, bottom)-->
| mark-title =       <!-- | -->
| mark-image =       <!-- | these are only used within the full screen linked page -->
| mark-description = <!-- | -->
}}</source>
|}
{{OSM Location map
| coord = {{coord|53.395|-4.452}}
|  zoom = 14
| float = right
| width = 300
| height = 250
| caption = Scheduled monuments around [[Llanfechell]], [[Anglesey]]
|   title =
|    minimap = file
|  mini-file = Wales relief location map.jpg
| mini-width = 70
|mini-height = 90
|  minipog-x = 25
|  minipog-y = 4
|  scalemark = 66 <!-- shifts the scalemark further to the left -->

|      shape1 = image
|       mark1 = Red pog.svg
|      label1 = Baron Hill Maen Hir
| mark-coord1 = {{coord|53.3964|-4.4531}}
|  label-pos1 = right
| label-size1 = 11
|label-color1 =
| label-offset-x1=
| label-offset-y1=
|mark-title=Baron Hill Maen Hir
|mark-image=Standing stone east of Llanfechell - geograph.org.uk - 1254434.jpg
|mark-description=Baron Hill Maen Hir, is a prehistoric standing stone north of [[Llanfechell]].

| mark-coord2={{coord|53.3966|-4.46204}}
|      label2 = Llanfechell Triangle
|  label-pos2=top
| label-offset-x2=35
| label-offset-y2=
|mark-title2=Llanfechell Triangle
|mark-image2=The Llanfechell Triangle - geograph.org.uk - 1260817.jpg
|mark-description2=Group of three prehistoric standing stones thought to date to the Bronze Age, at [[Llanfechell]], [[Anglesey]]
}}
{{OSM Location map
| coord ={{coord|52.0|-4.810}}
| zoom =11
| width = 300   <!-- width and height of the frame. numeric input - do not add px -->
| height = 300
| caption = Pentre Ifan and other nearby Neolithic sites
| scalemark = 47

| mark-coord = {{coord|51.9990|-4.7700}} <!-- lat and lon location for the marker -->
|       mark = Archaeological site icon (red).svg
|  mark-size = 14
|      label = Pentre Ifan <!--this is the label text. Its default position is to the left of the marker-->
| label-size = 15
|label-color = black
|  label-pos = left
| mark-title = Pentre Ifan, [[List of Scheduled prehistoric Monuments in north Pembrokeshire|Pembrokeshire]]
| mark-image = DMPentreIfanFront.JPG      <!-- | used within the full screen linked page -->
| mark-description = The largest and best preserved [[Neolithic British Isles|neolithic]] [[dolmen]] in [[Wales]]

| mark-coord1 = {{coord|52.0545|-4.7717}}
|       mark1 = Archaeological site icon (red).svg
|  mark-size1 = 9
|      label1 = Llech-y-Tribedd dolmen
| label-size1 = 10
|label-color1 = #776666
| mark-title1 = Llech-y-Tribedd, [[List of Scheduled prehistoric Monuments in north Pembrokeshire|Pembrokeshire]] 
| mark-image1 = Llech-y-tribedd and Carn Ingli - geograph.org.uk - 1426923.jpg
| mark-description1 = Llech-y-Tribedd is a well preserved dolmen with three tapering uprights and a massive capstone.

| mark-coord2={{coord|52.0186|-4.8282}}
|      label2 = Carreg Coetan 
|     labela2 = Arthur dolmen
|  label-pos2 = top
| label-offset-x2 = -6
| mark-title2 = Carreg Coetan Arthur, [[List of Scheduled prehistoric Monuments in north Pembrokeshire|Pembrokeshire]] 
| mark-image2 = Carreg Coetan burial chamber. - geograph.org.uk - 1044642.jpg
| mark-description2 = [[Carreg Coetan Arthur]] is a dolmen in a small hedged enclosure on the outskirts of Newport

| mark-coord3={{coord|51.9409|-4.823}}
|      label3 = Banc Du 
|     labela3 = Neolithic enclosure
|  label-pos3 = top
| mark-title3 = Banc Du Neolithic enclosure, [[List of Scheduled prehistoric Monuments in north Pembrokeshire|Pembrokeshire]] 
| mark-image3 = Sheep on Banc Du - geograph.org.uk - 1754023.jpg
| mark-description3 = [[Banc Du]] is a promentary hill with the first confirmed neolithic enclosure in Wales

| mark-coord4={{coord|51.9775|-4.7563}}
|      label4 = Bedd yr Afanc 
|     labela4 = Burial Chamber
|  label-pos4 = top
| mark-title4 = Bedd yr Afanc Burial Chamber, [[List of Scheduled prehistoric Monuments in north Pembrokeshire|Pembrokeshire]] 
| mark-image4 = Bedd yr afanc, looking east-southeast - geograph.org.uk - 404497.jpg
| mark-description4 = Bedd yr Afanc is a stone burial chamber below the summit of Mynydd Preseli

| mark-coord5={{coord|51.9685|-4.7945}}
|      label5 = Standing Stones
|  label-pos5=right
| mark-title5 = Standing Stones, [[List of Scheduled prehistoric Monuments in north Pembrokeshire|Pembrokeshire]] 
| mark-image5 = 
| mark-description5 = Tafarn-y-Bwlch and Waun Mawn Standing Stones

| mark-coord6={{coord|52.0478|-4.7982}}
|      label6 = Trellyffaint dolmen
|  label-pos6=right
| mark-title6 = Trellyffaint burial chamber, [[List of Scheduled prehistoric Monuments in north Pembrokeshire|Pembrokeshire]] 
| mark-image6 = Trellyffant burial chamber, looking northeast - geograph.org.uk - 1410564.jpg
| mark-description6 = Trellyffaint dolmen, looking northeast. The capstone has collapsed at some point.

| mark-coord7={{coord|52.0137|-4.8627}}
|      label7 = Cerig-y-Gof 
|     labela7 = chambered tomb
|  label-pos7=bottom
| label-offset-x7=10
| mark-title7 = Cerig-y-Gof chambered tomb, [[List of Scheduled prehistoric Monuments in north Pembrokeshire|Pembrokeshire]] 
| mark-image7 = Cerrig y Gof chambered tomb - geograph.org.uk - 202375.jpg
| mark-description7 = A group of five stone-lined chambers, thought to have been originally covered by a single mound.

| mark-coord8={{coord|51.9597|-4.7223}}
|      label8 = Bedd Arthur stone circle
| mark-title8 = Bedd Arthur, [[List of Scheduled prehistoric Monuments in north Pembrokeshire|Pembrokeshire]] 
| mark-image8 = Beddarthur standing stone circle, Preseli Mountains - geograph.org.uk - 258436.jpg
| mark-description8 = [[Bedd Arthur]] is an oval banked enclosure set with stones.

| mark-coord9={{coord|51.973|-4.77}}
|      label9 = P R E S E L I   H I L L S
|  mark-size9 = 0 
|label-angle9 = 25
|label-color9 = #81AF81
| mark-title9 = [[Preseli Hills]]  <!-- use mark-title9 = none if you wanted to suppress the full-screen marker -->
}}

==Multiple markers, labels and/or images==
In addition to the un-numbered mark parameters there are 20 numbered ones. These are otherwise identical to the one above, but each mark and label has its own set of parameters (mark1, mark-coord1, label1, label-pos1 etc...mark2, mark-coord2, label2, label-pos2 etc.) Mark1 acts as a 'master marker' for many parameters. Values given to the mark1 set are inherited by the other numbered sets, which avoids some repetition.

==Minimap==
There is a built-in map of the world option, which will act as a mini locator map and automatically adds a red locator dot. Unfortunately it is too general for most purposes, so making use of an existing 'Location map' file is possible. This is not very automated. The width and height of the map both have to be specified (and it is up to you to not distort the map dimensions). An optional locator dot can be placed by specifying the minipog-x and -y values, using the same scale values as mini-width and -height. With an origin in the top left of the minimap, the minipog can be placed over the relevant point on the minimap.
{| 
|-
<source lang="html">
| minimap = file <!--this minimap is used in the example to the right-->
| mini-file = Wales relief location map.jpg
| mini-width = 70
| mini-height = 90
| minipog-x = 25
| minipog-y = 4
| scalemark = 66 <!-- shifts the scalemark further to the left -->
</source>
|}
If the area of the actual map is a large portion of the mini-map, an open red box can be included instead of a dot, to show the bounds of the main map. To use this feature, simply specify the width of the required box: <code>minimap-boxwidth=xx</code> where xx = the pixel width of the box. In general anything much below xx=15 will be better served by a dot. The required width will require some trial and error to pin down. The box height is then matched in proportion to the actual map.

==Alternative marks==
Instead of using the standard 'Red pog' for mark points on the map, other images can be used. Any image from Wikimedia Commons can be specified. The example on the right uses 'Archaeological site icon (red).svg'. If a particular file is specified in <code>mark1=</code>, all subsequent marks will use it unless they name their own image file. If the image is not square, a dimension value also needs to be set (width ratio for a height of 1)
{{OSM Location map
| lat =52.6328
| lon =-1.138
| zoom =14
| width = 300       <!-- width and height of the frame. numeric input - do not add px -->
| height = 300
| caption = Leicester Castle and the line of the medieval town walls
| minimap = file
| mini-file=Leicestershire UK district map (blank).svg
| mini-width=100
| mini-height=75
| minipog-x=52
| minipog-y=39
| scalemark =106     <!-- shifts the scalemark further to the left -->

| mark = Leicester Town Walls map overlay.svg
| mark-lat = 52.6328    <!-- lat and lon location for the overlay -->
| mark-lon = -1.1380
| mark-size = 300       <!--height of the overlay, matches the frame-->
| mark-dim = 0.8        <!--dimension to set width needed as not square-->
| mark-title=none       <!--no marker within the full screen version-->

| mark-lat1 = 52.632333 <!-- lat and lon location for the marker -->
| mark-lon1 =-1.141194
| mark1=Red pog.svg
| mark-size1=11
| label1 = Leicester Castle
| label-pos1=left
| mark-title1 = Leicester Castle
| mark-image1 = The Great Hall Leicester Castle.jpg  <!-- for use within the full screen linked page -->
| mark-description1 = The Great Hall, now with a Queen Anne frontage, is the main standing remains of Leicester's medieval castle.
}}

==Text effects==
Where label text is too long to fit on a single line, two further label line can be used: <code>labela = </code> and <code>labelb = </code>. 

It is possible to specify a <code>label-angle = </code>, which will pivot the label text around the centre of the marker point by the specified angle. If mark-size is set to zero, this has the effect of a free-floating label with no marker, useful for various geographic and linear features. (This is illustrated by the 'Preseli Hills' text on the Pentre Ifan map). For stylistic consistency all settlement and building names should not be given an angle.

==Transparent overlay==
The specified image file can be any size. Using an .svg image with a transparent background, and annotations that match the scale and location of the base map, it is possible to provide a customised overlay image to show particular features that are not included on the base map. The line of the town walls on the map of Leicester are arrived at by that means.

==Numbered dots==
{{OSM Location map
| coord={{coord|52.620|-1.112}}
| float=left| zoom =15
| width = 200  | height = 300
| mark-coord1 = {{coord|52.6180|-1.11189}}
| mark-title1 = St John The Baptist Church
| shape1=n-circle
| shape-color1=blue
| shape-outline1=white
| mark-size1=16
| mark-coord2 = {{coord|52.61819|-1.11035}}
| mark-title2 = Congregational Church
| mark-coord3 = {{coord|52.62324|-1.11179}}
| mark-title3 = Eastfield, Stanley Road
| mark-coord4 = {{coord|52.62123|-1.111297}}
| mark-title4 = Stoneygate School
| mark-coord5 = {{coord|52.62009|-1.11241}}
| mark-title5 = The Firs
| mark-coord6 = {{coord|52.61936|-1.11510}}
| mark-title6 = White House
| caption = Listed buildings in Stoneygate
| auto-caption=1
}}
If numbered dots are needed, instead of (or as well as) text labels, this can be achieved using the built in shapes. For example, <code>shape1=n-circle</code> will place a numbered dot at that coord position (or l-circle for letters). Generally it is much better to use the dots in sequence, so each numbered mark gives a numbered dot, and they will match the full screen ones. If <code>auto-caption=1</code> then the caption will generate a numbered list using the <code>mark-title</code> entries.  For example:-

<source lang="text">
{{OSM Location map
| coord={{coord|52.620|-1.112}}
| float=left| zoom =15
| width = 200  | height = 300
| mark-coord1 = {{coord|52.6180|-1.11189}}
| mark-title1 = St John The Baptist Church
| shape1=n-circle
| shape-color1=blue
| shape-outline1=white
| mark-size1=16
| mark-coord2 = {{coord|52.61819|-1.11035}}
| mark-title2 = Congregational Church
| mark-coord3 = {{coord|52.62324|-1.11179}}
| mark-title3 = Eastfield, Stanley Road
| mark-coord4 = {{coord|52.62123|-1.111297}}
| mark-title4 = Stoneygate School
| mark-coord5 = {{coord|52.62009|-1.11241}}
| mark-title5 = The Firs
| mark-coord6 = {{coord|52.61936|-1.11510}}
| mark-title6 = White House
| caption = Listed buildings in Stoneygate
| auto-caption=1
}}
</source>
The other built-in shapes can be used in the same way (n-square, n-diamond etc.). The <code>shape-outline1=</code> value sets the colour for the number (unlike normal, when it sets the shape-outline), and as with the others, only the mark1 values need to be set for many values, to establish the default for this map, which can be overridden as required. The <code>numbered1..2..3 etc</code> parameters can override the automatic numbers or letters to use your own values for each mark. {{tl|Flushing Meadows-Corona Park map}} is a useful real life example in template form.

==Full list of parameters==

{{OSM Location map
| coord={{coord|51.46534|-0.44542}}
| zoom=12
| float = right
| width = 300
| height = 400
| fullscreen-option=
| caption = [[File:Heathrow Airport 014.jpg|290px]]<br>With five terminals, [[Heathrow Airport]], is the busiest airport in Europe.
| title=London's Heathrow Airport
| minimap = file
| mini-file = Greater London UK location map 2.svg
| mini-width = 150
| mini-height = 120
| minipog-x = 19
| minipog-y = 63
| minimap-boxwidth = 20
| scalemark = 160 

|       shape = image
| shape-color = red
|shape-outline=
|        mark = Airplane silhouette.svg
|   mark-size = 20
|  mark-coord = {{coord|51.471867|-0.456726}}
|       label = Terminals 1 & 3
|      labela = 
|      labelb =
|  label-size = 13
| label-color = #191970
| label-angle =
| label-pos   = top
| label-offset-x=
| label-offset-y= 
| mark-title=Heathrow Airport Terminal 1
| mark-image=Heathrow Terminal 1 - geograph.org.uk - 581459.jpg
| mark-description=Terminal 1 at [[Heathrow Airport]], the busiest airport in Europe.

| mark-coord1={{coord|51.470156|-0.448497}}
| shape1 = image
| shape-color1=red
| shape-outline1=
| mark1 = Airplane silhouette.svg
| mark-size1 = 20
| label-color1 = #191970
| label1=Terminal 2
| label-size1=13
| label-pos1=bottom
| mark-title1 = Heathrow Airport Terminals 1 & 3

| mark-coord2={{coord|51.471948|-0.487883}}
| label2 = Terminal 5
| label-pos2=bottom
| mark-title2=Heathrow Airport Terminal 5
| mark-image2=Heathrow Airport 014.jpg
| mark-description2=Terminal 5 at [[Heathrow Airport]], the busiest airport in Europe.

| mark-coord3={{coord|51.459409|-0.446459}}
| label3=Terminal 4
| mark-title3=Heathrow Airport Terminal 4
| label-pos3   = left

| mark-coord4={{coord|51.467269|-0.4233598}}
| mark4=Underground.svg
| mark-size4 = 14
| label4=Hatton Cross
| mark-title4=Hatton Cross station, on the Underground, Piccadilly Line.
| mark-image4=Hatton Cross Tube Station.JPG
| label-pos4 = right
| label-color4=#555544
| label-offset-y4=-6  
}}

{|
! Blank template
!
! Example
|- 
| style="width: 220px; vertical-align:top;" |
<source lang="html" style="overflow: auto; margin-right: 5px;">
{{OSM Location map
| coord = {{coord|  |  }}
| zoom=
| float = 
| width = 
| height = 
| fullscreen-option =
| caption = 
| title =

| minimap = 
| mini-file =
| mini-width =
| mini-height =
| minipog-x =
| minipog-y =
| minipog-boxwidth =
| scalemark =

|          shape = 
|    shape-color = 
|  shape-outline = 
|           mark = 
|      mark-size = 
|       mark-dim = 
|     mark-coord = {{coord|  |  }}
|          label = 
|         labela = 
|         labelb =
|     label-size = 
|    label-color = 
|    label-angle =
|      label-pos = 
| label-offset-x = 
| label-offset-y =  
|     mark-title = 
|     mark-image = 
| mark-description=

<!-- second and subsequent markers-->
| mark-coord1={{coord|  |  }}
| label1=

}}</source>
| width="20px" |
| style="vertical-align:top;" |
<source lang="html" style="overflow: auto; margin-right: 5px;">
{{OSM Location map
| coord={{coord|51.46534|-0.44542}}
| zoom=12
| float = right
| width = 300
| height = 400
| fullscreen-option=
| caption = [[File:Heathrow Airport 014.jpg|360px]]<br>With five terminals, [[Heathrow Airport]], is the busiest airport in Europe.
| title=London's Heathrow Airport
<!-------->
| minimap = file
| mini-file = Greater London UK location map 2.svg
| mini-width = 150
| mini-height = 120
| minipog-x = 19
| minipog-y = 63
| minimap-boxwidth = 20
| scalemark = 160 
<!-------->
| shape = image <!-- start of first label. More marks and labels are added with mark1, label1 etc. The first numbered set acts as a 'master marker', and its parameter values are inherited as defaults by any other numbered markers.-->
|   shape-color=
| shape-outline=
|          mark = Airplane silhouette.svg
|     mark-size = 20
|    mark-coord = {{coord|51.471948|-0.487883}}
|         label = Heathrow Terminal 5
|        labela = 
|        labelb =
|    label-size = 13
|   label-color = #191970
|   label-angle =
|     label-pos = top
|label-offset-x = 19
|label-offset-y = 
|    mark-title = Heathrow Airport Terminal 1
|    mark-image = Heathrow Terminal 1 - geograph.org.uk - 581459.jpg
| mark-description=Terminal 1 at [[Heathrow Airport]], the busiest airport in Europe.
<!-------->
<!-- Subsequent markers add a number 1 to 20 to the marker parameters, mark-coords are required for each marker. Most other values are inherited from the first of the numbered markers, mark1= etc, which acts as the 'master marker'-->
}}
</source>
|}

== Parameters ==
{| class="wikitable" style="width:100%;"
! colspan="2" style="background-color:lightblue" | Map display parameters
|-
! Parameter
! Description
|-
| style="width:170px;"|<code>coord</code>
| ''Latitude'' and ''longitude'' coordinates of the centre point of the map. Use <nowiki>coord={{Coord|</nowiki> ''latitude'' <nowiki>|</nowiki> ''longitude''}}. {{tl|Coord}} can deal with a wide range of formats. e.g.: <code><nowiki>coord={{Coord|57|18|22|N|4|27|32|W}}, coord={{Coord|44.112|N|87.913|W}}, coord={{Coord|44.112|-87.913}}.</nowiki></code> This may not be the 'coord' points of the page, as an appropriate framing area for the map may place the subject off-centre. (Marker point(s) are set separately, see below). [http://www.gridreferencefinder.com/ gridreferencefinder.com], is a helpful place to find coordinates, or you can right=click on the 'Full screen linked' map.
|-
| <code>zoom</code>
| Sets the '''scale''' of the map, from 0 to 19, to the levels defined by the Open Street Map foundation. (details [http://wiki.openstreetmap.org/wiki/Zoom_levels here]). The actual distances represented will vary depending on the latitude, as the scale defines different fractions of a degree. The apparent scale will also vary hugely depending on the monitor being used, the browser magnification level, etc. For most Wikipedia situations, maps with a zoom of 10 (notionally 1:500,000) up to 16 (1:8,000) are likely to be of most use.
|-
| <code>float</code>
| Positions the frame to the left, centre (or center) or right. (default is right). If centered, the text will be forced above and below, otherwise text will wrap to the side.
|-
| <code>width</code> <code>height</code>
| Sets the width and height of the map in pixels. Only the number is required (i.e. no px). Default is 350 by 250 pixels.
|-
| <code>fullscreen-option</code>
| By default a <nowiki>[Full screen]</nowiki> link is supplied in the bottom left of the frame. By setting this to 0 or no, the link will not appear, should that be preferred
|-
| <code>nolabels</code>
| By default the base map uses a map label model called 'osm-int'l', in which progressively higher zoom levels bring more place names onto the map. For some contexts it may be preferred to 'turn off' the place name labels, and use the mark/label options to provide such names as are wanted. By setting <code>nolabels = 1</code> an alternative 'osm' base map is used, with no place name labels. (At higher zooms the road names still occur).
|-
| <code>caption</code><br><code>auto-caption</code>
| Optionally, a text caption can be included, below the map. Unless overridden by tags etc., this is left-justified plain text. It can include any wiki-item that can be inserted into a table cell, including images, formatting, citation references, etc.<br>If <code>auto-caption=1</code>, a numbered list will be automatically generated to follow any caption. This will generally only make sense when using numbered dots.
|-
| <code>title</code>
| Optionally a title or other text can be placed in a cell above the map. By default this is centred and bold, but as with the caption, any wiki-markup etc. can be included.
|-
|<code>map-data-heavy</code><br>
<code>map-data-light</code><br>
<code>map-data</code><br>
<code>map-data-text</code><br>
<code>map-data-color</code><br>
<code>map-data-width</code>
| Allows OSM ExternalData elements to be added to the map. This can be an administrative boundary, highway or other map element that has been assigned a wikidata Q value. (e.g.: <code>map-data=Q83065</code> will add the city boundary of Leicester.) The map item needs to be on the same place as the map itself. It currently only allows line features (not areas etc.), which appear as various styles of line. Multiple elements can be added, separating each Q value by a comma. A major limitation, as of May 2017, is that it only appears on the 'fullscreen' map, not on the framed map on the page. Adding map-data items now should mean they appear on the page if and when this limitation is overcome. [http://nominatim.openstreetmap.org/ nominatim.openstreetmap.org/] has a search engine to identify data elements for which Q values have been assigned, or to add wikidata Q values to map elements. 

For <code>map-data-heavy</code> and <code>map-data-light</code>, this will draw orange lines of thickness 9 and 3 pixels respectively. <code>map-data</code> is more flexible, so can default to an orange line of 6 pixels, but color (using format #XXXXXX) and width in pixels can be set, as can a text element which appears when the line is clicked on. This can include wikilinks.
|-
| <code>minimap</code>
|Used to add an optional locator minimap in the bottom left corner. If set to <code>on</code> it adds a 'built in' small(ish) world map with a locator dot showing the position of the main map. (This is a feature supplied by the underlying 'Graph:' template, so the only control over it is to be set as on or off.) If set too <code>off</code> it is not used. If set to <code>file</code> it requires the next section details to be added, which will include a custom map. Default is no.
|-
|<code>mini-file</code><br>
<code>mini-width</code><br>
<code>mini-height</code><br>
|Takes the file name of a standard location map from commons, and displays it as a minimap in the bottom left corner, provided <code>minimap=file</code>. This can be used to show a larger entity from which the main map is drawn.
|-
|<code>minipog-x</code><br>
<code>minipog-y</code><br>
<code>minimap-boxwidth</code>
| Within the custom minimap this can place an optional small Red pog. Nb. The x and y are not lat and lon values. They relate to the  mini-width and mini-height. The origin is top,left of the mini map, so if mini-width=80 and minipog-x=20, it will be a quarter of the way across. (Some location maps have a highlighted location already, so leaving these two parameters undefined gives the map without a dot.)

minimap-boxwidth=xx can optionally use an open red box instead of a Red pog. xx = the pixel width of the box, and the height is then matched in proportion to the actual map. In general anything much below xx=15 will be better served by a dot. The required width will require some trial and error to pin down. If xx=0 or minimap-boxwidth is undefined, a Red pog is used.
|-
|<code>scalemark</code>
|By default or with scalemark=1, a scale line with guide to the scale of the map is supplied in the bottom right corner of the map. If this is not required - e.g. if it interfers with a map element at that point - it can be turned off by setting this to '0'. To shift it further left, e.g. to avoid a minimap, or to avoid a 'busy' bit of the map, enter the number of pixels. e.g. scalemark=180 will move it to the left of the built-in minimap. If there is no minimap it does not need to be mentioned.
|-
! colspan="2" style="background-color:lightblue" | Label and mark parameters. 
Twenty-one marks can be set on the map, being an un-numbered version, and the rest numbered 1 to 20. The first numbered one, (mark1, label1, etc.) is a 'master marker' and its values (or defaults) are inherited by the other numbered markers unless set individually. All label, mark and full-screen parameters are available for each numbered marker. 

If the un-numbered mark is used as the subject of the map, it will be point 1 on the Full Screen map (unless <code>mark-title=none</code>) and can use specific mark and label values of its own. The first numbered mark sets some general defaults, which can apply to subsequent marks.
|-
! Parameter
! Description
|-
| <code>shape</code>
| OSM Location map can use either an external image as a location marker, or one of various built-in shapes. Shape should either be set as <code>=image</code> or can be a circle, square, cross, diamond, triangle-up or triangle-down. If blank or absent it will default to 'image', and use either a Red pog.svg or specified <code>mark = </code> image. If numbered dots are required, use <code>shape1=n-circle</code> Subsequent markers will use the same setting, and automatically number up to 20. <code>shape1=l-circle</code> will do the same but with letters, and any of the built in shapes can be used.
|-
| <code>shape-color</code><br><code>shape-outline</code><br><code>numbered</code>
| Set the shape infill and outline to any color, using HTML colour names and hex triplets (e.g. #FF0000), as described at [[Web colors]]. Only used for built in shapes. Setting them to the same value gives an appearance of no outline. Default = #B80000 (a dark red). The <code>numbered = </code> parameter is used with numbered shapes, to override the automatically allocated number.
|-
| <code>mark</code>
| The name of a Wikimedia commons file, which is used as the marker. Default is Red pog.svg. Other pog colours are available, and a large range of map markers can be found at [[Commons:Location markers]] and [[Commons:Category:Map icons]]
|-
| <code>mark-size</code> <br><code>mark-dim</code>
| Size and dimensions of a marker. <code>mark-size</code> is used by both <code>shape</code> and <code>mark</code> to define the size of the marker symbol. It sets the height of the mark or shape in pixels (no 'px' required, default is 10). If only a text label is wanted with no marker, set <code>mark-size=0</code>.  <br> <code>mark-dim</code> is used to give a non-square mark. (It has no effect with the built in shapes.) default is 1, i.e. equal width and height. A value of 1.4 will give a typical landscape rectangle. 0.7 will give a typical portrait rectangle. If the original mark-file is non square, a value here is needed to correct the proportions.
|-
| <code>mark-coord</code>
| Latitude and longitude coordinates of the marker point. Use the format <code><nowiki>mark-coord={{Coord|lat value|lon value}}</nowiki></code>. Used by either <code>shape</code> and <code>mark</code> as well as the related <code>label</code>. If the location is outside the area of the map, it will not appear. (for backwards compatibility mark-lat and mark-lon still work, but are not the preferred method.)
|-
| <code>label</code><br><code>labela</code><br><code>labelb</code>
| Text to appear alongside a mark or shape. No inline formatting, line wrapping, or other tags, links etc. are possible. If left blank then any mark will show without a label. If only a text label is wanted with no marker, set <code>mark-size=0</code> A blank label and a mark-size=0 will result in an invisible marker, which will still feature on the Full screen option. If the label is too long for a single line, use labela and labelb for 2nd and 3rd lines. nb if labelb is set without a labela, there will still be a gap where labela would go.
|-
| <code>label-size</code> 
| Sets the text size for the label, in points. default = 10
|-
| <code>label-color</code>
| Sets the text colour for the label. The standard colour labels (red, black, grey, white, blue, green etc...) all work as described, but can be rather strident for labels other than the subject of the map.  Default=dark red. Hex triplet (e.g. #FF0000), as described at [[Web colors]] give a wide range of available colors.

Some suggested standardised colours:-
*<code>#81AF81</code> (Pale Green): Landscape feature (park, range of hills, nature reserve, etc)
*<code>#77A1CB</code> (Pale Blue): Water feature (rivers, lakes, bays, maritime names, etc)
*<code>#776666</code> (Charcoal grey): Settlements (towns, villages, buildings etc)
|-
| <code>label-pos</code>
| Sets the position of the label, relative to the marker: left, right, top or bottom. Default=left. Top and bottom text is center-justified, whereas left and right align against the marker. The label aims to be an appropriate distance from the edge of the marker, but irregular shapes and larger sizes may need further adjustment using the label-offsets.
|-
|<code>label-angle</code>
| It is possible to specify a <code>label-angle = </code>, which will pivot the label text around the centre of the marker point by the specified number of degrees. (+ve angle rotates clockwise, -ve anticlockwise) If mark-size is set to zero, this has the effect of a free-floating label with no marker, useful for various geographic and linear features. For stylistic consistency all settlement names should not be given an angle.
|-
| <code>label-offset-x</code> <br><code>label-offset-y</code>
| Allows adjustment of the label location in an x and y direction, relative to its mark coordinates, by the specified number of pixels. It can be +ve or -ve numbers. Higher -x values will move the label to the right. Higher -y values move it down the map. Default is 0,0.
|-
! colspan="2" style="background-color:lightblue" | Additional content for Full screen link
The 'full screen' map uses the same OSM base map, in a different map environment, including the option for users to scale in and out, to pan across the map, and to find (via the 'More details' button) other maps and satellite imagery for the location. It also includes numbered markers, for which tooltip-style titles, and image thumbnails with captions can be brought up. This makes most sense where there are several markers on the map. The content for this facility is set with the following three parameters - which need to be numbered for each mark as for the other mark attibutes:
|-
! Parameter
! Description
|-
| <code>mark-title</code>
| This title appears as a tooltip and also a thumbnail title, accessed via the marker. if <code>mark-title=none</code> that will exclude that marker from the full screen map. (it will still show as normal on the main map).
|-
| <code>mark-image</code>
| This provides a pop-up thumbnail image when the marker is clicked. Include only the image name from Wikimedia commons etc. (i.e. no brackets, or 'File:').
|-
| <code>mark-description</code>
| Caption text, which will either accompany a pop-up photo, or if no photo then as a text box, when the marker is clicked. This can include wikilinks etc., to link on to additional relevant articles.
|}

==Underlying technology==
OSM Location map itself has no map or display ability of its own. Everything within the frame is produced through the template {{tl|Graph:Street map with marks}}, created by [[User:Yurik]]. This in turn calls internal processes that turn all the data supplied at edit time into a rendered bitmap image, so that there is no calculation overhead by the time the page is read by a user, any more than any other commons image. 

Whilst the map is being edited and previewed, the page is supplied with a rasterised image, collating the base-map, marks, labels, etc. on the fly. It will be particularly noticeable on small fonts that when the 'Publish Changes' button is pressed, the resulting bitmap has much worse fonts than the preview. (Maybe this will be improved at some point). The process of updating the map image and providing the right bitmap is all handled internally and invisibly. One of the consequences of the 'bitmap' solution, which is different from the standard {{tl|Location map}} method, is that there is no text or objects on the final image, so there is no possibility of adding wikilinks within the template. 

The full screen option, which can be clicked through from below the map, provides an entirely different mapping approach, using the same base-map data. This provides an interactive map that can be panned and zoomed. It also replicates (although at present only as numbered markers) the various marks from the page map. These can then be given more content, by way of a title, caption and image. The caption and title can then be given all the wikilinks and other markup features that may be desired, providing a map-based page that will offer another way of engaging with the article content.

Future development of the various mapping technologies is likely to result in further options for showing maps on Wikipedia. In particular, something more like the fullscreen interactive map, but within a frame, is likely to emerge. It has a much higher processor overhead than the bitmap based solution, which seems to be one reason for a slow and cautious development. The most likely main use of that might be within info-boxes, where the whole map is automatically generated from already available data. 

This, on the other hand, is better suited to a hand-edited map, in which the area displayed and the selection of items and labels included are selected, edited, and added to, to suit the specifics of the subject in hand. A further approach, which is not currently supported within this template, but is available via the inderlying 'Graph' template, is to draw the data from [[Wikidata]], using a query that provides the selection of marks requested. 

The 'Graph' technology used here is described as under development, so while it is highly likely that this or a similar solution will still be available, it may evolve over time.

<includeonly>{{sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Location map templates|Location map templates]]
[[Category:Map formatting and function templates]]
}}</includeonly>