Google Maps SMW queries

From Maps for MediaWiki
Revision as of 02:14, 11 May 2020 by Jeroen De Dauw (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Maps adds a Google Maps result format as part of its integration with Semantic MediaWiki. This result format can be used to visualize queried data onto a map.

Syntax[edit | edit source]

Maps shown with the Google Maps result format can be customized using various parameters. This example demonstrates a query for coordinates stored on page Example data:Berlin coordinates and usage of the kml parameter:

{{#ask: [[Coordinates::+]] [[Example data:Berlin coordinates]]
 | format=googlemaps
 | kml=BerlinDistricts.kml
 | ?Coordinates
 | zoom=9
Loading map...

Parameters[edit | edit source]

Parameter Aliases Type Default Description
width - number and dimensional unit auto Allows setting the width of the map. By default pixels will be assumed as unit, but you can explicitly specify one of these units: px, ex, em, %.
height - number and dimensional unit 350 Allows setting the height of the map. By default pixels will be assumed as unit, but you can explicitly specify one of these units: px, ex, em.
centre center text no The location on which the map should be centered
title - text empty Allows setting 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 underlined.

label text text empty Allows setting text that will be displayed in the pop-ups of all markers that do not have a specific label.
icon - text empty Allows setting the icon used for all markers.
lines - List of lines empty Lines to display
polygons - List of geographical polygons empty Polygons to display
circles - List of circles empty Circles to display
rectangles - List of rectangles empty Rectangles to display
maxzoom - whole number no The maximum zoom level
minzoom - whole number no The minimum zoom level
copycoords - yes/no no Show a dialog when clicking on a location from which its coordinates may be copied
static - yes/no no Make the map static
visitedicon - text empty The filename of an image to be used for marker icons after the original markers have been clicked
wmsoverlay - Web Map Service overlay no Use a WMS overlay
zoom - whole number 14 The zoom level for the map. For maps with markers this will default to the most zoomed in level that still shows all markers.
type - text roadmap The map type to initially show.
types - list of texts roadmap, satellite, hybrid, terrain The map types that will be available via the type control.
layers - list of texts empty Special layers to load onto the map.
controls - list of texts pan, zoom, type, scale, streetview, rotate The controls to place on the map.
zoomstyle - text default The style of the zoom control.
typestyle - text default The style of the type control.
autoinfowindows - yes/no no Automatically open all info windows after the page has loaded.
resizable - yes/no no Makes the map resizable by dragging at its lower right corner.
kmlrezoom - yes/no no Rezoom the map after the KML layers have been loaded.
poi - yes/no yes Show points of interest.
cluster markercluster yes/no no Allows merging of multiple nearby markers into one marker
clustergridsize - whole number 60 The grid size of a cluster in pixels.
clustermaxzoom - whole number 20 The maximum zoom level where clusters may exist.
clusterzoomonclick - yes/no yes Whether the default behaviour of clicking on a cluster is to zoom into it.
clusteraveragecenter - yes/no yes Whether the center of each cluster should be the average of all markers in the cluster.
clusterminsize - whole number 2 The minimum number of markers to be in a cluster before the markers are hidden and a count is shown.
imageoverlays - List of image overlays empty Allows adding an image to be shown on the specified location on the map.
kml - list of texts empty KML files to load onto the map.
gkml - list of texts empty KML files hosted by Google to load onto the map.
searchmarkers - text empty Allows to search for specific markers via a field embedded into the map.
fullscreen enablefullscreen yes/no no Enable fullscreen button
scrollwheelzoom scrollzoom yes/no no Indicates if mouse scrolling should be enabled or not.
staticlocations locations, points List of locations empty A list of locations to add to the map together with the queried data. Like with display_points, you can add a title, description and icon per location using the tilde "~" as separator.
showtitle show title yes/no yes Show a title in the marker info window or not. Disabling this is often useful when using a template to format the info window content.
hidenamespace hide namespace yes/no no Show the namespace title in the marker info window
template - text no A template to use to format the info window contents.
userparam - text empty A value passed into each template call, if a template is used
activeicon - text empty Icon to be displayed instead of default marker, when active page is equal to query result
pagelabel - yes/no no When set to "yes", all markers will have an "inlineLabel" with a link to the page containing the coordinates for the marker
ajaxcoordproperty - text empty Name of the coordinate property which is used to build the ajax query.
ajaxquery - text empty A second query that is sent via ajax to fetch additional coordinates.

Parameter examples[edit | edit source]

Marker clustering[edit | edit source]

{{#ask: [[Category:Cities]]
 | format=googlemaps
 | ?Coordinates
 | cluster=on
 | zoom=4
Loading map...

Template (simple)[edit | edit source]

Adding a link to by using a template. See template "Google Maps Link".

{{#ask: [[Category:Cities]]
 | format=googlemaps
 | ?Coordinates
 | template=Google Maps Link
Loading map...

Template (advanced)[edit | edit source]

This example shows usage of multiple queried values via the "City Popup" template.

 | format=googlemaps
 | ?Coordinates
 | ?Located in
 | ?Population
 | ?Surface area
 | template=City Popup
 | showtitle=off
Loading map...