Extension:Maps

Maps is an extension that provides the ability to view and edit coordinate data, using multiple mapping services, including Google Maps, Open Layers and Yahoo Maps, and allows users to geocode address. It is based on Semantic Google Maps, Semantic Layers and Google Geocoder, and is meant to replace those extensions. For semantic usage, also install Semantic Maps, which adds semantic functionality to Maps.

Display a single point
You can display a map with a marker on it with the #display_point parser function. The following code will display a marker on the default map type (Google Maps), at the provided coordinates.

Geocoding
To make it easier to display a marker on an address, geocoding functionality is included in Maps. You can geocode an address with the #geocode parser function. The underneath code will return the coordinates of Moscow.

This can be easily nested in the #display_point parser function, like demonstrated below.

To avoid this nesting, another parser function, #display_address, is also available. This parser function is completely identical to #display_point, except for the parameter address, which replaces coordinates, and automatically does the geocoding for you. This code is completely synonymous to the previous example.

Map services
Maps provides multiple mapping services. The map service for a certain map can be set with the  parameter. The underneath list contains the available mapping services. When no service (or an invalid one) is provided, the Google Maps service will be used
 * or  - Google Maps service.
 * or  - Yahoo Maps service.
 * or  - Open Layers service.

Map properties
Both the #display_point and #display_address parser functions accept the following list of map properties, which can be altered to change the appearance and usage of the resulting map. Note that these are only the parameters that are valid for every mapping service.
 * - the width of the map, in pixels; defaults to 600.
 * - the height of the map, in pixels; defaults to 350.
 * - the coordinates at the center of the map; defaults to the center of the current set of points.
 * - the zoom level of the map; should be an integer greater than equal to 1 (a value of 1 shows the whole world, and for most areas, the maximum zoom is around 18). Defaults to whatever the closest zoom is that shows all the points selected.
 * - can be either normal, satellite, hybrid or physical (Google Maps only). When not set, the default, normal, will be used.
 * - this property determines how the user can pan and zoom the map, and has different values for each service.
 * - the name of a local image file to use, in place of the default icon, to mark points.
 * - can be either on (default) or off. Determines whether scroll wheel zoom is enabled.

Example of a Yahoo! Map:

Version
No version have been released so far. A stable release can be expected before the end of August 2009.

Bugs and feature requests
If you have bug reports or requests, please either send them to Jeroen De Dauw, jeroendedauw -at- gmail.com, and Yaron Koren, at yaron57 -at- gmail.com, or add them to the Talk page.