टेम्पलेट:OSM Location map/doc

[Full screen]

Old John Tower in Bradgate Park, Leicestershire

This template provides a map in a frame, for any location and scale. At its simplest it can simply show the OpenStreetMap 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 to one or two streets. It makes use of the OpenStreetMap 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 {{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 <maplink> 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.

Comparison with {{Maplink}}

From May 2018 it has also been possible to create a map in a frame via {{Maplink}}, which in some respects does a similar job to OSM Location map. In both cases a static map image can be added to an article, for anywhere in the world, pulling in the map from OpenStreetMap data. The differences are in what they can and can't add to the base map. Maplink, in both its framed and fullscreen versions, can only add either points (numbered or icon-style pointy dots), or various lines and areas can be imported from OpenStreetMap via wikidata Q values (such as boundaries, roads, rivers etc). Thus the framed map and fullscreen version will show identical information. The OSM Location map on the other hand, cannot add the Q value lines and areas except to the fullscreen click-through, but can use the framed map to show a much richer selection of dots, shapes, overlays, images and especially text to convey specific details relevant to a particular article.

Usage

Minimal version

an unadorned map centred on a latitude and longitiude coordinates, via a {{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.

[Full screen]

{{OSM Location map <!--There are only two essential parameters: --> | coord = {{coord|53.4146|-4.3341}} <!--lat and long coordinates for middle of the map --> | zoom = 15 <!--zoom 0=whole world, 18=a street.--> }}

Single marker

Using mostly default settings, with a Red pog marker and label, and some additional info for use on the full screen version.

[Full screen]

The 'Llanfechell Triangle' standing stones are north-west of Llanfechell.

{{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]]. | label = Llanfechell Triangle | mark-coord = {{coord|53.3966|-4.46204}} | 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]] }}

Code blank

Blank code for a single marker map

Blank code with comments

{{OSM Location map | coord = {{coord| | }} | zoom = | width = | height = | caption = | label = | mark-coord = {{coord| | }} | label-pos = | mark-title = | mark-image = | mark-description = }}

{{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 as pixels. Do not add px --> | height = | caption = <!-- Text below the map. Can include [[wikilinks]] --> <!-- Parameters for 1st mark --> | label = <!-- text alongside the mark --> | mark-coord = <!-- use {{coord| | }} to set lat and lon location for the marker --> | label-pos = <!--default position is left. It can also be right, top, bottom. --> | mark-title = <!-- | --> | mark-image = <!-- | these are only used within the full screen linked page --> | mark-description = <!-- | --> }}

Multiple markers, labels and images

In addition to the un-numbered mark parameter set, there are 30 numbered ones. These are otherwise identical to the one above, but the name terminates in a number (1-30). Each mark and label has its own set of parameters (|mark1=, |mark-coord1=, |label1=, |label-pos1= etc...|mark2=, |mark-coord2=, |label2=, |label-pos2= etc.) Values can be inherited either from the 'mark1 master parameter set', or from a special 'markD' Default set that provides overide defaults. When set, these values are inherited by the other numbered sets to avoid having to repeat for each, whilst they can still be set individually where required.

Multiple markers

Example title

[Full screen]

Scheduled monuments around Llanfechell, Anglesey

Example code for the two-marker map one the right:

{{OSM Location map | coord = {{coord|53.395|-4.452}} | zoom = 14 | float = right | width = 300 | height = 250 | caption = Scheduled monuments around [[Llanfechell]], [[Anglesey]] | title = Example title | minimap = file <!-- Adds a 'mini-image' to the bottom right corner --> | mini-file = Wales relief location map.jpg | mini-width = 70 <!-- All units for the mini-image are pixel units --> |mini-height = 90 <!-- height and width need to match the dimensions of the image file --> | minipog-x = 25 <!-- x and y co-ordinates are pixels numbered from a top-left origin --> | minipog-y = 4 <!-- They optionally place a red dot to show location of the main map --> | scalemark = 66 <!-- shifts the scalemark further to the left --> | label1 = Baron Hill Maen Hir <!-- first marker details --> | mark-coord1 = {{coord|53.3964|-4.4531}} | mark1 = Red pog.svg <!-- Red pog is the default so not really needed --> | label-pos1 = right <!-- Various settings in mark1 are inherited by the other marks --> | label-size1 = 11 <!-- unless they are over-ridden individually --> | label-color1 = hard grey <!-- some standard colors can be used that blend with the map --> | 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]]. | label2 = Llanfechell Triangle <!-- second marker details --> | mark-coord2 = {{coord|53.3966|-4.46204}} | label-pos2 = top | label-offset-x2 = 35 <!-- Label offsets move the label (in pixel units) --> | label-offset-y2 = <!-- without affecting the marker position. +ve = right and down --> | 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]] }}

