మూస:OSM Location map
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 two 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.
{{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.
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
{{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.) Mark1
acts as a 'master marker' for subsequent parameters. Values given to the 'mark1 set' are inherited by the other numbered sets, which avoids repetition.
Two markers and a mini-locator map[మార్చు]
Example title |
Scheduled monuments around Llanfechell, Anglesey |
{{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]]
}}
|
Multi marker example[మార్చు]
Pentre Ifan and other nearby Neolithic sites |
{{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
| label = Pentre Ifan
| mark-coord = {{coord|51.9990|-4.7700}}
| mark = Archaeological site icon (red).svg
| 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}}
| mark1 = Archaeological site icon (red).svg
| mark-size1 = 9
| label-size1 = 10
|label-color1 = hard grey
| 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.
| 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}}
| label9 = P R E S E L I H I L L S
| mark-coord9 = {{coord|51.973|-4.77}}
| mark-size9 = 0
|label-angle9 = 25
|label-color9 = soft green
| mark-title9 = none <!-- to suppress the full-screen marker -->
}}
|
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 (minimap = on
). Unfortunately it is too general for most purposes, so making use of an existing 'Location map' file is possible. This is can be seen in the Llanfechell map example, it 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.
| 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, 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.
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[మార్చు]
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 =
andlabelb =
.
- 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. (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.
Numbered dots[మార్చు]
Listed buildings in Stoneygate 1 2 3 4 5 6 |
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.
Full list of parameters[మార్చు]
London's Heathrow Airport |
![]() With five terminals, Heathrow Airport, is the busiest airport in Europe. |
{{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
}}
|
- Code blank- all 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 =
| 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- values set in mark1 will be inherited by all other numbered markers-->
| mark1 =
| mark-coord1 ={{coord| | }}
| label1 =
| label-pos1 =
}}
Parameters[మార్చు]
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, bounderies, 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. |