Display points

Display points
What:
Map display with one or more markers
Min version:
0.1
Max version:
still supported
Function implementation:
Yes
Tag implementation:
Yes

You can use the #display_points parser function to display rich and dynamic maps with markers in articles. This function is part of the Maps extension, so you should have Maps installed in order to use it.

Usage

Mapping services

This parser hook is supported by these mapping services:

• Google Maps
• Google Maps 0.7.x
• Google Maps v2
• OpenLayers
• OpenLayers 0.7.x
• Yahoo! Maps
• Yahoo! Maps 0.7.x

Syntax

{{#display_points: <your locations> |height= <some height> |service= <your service> }}

Parameters

Parameter	Aliases	Default	Usage
Default, Coordinates or Address	-	required	The location the map will initially be centred on. Depending on which name you provide for this parameter, the values will be treated differently. This behaviour will be removed in 0.7. Default (nameless) parameter: Provide either an address or set of coordinates, and Maps will figure out what to do with it. Coordinates: Only valid coordinates will be accepted, addresses will not be geocoded. Address: The location will be treated as an address and geocoded, even when it's a set of coordinates.
service	-	configurable	Allows to set the mapping service that will be used to generate the map.
geoservice	-	configurable	Allows to set the geocoding service used to turn the location into coordinates when it's an address.
width	-	configurable	Allows to set the width of the map, in pixels.
height	-	configurable	Allows to set the height of the map, in pixels.
zoom	-	configurable	Allows to set the zoom level of the map. When not provided and multiple markers are present on the map, the best fitting zoom will be taken, not the configurable default.
centre	center	configurable	Allows to set the coordinates of the map's centre for display_point(s). Accepts both addresses and coordinates. When this property is not provided, the map will centre itself on the provided marker, or between the provided markers.
title	-	empty	Allows to set text that will be displayed in the pop-ups of all markers that do not have a specific title. When used together with label, the title will be bold and have a line under it.
label	-	empty	Allows to set text that will be displayed in the pop-ups of all markers that do not have a specific label.
icon	-	Default mapping service marker	Allows you to set the icon used for all markers. Should be "File:Foo.png" or "Foo.png" for a picture in the Wiki. An external link is also possible.

Examples

Also see the Maps examples, which are much more extensive.

{{#display_point:New York City}}

Loading map...

{"minzoom":false,"mappingservice":"googlemaps3","type":"ROADMAP","zoom":14,"types":["ROADMAP","SATELLITE","HYBRID","TERRAIN"],"geoservice":"google","maxzoom":false,"width":"auto","height":"350px","centre":false,"title":"","label":"","icon":"","visitedicon":"","lines":[],"polygons":[],"circles":[],"rectangles":[],"copycoords":false,"static":false,"wmsoverlay":"","layers":[],"controls":["pan","zoom","type","scale","streetview"],"zoomstyle":"DEFAULT","typestyle":"DEFAULT","autoinfowindows":false,"kml":[],"gkml":[],"fusiontables":[],"resizable":false,"tilt":0,"kmlrezoom":false,"poi":true,"imageoverlays":[],"markercluster":false,"searchmarkers":"","locations":[{"text":"","title":"","link":null,"lat":40.7143528,"lon":-74.0059731,"alt":0,"address":"New York City","icon":"","group":"","inlineLabel":"","visitedicon":""}]}

<display_points type="terrain">
Amsterdam
Berlin|This is Berlin
London|London|The capital of [[England]].
Ghent|Ghent|Most awesome city in Europe|Green marker.png
</display_points>

Loading map...

{"minzoom":false,"mappingservice":"googlemaps3","type":"TERRAIN","zoom":false,"types":["ROADMAP","SATELLITE","HYBRID","TERRAIN"],"geoservice":"google","maxzoom":false,"width":"auto","height":"350px","centre":false,"title":"","label":"","icon":"","visitedicon":"","lines":[],"polygons":[],"circles":[],"rectangles":[],"copycoords":false,"static":false,"wmsoverlay":"","layers":[],"controls":["pan","zoom","type","scale","streetview"],"zoomstyle":"DEFAULT","typestyle":"DEFAULT","autoinfowindows":false,"kml":[],"gkml":[],"fusiontables":[],"resizable":false,"tilt":0,"kmlrezoom":false,"poi":true,"imageoverlays":[],"markercluster":false,"searchmarkers":"","locations":[{"text":"","title":"","link":null,"lat":52.3702157,"lon":4.8951679,"alt":0,"address":"Amsterdam","icon":"","group":"","inlineLabel":"","visitedicon":""},{"text":"<p>This is Berlin\n<\/p>","title":"This is Berlin\n","link":null,"lat":52.519171,"lon":13.4060912,"alt":0,"address":"Berlin","icon":"","group":"","inlineLabel":"","visitedicon":""},{"text":"<b><p>London\n<\/p><\/b><hr \/><p>The capital of <a href=\"\/wiki\/England\" title=\"England\">England<\/a>.\n<\/p>","title":"London\n","link":null,"lat":51.5112139,"lon":-0.1198244,"alt":0,"address":"London","icon":"","group":"","inlineLabel":"","visitedicon":""},{"text":"<b><p>Ghent\n<\/p><\/b><hr \/><p>Most awesome city in Europe\n<\/p>","title":"Ghent\n","link":null,"lat":51.053468,"lon":3.73038,"alt":0,"address":"Ghent","icon":"\/w\/images\/Green_marker.png","group":"","inlineLabel":"","visitedicon":""}]}

{{#display_points:New York City;Moscow;Berlin|geoservice=geonames|service=openlayers|layers=osmarender}}

Loading map...

{"minzoom":false,"mappingservice":"openlayers","geoservice":"google","zoom":false,"maxzoom":false,"width":"auto","height":"350px","centre":false,"title":"","label":"","icon":"","visitedicon":"","lines":[],"polygons":[],"circles":[],"rectangles":[],"copycoords":false,"static":false,"wmsoverlay":"","controls":["layerswitcher","mouseposition","autopanzoom","scaleline","navigation"],"layers":["new OpenLayers.Layer.OSM.Osmarender(\"OSM arender\")"],"resizable":false,"searchmarkers":"","locations":[{"text":"","title":"","link":null,"lat":40.7143528,"lon":-74.0059731,"alt":0,"address":"New York City","icon":"","group":"","inlineLabel":"","visitedicon":""},{"text":"","title":"","link":null,"lat":55.7512419,"lon":37.6184217,"alt":0,"address":"Moscow","icon":"","group":"","inlineLabel":"","visitedicon":""},{"text":"","title":"","link":null,"lat":52.519171,"lon":13.4060912,"alt":0,"address":"Berlin","icon":"","group":"","inlineLabel":"","visitedicon":""}],"imageoverlays":null}

See also

• Display map parser hook

This documentation page applies to all (Semantic) Maps versions from 0.7 to the most current version.

Other versions: 0.1 – 0.6.6      

Display points en 0.7