Inherited values

To minimise repetion of code, there is a sliding scale of inheritance that applies to each value in each parameter set. For example, if label-size4=16 is set, that will always take precedence. If label-size4 has not been set, it will inherit the value from the special Default setting (defined using label-sizeD= ). If no Default has been set, it will inherit the value set by the 'master parameter set', label-size1=. If that is also undefined it will fall back to the underlying default, which in the case of label-size is 12. The same is true of all the variables relating to marks and labels, (although not to the coordinates, labels themselves, or mark-titles, which are always unique to the particular mark they relate to.)

Adding a Minimap in the corner

Many pages with info-boxes already include a locator map to give readers a proper sense of where the topic or place is located within a broader area. The underling 'Graph' module that OSM Location map uses offers a built-in map of the world option, which will act as a mini locator map and automatically adds a red locator dot (minimap = on). Unfortunately it is too general for most purposes, so an alternative is to make use of an existing 'Location map' file. This can be seen in the Llanfechell map example, however it is not very automated. The width and height of the Location map both have to be decided upon, specified (and calculated so as to not distort the map dimensions). Some location maps may already highlight the feature, but if not, an optional locator 'pog' 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.

| minimap = file <!--this minimap is used in the Llanfechell example above-->
| 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 -->

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, so as to show the bounds of the main map. To use this feature, simply specify the width of the required box: minimap-boxwidth=xx 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.

Text on an arc

Text for broader geographic features can be placed around an arc, to convey a sense of a broader area, or to follow the curve of a river, mountain range, coastline, etc. This works entirely separately from the other labels. It does not attach itself to any mark or dot, and does not create any fullscreen markers. It requires coordinates for the first letter, parameters for the starting angle, radius of arc and gap between letters. Text size and color can also be specified, or inherited from Default settings.

Blank starter-code for text on an arcs, with starter-examples for different arc-patterns.
| arc-coordA={{coord|xxx|yyyy}} <!-- coordinates of first letter --> | arc-textA= <!-- Add your text here --> | arc-angleA= <!-- in degrees, -180 to 180. 0 will start as horizontal, -90 straight up, 90 straight down --> | arc-gapA= <!-- 1= a notional 'standard'. 0.2 is very tight, 10 is very wide--> | <!-- negative gap will invert the letters and run the other way around the circle --> | arc-radiusA= <!-- 1= a notional 'standard' 0.5 is quite a tight circle, 8 is so wide as to be almost flat --> | arc-text-sizeA = <!-- standard font sizes. If undefined, default is 12 --> | arc-text-colorA= <!-- sets text color. #000000 color hexes and standardised OSM Location map colors are accepted --> | ellipse-factorA=1.0 <!-- 1= notionally circular, 0.5 to 1.0 will flattern top and bottom, above 1.0 flattens the sides -->
Details about using artc-text, with starter-examples for different arc-patterns.
The nature of the earth's coordinate system means that there will be some variation in an arc at different latitudes and at different zoom levels. The program makes corrections for this, but there will still be residual variation. Similarly, changes in radius will also have some effect on the gap size, with a larger radius opening out the gap somewhat. There will therefore need to be considerable trial and correction to get the shape and effect desired. As a general rule, identify the coordinates of the required start-point, then choose a starter-pattern from the selection below, and then adjust parameters to fit the requirement of the map.
Shallow smile: [Full screen] arc-angleA=-170 arc-gapA=-1.2 arc-radiusA=1.6
Deeper smile: [Full screen] arc-angleA=-150 arc-gapA=-3 arc-radiusA=0.7
wide eyebrow: [Full screen] arc-angleA=-20 arc-gapA=3 arc-radiusA=0.8
opening bracket (reading up): [Full screen] arc-angleA=-110 arc-gapA=1.5 arc-radiusA=0.6
opening bracket (reading down): [Full screen] arc-angleA=-60 arc-gapA=-2 arc-radiusA=0.5
closing bracket (reading up): [Full screen] arc-angleA=120 arc-gapA=-1.5 arc-radiusA=0.8
closing bracket (reading down): [Full screen] arc-angleA=60 arc-gapA=2.5 arc-radiusA=0.4

