Maps

From Mapping on MediaWiki

Jump to: navigation, search
Crystal Clear action run.png
Maps

Release status: stable

MapsLogo.png
Description Allows users to display maps and coordinate data using multiple mapping services.
Author(s) Jeroen De Dauw and others
Last Version 0.6.6 (2010-08-26)
MediaWiki 1.15.* or higher
License GPL
Download Latest version

Maps is the MediaWiki extension that provides the ability to dynamically visualize geographic data in your wiki pages!

For usage, see Help:Maps.

Maps uses dynamic, JavaScript based, mapping API's such as Google Maps and OpenLayers. It has build in support for geocoding, displaying maps, displaying markers, adding pop-ups, and more. Maps allows extensive customization of your maps, either per map, or via a general setting affecting all maps on your wiki.

Due to Maps modular build, modifying the mapping service of a map is as easy as changing a single map property! These mapping services include Google Maps, Yahoo! Maps, OpenLayers and OpenStreetMap. These allow you to display maps with Google Earth, Bing maps, OpenStreetMaps, and others.

Semantic Maps is an extension built on top of maps, and adds semantic capabilities to it. When using Semantic MediaWiki, it is highly recommended to use Semantic Maps together with maps, since it will make coordinate insertion even easier.

Both Maps and Semantic Maps are partly based on Semantic Google Maps and Semantic Layers, and are meant to replace those extensions. Maps contains all functionality of Google Geocoder, and so also replaces this extension.


Contents

[edit] Download

Maps 0.6.6 dependencies
Name Required Recommended Version Supported Versions
MediaWiki Yes 1.16 or above 1.15 or above, possibly older ones
Validator Yes 0.3.6 0.3.6, 0.3.5, 0.3.4, 0.3.3, 0.3.2, 0.3.1

You can find older version in the legacy downloads section of the version history page.

[edit] Subversion downloads

You can also download the code directly via SVN from the MediaWiki source code repository, at http://svn.wikimedia.org/svnroot/mediawiki/tags/extensions/Maps/REL_0_6_6/. From a command line, you can call the following:

svn checkout http://svn.wikimedia.org/svnroot/mediawiki/tags/extensions/Maps/REL_0_6_6/

To get the latest changes, you can download the code directly from the trunk.

svn checkout http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/Maps

Note that this is discouraged when stability is a big concern.

To update a branch, use:

svn switch http://svn.wikimedia.org/svnroot/mediawiki/tags/extensions/Maps/REL_0_6_6

[edit] Package downloads

Maps and Semantic Maps

Semantic Bundle

[edit] Compatibility and dependencies

You can see the dependencies of the current release in the box on the right. For a full list of dependency tables of all releases, see the Maps dependencies category.

[edit] Installation

In order to use Maps, you need to have Validator installed. If you get a distribution from this page, you don't need to bother this, since Validator comes bundled with every release, and will automatically be loaded by Maps. If you get Maps from SVN trunk, or a tag, you must make sure you also get Validator.

Once you have downloaded the code, place the 'Maps' directory within your MediaWiki 'extensions' directory. Then add the following code to your LocalSettings.php file:

# Maps
require_once( "$IP/extensions/Maps/Maps.php" );

For using Google Maps or Yahoo! Maps, you must enter their API keys. You need to add them in LocalSettings.php, after the inclusion of Maps.

# API keys configuration
$egGoogleMapsKey = ""; # Your Google Maps API key. Required for displaying Google Maps, and using the Google Geocoder services.
$egYahooMapsKey = ""; # Your Yahoo! Maps API key. Required for displaying Yahoo! Maps.

If you don't already have them, you can obtain them at the Google Maps API page and Yahoo Maps API page. Note that the Google Maps API key is required for both displaying maps AND for geocoding (and therefore also required when you use display_address with a Yahoo! Map). Also note that use of the Google Maps API is free only if your site is accessible to the public; otherwise it costs money - read the Google Maps terms of service for further details.

Once you have successfully installed Maps, please add your wiki to the Sites that use Maps section.

[edit] Example usage

{{#display_map:New York City}}

For usage, see Help:Maps.

[edit] Version

Maps is currently at version 0.6.6 (2010-08-26). It is still be considered beta, since some small issues might be present. However, it has been tested quite thoroughly, and should not cause any big problems.

[edit] Planned features

Curious about the upcoming features in the next release? The future work page contains on overview of the planned features, and the proposals that have been turned down.

[edit] Change log

This list only contains the versions and their release dates. For a list of all changes made, view the change log section of the version history.


[edit] Supported languages

Maps has support for English, Afrikaans, Arabic, Belarusian, Bulgarian, Breton, Bosnian, Catalan, German, Lower Sorbian, Greek, Spanish, Basque, Finnish, French, Friulian, Galician, Swiss German, Hebrew, Croatian, Upper Sorbian, Hungarian, Interlingua, Indonesian, Japanese, Ripoarisch, Luxembourgish, Macedonian, Dutch, Occitan, Polish, Piedmontese, Portuguese, Brazilian Portuguese, Romanian, Tarandíne, Russian, Slovak, Swedish, Thai, Vietnamese and others.

[edit] Work for hire

The following people can be hired to set up a wiki that uses Maps and Semantic Maps, along with other MediaWiki components.

[edit] Getting support

If you have any Maps related questions, you can add them to the Talk page of the extension page on mediawiki.org. Do NOT add questions on this wiki. You can alternatively also place any questions on the MediaWiki tech mailing list, wikitech-l. If possible, add "[Maps]" at the beginning of the subject line, to clarify the subject matter. Please contact the extensions authors only directly for urgent matters. Placing your questions on the talk page will create useful references for other people with similar problems.

[edit] Supporting further development

Are you using Maps, and want to show a sign of gratitude for it's development? You can make a donation to support further development.

[edit] External links

[edit] See also

Personal tools
Namespaces
Variants
Actions
Navigation
manuals
services
extensions
data
Toolbox