This is the approved revision of this page, as well as being the most recent.
Release status: stable
|Description||Allows users to display maps and coordinate data using multiple mapping services.|
|Author(s)||Jeroen De Dauw and others|
|Last Version||1.0.5 (2011-11-30)|
|MediaWiki||1.15.* or higher|
Maps is the MediaWiki extension that provides the ability to dynamically visualize geographic data in your wiki pages and handle geographical data! This page contains information about the extension; see the user manual for more info on how to use it.
- 1 Description
- 2 Download
- 3 Installation
- 4 Version
- 5 Supported languages
- 6 Work for hire
- 7 Getting support
- 8 Supporting further development
- 9 External links
- 10 See also
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.
Maps parser hooks
|Parser hook||Description||Minimum version||Maximum version||Parser function available||Tag extension available|
|Coordinates||Formats coordinates||0.6||still supported||Yes||Yes|
|Display line||Map display with one or more markers and lines||1.1||1.1||Yes||Yes|
|Display map||Simple map display without markers||0.5||still supported||Yes||Yes|
|Display points||Map display with one or more markers||0.1||1.1||Yes||Yes|
|Distance||Distance conversion||0.6.2||still supported||Yes||Yes|
|Finddestination||Finds the destination given a starting point, initial bearing and a distance||0.6||still supported||Yes||Yes|
|Geocode||Converts addresses to coordinates||0.1||still supported||Yes||Yes|
|Geodistance||Calculates the distance between two points||0.6||still supported||Yes||Yes|
|Name||Required||Recommended Version||Supported Versions|
|MediaWiki||Yes||1.18 or above||1.17 or above|
|Validator||Yes||0.4.13||0.4.x later then 0.4.10|
For a complete list of downloads, including obsolete and experimental releases, go to the Google code download page. If you have MediaWiki 1.17 or above, simply get the latest version. If you are using MediaWiki 1.15.x or 1.16.x, get the latest 0.7.x release.
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_1_0_5. From a command line, you can call the following:
To get the latest changes, you can download the code directly from the trunk. Note that trunk requires MediaWiki 1.17 or above.
svn checkout http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/Maps
For MediaWiki 1.15.x and 1.16.x installs, you can get the latest Maps 0.7.x code from this branch:
svn checkout http://svn.wikimedia.org/svnroot/mediawiki/branches/Maps0.7.x
Note that this is discouraged when stability is a big concern.
To update a branch, use:
- Semantic Maps always comes bundled with a compatible version of Maps.
- Semantic Bundle is a pre-packaged bundle of extensions for use with wikis that are based around the Semantic MediaWiki extension.
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.
In order to use Maps, you need to have Extension:Validator installed.
But if you get a distribution from this page, you do not need to bother with 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 install 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:
require_once( "$IP/extensions/Validator/Validator.php" ); # Validator must be included *before* Maps. require_once( "$IP/extensions/Maps/Maps.php" ); # Maps
Once you have successfully installed Maps, please add your wiki to the Sites that use Maps section.
Maps is currently at version 1.0.5, released on 30 November 2011. 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.
For a list of planned features and idea's, see the roadmap.
This list contains all releases of Maps. For a lift of the release notes, see the release notes file on svn.
- Maps 0.7 (2010-10-15)
- Maps 0.6 (2010-05-31)
- Maps 0.6.1 (2010-06-04)
- Maps 0.6.2 (2010-06-07)
- Maps 0.6.3 (2010-06-20)
- Maps 0.6.4 (2010-07-08)
- Maps 0.6.5 (2010-07-27)
- Maps 0.6.6 (2010-08-26)
- Maps 0.5 (2009-12-17)
- Maps 0.5.1 (2009-12-25)
- Maps 0.5.2 (2010-01-20)
- Maps 0.5.3 (2010-02-01)
- Maps 0.5.4 (2010-03-01)
- Maps 0.5.5 (2010-03-20)
- Maps 0.4 (2009-11-03)
- Maps 0.4.1 (2009-11-10)
- Maps 0.4.2 (2009-11-15)
- Maps 0.3 (2009-08-14)
- Maps 0.3.1 (2009-08-18)
- Maps 0.3.2 (2009-08-18)
- Maps 0.3.3 (2009-08-25)
- Maps 0.3.4 (2009-09-12)
- Maps 0.2 (2009-07-29)
- Maps 0.2.1 (2009-07-30)
- Maps 0.2.2 (2009-08-01)
- Maps 0.1 (2009-07-20)
Maps has support for over 85 languages, including English, Afrikaans, Gheg Albanian, Arabic, Aramaic, Egyptian Spoken Arabic, Belarusian, Bulgarian, Bahasa Banjar, Breton, Bosnian, Catalan, Chechen, Czech, German, German, Lower Sorbian, Greek, British English, Esperanto, Spanish, Estonian, Basque, Finnish, French, Franco-Provençal, Friulian, Galician, Ancient Greek, Swiss German, Hebrew, Hindi, Croatian, Upper Sorbian, Haitian, Hungarian, Interlingua, Indonesian, Igbo, Italian, Japanese, Javanese, Georgian, Khmer, Kannada, Colognian, Ladino, Luxembourgish, Lithuanian, Macedonian, Malayalam, Marathi, Erzya, Nahuatl, Dutch, Norwegian Nynorsk, Norwegian, Occitan, Deitsch, Polish, Piedmontese, Pashto, Portuguese, Brazilian Portuguese, Romanian, Tarandíne, Russian, Rusyn, Sinhala, Slovak, Serbian Cyrillic ekavian, Serbian Latin ekavian, Swedish, Telugu, Thai, Tagalog, Turkish, Tatar, Ukrainian, Veps, Vietnamese, Volapük, Chinese, Simplified Chinese, Traditional Chinese, Chinese and others.
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.
- Jeroen De Dauw - You can also hire me to develop new features for Maps or it's extensions, or do optimizations for your specific needs. Just send me an email.
If you have any Maps related questions, you can add them to the Maps talk page. 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.
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.
- Extension page on mediawiki.org
- Blog posts of the author about Maps
- Maps display_map screencast
- Maps display_point screencast
- Powerpoint presentation about MediaWiki, SMW, Maps and Semantic Maps 0.5.3 used at a presentation in Gent, February 2010.
Maps en 0.7