Multi marker example

[Full screen]

Pentre Ifan and other nearby Neolithic sites

Worked example of a map with multiple markers and text: Pentre Ifan

{{OSM Location map | coord = {{coord|52.0|-4.810}} | zoom = 11 | width = 300 <!-- width and height of the frame. --> | height = 300 <!-- Use numeric input - do not add px --> | caption = Pentre Ifan and other nearby Neolithic sites | scalemark = 47 <!-- the optional 'D' values become Defaults for subsequent parameter sets --> | markD = Archaeological site icon (red).svg | mark-sizeD = 9 | label-sizeD = 10 |label-colorD = hard grey | label = Pentre Ifan | mark-coord = {{coord|51.9990|-4.7700}} | mark-size = 14 | label-size = 15 |label-color = dark grey | label-pos = left | mark-title = Pentre Ifan, [[List of Scheduled prehistoric Monuments in north Pembrokeshire|Pembrokeshire]] | mark-image = DMPentreIfanFront.JPG | mark-description = The largest and best preserved [[Neolithic British Isles|neolithic]] [[dolmen]] in [[Wales]] | label1 = Llech-y-Tribedd dolmen | mark-coord1 = {{coord|52.0545|-4.7717}} | mark-title1 = Llech-y-Tribedd, [[Pembrokeshire]] | mark-image1 = Llech-y-tribedd and Carn Ingli - geograph.org.uk - 1426923.jpg | mark-description1 = A well preserved dolmen with a massive capstone. | label2 = Carreg Coetan | labela2 = Arthur dolmen | mark-coord2={{coord|52.0186|-4.8282}} | label-pos2 = top | label-offset-x2 = -6 | label-offset-y2 = -2 <!-- other mark-title, -image and -description parameters are included on the map, (view the [full screen] option and click on the markers for the result), but are omitted from the sample text code to save space --> | label3 = Banc Du | labela3 = Neolithic enclosure | mark-coord3 = {{coord|51.9409|-4.823}} | label-pos3 = top | label4 = Bedd yr Afanc | labela4 = Burial Chamber | mark-coord4 = {{coord|51.9775|-4.7563}} | label-pos4 = top | label5 = Standing Stones | mark-coord5 = {{coord|51.9685|-4.7945}} | label-pos5 = right | label6 = Trellyffaint dolmen | mark-coord6 = {{coord|52.0478|-4.7982}} | label-pos6 = right | label7 = Cerig-y-Gof | labela7 = chambered tomb | mark-coord7 = {{coord|52.0137|-4.8627}} | label-pos7 = bottom | label-offset-x7=10 | label8 = Bedd Arthur stone circle | mark-coord8 = {{coord|51.9597|-4.7223}} | arc-latB = 52.0 | arc-lonB =-4.8800 | arc-angleB=-110 | arc-gapB=-4 | arc-radiusB=0.76 | arc-text-colorB=soft green | arc-textB=PRESSELI HILLS }}

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 Pentre Ifan example above uses 'Archaeological site icon (red).svg'. If a particular image file is specified in mark1=, all subsequent marks will use it as well 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)

Transparent overlay

[Full screen]

Leicester Castle and the line of the medieval town walls

A marker image does not have to be small and opaque. A larger overlay image (with a transparent background) can be used to show particular features not included in the base map, such as a town's former walls (see the adjacent map). Such images can be created in several ways (such as tracing over a copy of the base map); they are invoked like any other marker image file. (For a detailed guide to creating and deploying an overlay for these maps see User:J. Johnson/OSM overlay how-to).

Text color

Color of label text can be specified using label-color = . Standard html colors can be specified by name, and any color can be specified using the hex triplets coding #xxyyzz (see Web colors). However, to create a consistent look and feel across the wikipedia maps, there are some OSM Location map specific colors, with a more muted tone range that fit well with the color scheme of the base maps. In general it is best to make use of this range, unless there are good reasons for using other particular shades for specific features. Under normal usage, the following label color scheme should be followed:-

soft grey	Settlements = soft grey (Subject of the map can be hard grey and larger label-size) Map areas with darker or busier backgrounds may need to move a shade darker to hard grey and dark gray respectively.
soft blue	Rivers, lakes, sea areas etc = soft blue (Works well on top of OSM blue areas)
soft green	Parkland, national/regional parks, gardens, forests etc = soft green works well on top of OSM green areas. (hard green may be desirable in forests or for the subject of the map)
hard red	Individual sites = hard red - especially if no other labels are applied and the site is indicated by a red pog

Full table of color options

Colors recommended for OSM Maps. These have a more pastel shade than the standard colors, so blend well the map backgrounds
soft red #DB3123	hard red #AA1205	dark red #7A0101
soft green #81AF81	hard green #538253	dark green #165916
soft blue #77A1CB	hard blue #5581A9	dark blue #105396
soft grey #AAAA88	hard grey #777755	dark grey #333322
soft brown #CCB56C	hard brown #AD7F14	dark brown #8E5913

Text effects

multi-line label

Where label text is too long to fit on a single line, using label = , two further label lines can be used: labela = and labelb = .

Label with no mark

If mark-size=0 this has the effect of a free-floating label with no marker

Angled label

It is possible to specify a label-angle = , which will pivot the label text around the centre of the marker point by the specified angle. Using an angled label which also has no marker is particularly good for labelling various geographic and linear features. A more characterful alternative is to set the text on an arc, using the ArcText options, illustrated by the 'Preseli Hills' text on the Pentre Ifan map. For stylistic consistency settlement and building names should not normally be given an angle.

Numbered dots

[Full screen]

Listed buildings in Stoneygate 1 St John The Baptist Church 2 Congregational Church 3 Eastfield, Stanley Road 4 Stoneygate School 5 The Firs 6 White House

If numbered dots are needed, instead of (or as well as) text labels, this can be achieved using the built in shapes. For example, shape1=n-circle 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 auto-caption=1 then the caption will generate a numbered list using the mark-title entries. For example:-

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

The other built-in shapes can be used in the same way (n-square, n-diamond etc.). The shape-outline1= value sets the colour for the number (unlike normal, when it sets the shape-outline), and as with the others, only the mark1 parameter values need to be set, to establish the default for this map, which can be overridden as required. The numbered1..2..3 etc parameters can override the automatic numbers or letters to use your own values for each mark. {{Flushing Meadows-Corona Park map}} is a useful real life example in template form.

Use in infoboxes

{{OSM Location map}} can be imbedded in infoboxes which allow the module parameter, for instance {{infobox school}} by using the instruction |module={{OSM Location map| ...}}. St John Fisher Catholic School is a real life school with two sites and marked on the infobox map.

Full list of parameters

Demonstration of multi-mark example, Heathrow Airport

{{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. This does not inherit parameter values from the 'master marker', mark1 and its parameter values have to be entered in full. Other labels have a number attached to each parameter name.--> | 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 = hard red | 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 30 to the marker parameter names, mark-coords are required for each marker. Most parameter values are inherited from the 'mark1' marker which acts as the 'master marker'--> | mark-coord1={{coord|51.470156|-0.448497}} | shape1 = image | shape-color1=red | shape-outline1= | mark1 = Airplane silhouette.svg | mark-size1 = 20 | label-color1 = hard red | label1=Terminal 2 | label-size1=13 | label-pos1=bottom | mark-title1 = Heathrow Airport Terminals 1 & 3 }}

London's Heathrow Airport [Full screen] With five terminals, Heathrow Airport, is the busiest airport in Europe.

Code blank - OSM Location map template, listing all the parameters

{{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 = <!-- optional default settings. These 'D' parameters only create override values for subsequent marks. They make no marks of their own --> | shapeD = | shape-colorD = | shape-outlineD = | markD = | mark-sizeD = | mark-dimD = | label-sizeD = | label-colorD = | label-angleD = | label-posD = | label-offset-xD = | label-offset-yD = <!-- unumbered parameter set creates mark and/or label on the map --> | mark-coord = {{coord| | }} | mark = | shape = | shape-color = | shape-outline = | mark-size = | mark-dim = | label = | labela = | labelb = | label-size = | label-color = | label-angle = | label-pos = | label-offset-x = | label-offset-y = | mark-title = | mark-image = | mark-description= <!-- Arc text (A, B and C) no shape, mark or fullscreen effects, just text placed on an arc. Coords are for the first letter.--> | arc-coordA={{coord| | }} | arc-textA= | arc-angleA= | arc-gapA= | arc-radiusA= | arc-text-sizeA = <!-- defaults to 12 --> | arc-text-colorA= | ellipse-factorA= <!-- defaults to 1.0 --> <!-- numbered markers (1 to 30). Values set in mark1 will be inherited by all other numbered markers, unless overidden by a 'D' value--> | mark-coord1 = {{coord| | }} | mark1 = | shape1 = | shape-color1 = | shape-outline1 = | mark-size1 = | mark-dim1 = | label1 = | labela1 = | labelb1 = | label-size1 = | label-color1 = | label-angle1 = | label-pos1 = | label-offset-x1 = | label-offset-y1 = | mark-title1 = | mark-image1 = | mark-description1= | mark-coord2 ={{coord| | }} | mark2 = | shape2 = | shape-color2 = <!-- ... and so on for all the parameters above, for all numbers up to 30 --> }}

Parameters

Map display parameters
Parameter	Description
coord	Latitude and longitude coordinates of the centre point of the map. Use coord={{Coord|latitude|longitude}}. {{Coord}} can deal with a wide range of formats. e.g.: coord={{Coord|57|18|22|N|4|27|32|W}}, coord={{Coord|44.112|N|87.913|W}}, coord={{Coord|44.112|-87.913}}. 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). gridreferencefinder.com, is a helpful place to find coordinates, or you can right=click on the 'Full screen linked' map.
zoom	Sets the scale of the map, from 0 to 19, to the levels defined by OpenStreetMap. (details 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.
float	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.
width height	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.
fullscreen-option	By default a [Full screen] 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
nolabels	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 nolabels = 1 an alternative 'osm' base map is used, with no place name labels. (At higher zooms the road names still occur).
caption auto-caption	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. If auto-caption=1, a numbered list will be automatically generated to follow any caption. This will generally only make sense when using numbered dots.
title	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.
map-data-heavy map-data-light map-data map-data-text map-data-color map-data-width	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.: map-data=Q83065 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. 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 map-data-heavy and map-data-light, this will draw orange lines of thickness 9 and 3 pixels respectively. map-data 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.
minimap	Used to add an optional locator minimap in the bottom left corner. If set to on 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 off it is not used. If set to file it requires the next section details to be added, which will include a custom map. Default is off.
mini-file mini-width mini-height	Takes the file name of a standard location map from commons, and displays it as a minimap in the bottom left corner, provided minimap=file. This can be used to show a larger entity from which the main map is drawn.
minipog-x minipog-y minimap-boxwidth	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.
scalemark	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.
Label and mark parameters.
Thirty-one marks can be set on the map, being an un-numbered version, and the rest numbered 1 to 30. 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 mark-title=none) and can use specific mark and label values of its own. The first numbered mark has values that will be inherited by subsequent marks. For added flexibility a parameter set with a 'D' value instead of a number will override the master values with a more general Default.
Parameter	Description
shape	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 =image 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 mark = image. If numbered dots are required, use shape1=n-circle Subsequent markers will use the same setting, and automatically number up to 30. shape1=l-circle will do the same but with letters, and any of the built in shapes can be used.
shape-color shape-outline numbered	Set the shape infill and outline to any color, using either the color names shown under 'label-color' blow, or 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 numbered = parameter is used with numbered shapes, to override the automatically allocated number.
mark	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
mark-size mark-dim	Size and dimensions of a marker. mark-size is used by both shape and mark 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 mark-size=0. mark-dim 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.
mark-coord	Latitude and longitude coordinates of the marker point. Use the format mark-coord={{Coord|lat value|lon value}}. Used by either shape and mark as well as the related label. 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.)
label labela labelb	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 mark-size=0 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.
label-size	Sets the text size for the label, in points. default = 10
label-color	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 on the OSM map. Each of the colors below have three standard shades - soft, hard and dark. Default=hard red Under normal usage, the following label color scheme should be followed:- soft grey Settlements = soft grey (Subject of the map can be hard grey and larger label-size). Map areas with darker or busier backgrounds may need to move a shade darker to hard grey and dark gray respectively. soft blue Rivers, lakes, sea areas etc = soft blue (Works well on top of OSM blue areas) soft green Parkland, national/regional parks, gardens, forests etc = soft green works well on top of OSM green areas. (hard green may be desirable in forests or for the subject of the map) hard red Individual sites = hard red, especially if no other labels are applied and the site is indicated by a red pog Full table of colors recommended for OSM Maps. These have a more pastel shade than the standard colors, so blend well the map backgrounds soft red #DB3123 hard red #AA1205 dark red #7A0101 soft green #81AF81 hard green #538253 dark green #165916 soft blue #77A1CB hard blue #5581A9 dark blue #5581A9 soft grey #AAAA88 hard grey #777755 dark grey #333322 soft brown #CCB56C hard brown #AD7F14 dark brown #8E5913 Standard html colors. These tend to look rather harsh on the OSM maps but are retained for compatibility White #FFFFFF Silver #C0C0C0 Gray #808080 Red #FF0000 Maroon #800000 Yellow #FFFF00 Olive #808000 Lime #00FF00 Green #008000 Aqua #00FFFF Teal #008080 Blue #0000FF Navy #000080 Fuchsia #FF00FF Purple #800080 Black #000000 It is also possible to specify any HTML Hex color using the six-figure hex-code, eg #AAAAAA, but sticking to defaults maintains consistency between pages If no color is specified the text will have a default of 'hard red' Any text other than one of the named colors above or a hex code will return as 'hard red'
label-pos	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.
label-angle	It is possible to specify a label-angle = , 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.
label-offset-x label-offset-y	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.
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
mark-title	This title appears as a tooltip and also a thumbnail title, accessed via the marker. if mark-title=none that will exclude that marker from the full screen map. (it will still show as normal on the main map).
mark-image	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:').
mark-description	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.
Arc Text: label placed on an arc
The use of arc-text parameters allows a short text (up to 20 characters) to be placed along on arc, with parameters to control the tightness of the circle (radius) and the looseness of the text (gap). The nature of the earth's coordinate system means that there will be some variation in an arc at different latitudes and at different zoom levels. Some allowance is factored in, but there will still be residual variation. Similarly, changes in radius will also have some effect on the gap size, with a larger radius opening out the gap somewhat. There will therefore need to be a degree of trial and correction to get the shape and effect desired. As a general rule, identify the coordinates of the required start-point, then choose a starter-pattern from the selection at OSM Location map#Text on an arc, and then adjust parameters to fit the requirement of the map. The parameters below are for set A. Sets B and C are also available.
Parameter	Description
arc-coordA	coordinates of first letter, using ={{coord|xxx.xx|yyy.yy}}
arc-textA=	Add your text here
arc-angleA	in degrees, -180 to 180. 0 will start as horizontal, -90 straight up, 90 straight down
arc-gapA	1= a notional 'standard'. 0.2 is very tight, 10 is very wide. Applying a negative gap will invert the letters and run the other way around the circle
arc-radiusA	1= a notional 'standard' 0.5 is quite a tight circle, 8 is so wide as to be almost flat, dependent on latitude and zoom level
arc-text-colorA	sets text color. #000000 color hexes and standardised OSM Location map colors are accepted
ellipse-factorA	will squash or stretch the circle. 1= notionally circular, 0.5 to 1.0 will flattern top and bottom, above 1.0 flattens the sides.

Underlying technology

OSM Location map itself has no map or display ability of its own. Everything within the frame is produced through the template {{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 {{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 along with displaying the coordinate values. 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, {{maplink}}, which initially just created a text link to a full-screen map, can now create a framed image including dot-markers, roads, boundaries, etc., and can acquire data directly from wikidata to do this. Again, the processor overheads are reduced by initially showing a bitmap, which can be clicked to become interactive within its frame. Maplink is being effectively rolled out within info-boxes, where the map is automatically generated from already available data.

This template, on the other hand, is probably better suited to a hand-editable 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:Street map with marks}} template, is to draw the data from Wikidata, using a SPARKL 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.