Difference between revisions of "Maps"

From Mapping on MediaWiki
Jump to: navigation, search
 
(82 intermediate revisions by 15 users not shown)
Line 1: Line 1:
{{extension
+
{{Extension
 
| name        = Maps  
 
| name        = Maps  
| status      = beta
+
| status      = stable
| type        = pfunc
+
| author      = [[User:Jeroen_De_Dauw|Jeroen De Dauw]] and [http://www.ohloh.net/p/maps/contributors others]
| hook1      = LanguageGetMagic
+
| hook2      = AdminLinks
+
| author      = [[User:Jeroen_De_Dauw|Jeroen De Dauw]], [[User:Yaron Koren|Yaron Koren]] and others
+
 
| image      = MapsLogo.png
 
| image      = MapsLogo.png
| version    = {{Maps version}}
+
| version    = 1.0.5
 +
| update      = 2011-11-30
 
| mediawiki  = 1.15.* or higher
 
| mediawiki  = 1.15.* or higher
| license    = GPL
+
| license    = GPL v3+
| download    = [http://mwmaps.googlecode.com/files/Maps0.5.5.zip Maps0.5.5.zip]
+
| download    = [[#Download|Latest version]]
| description = Allows users to display maps and coordinate data using multiple mapping services.
+
| description = Allows users to display maps and coordinate data using multiple [[mapping services]].
 
}}
 
}}
'''Maps''' is the MediaWiki extension that provides the ability to visualize geographic data with dynamic, JavaScript based, mapping API's such as Google Maps and OpenLayers in your wiki pages. 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 also allow you to display maps with Google Earth, OpenStreetMaps, Bing maps and others. Examples of how to use Maps can be found [http://wiki.bn2vs.com/wiki/Maps here].
+
'''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.
  
[[Extension:Semantic Maps|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.
+
== Description ==
  
Both Maps and Semantic Maps are partly based on [[Extension:Semantic Google Maps|Semantic Google Maps]] and [[Extension:Semantic Layers|Semantic Layers]], and are meant to replace those extensions. Maps contains all functionality of [[Extension:Google Geocoder|Google Geocoder]], and so also replaces this extension.
+
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.  
  
__TOC__
+
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.
{{Maps Extension Navigation}}
+
  
{{Languages}}
+
[[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.
  
== Setup ==
+
Both Maps and Semantic Maps are partly based on [http://www.mediawiki.org/wiki/Extension:Semantic_Google_Maps Semantic Google Maps] and [http://www.mediawiki.org/wiki/Extension:Semantic_Layers Semantic Layers], and are meant to replace those extensions. Maps contains all functionality of [http://www.mediawiki.org/wiki/Extension:Google_Geocoder Google Geocoder], and so also replaces this extension.
  
===Download===
+
=== Maps parser hooks ===
  
{{Maps RC}}
+
{{Parser hooks header}}
 +
{{
 +
#Ask: [[Category:Parser hooks]] [[Category:Maps documentation]] [[Is master page::true]]
 +
| format=template
 +
| template=Parser hook row
 +
| ?Has description
 +
| ?Has minimum version
 +
| ?Has maximum version
 +
| ?Has parser function
 +
| ?Has tag extension
 +
}}
 +
|}
  
{{Maps 0.5.5 dependencies|right}}
+
== Download ==
  
* [http://mwmaps.googlecode.com/files/Maps0.5.5.zip Maps0.5.4.zip] 375 KB
+
{{Maps download}}
* [http://mwmaps.googlecode.com/files/Maps0.5.5.7z Maps0.5.4.7z] 241 KB
+
  
You can find older version in the [[/Version_history#Legacy_downloads|legacy downloads]] section of the [[/Version_history|version history page]].
+
== Installation ==
  
====Subversion downloads====
+
{{Maps installation}}
  
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_5_5/. From a command line, you can call the following:
+
== Version ==
  
svn checkout <nowiki>http://svn.wikimedia.org/svnroot/mediawiki/tags/extensions/Maps/REL_0_5_5/</nowiki>
+
Maps is currently at version {{#show: {{PAGENAME}} | ?Has version }}, released on {{#show: {{PAGENAME}} | ?Has update }}. 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.
  
To get the latest changes, you can download the code directly from the trunk. Note that this is discouraged when stability is a big concern.
+
=== Roadmap ===
  
====Package downloads====
+
For a list of planned features and idea's, see the [[roadmap]].
  
{{Maps and SM}}
+
=== Version history ===
  
'''Semantic Bundle'''
+
This list contains all releases of Maps. For a lift of the release notes, see the [http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/Maps/RELEASE-NOTES?view=co release notes file on svn].
  
{{SB Extension|version=0.5.5|download=true}}
+
* '''[[Maps 1.0]]''' (2011-07-19)
 +
** '''[[Maps 1.0.1]]''' (2011-08-17)
 +
** '''[[Maps 1.0.2]]''' (2011-08-24)
 +
** '''[[Maps 1.0.3]]''' (2011-09-14)
  
=== Installation ===
+
* '''[[Maps 0.7]]''' (2010-10-15)
 +
** [[Maps 0.7.1]] (2010-10-20)
 +
** [[Maps 0.7.2]] (2010-10-28)
 +
** [[Maps 0.7.3]] (2010-11-30)
 +
** [[Maps 0.7.4]] (2011-01-20)
 +
** [[Maps 0.7.5]] (2011-02-16)
 +
** [[Maps 0.7.6]] (2011-03-21)
 +
** [[Maps 0.7.7]] (2011-06-15)
  
In order to use Maps, you need to have [[Extension:Validator|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 [[Extension:Validator#Download|get Validator]].
+
* '''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)
  
Once you have downloaded the code, place the 'Maps' directory within your MediaWiki 'extensions' directory. Then add the following code to your [[Manual:LocalSettings.php|LocalSettings.php]] file:
+
* '''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)
  
<source lang="php">
+
* '''Maps 0.4''' (2009-11-03)
# Maps
+
** Maps 0.4.1 (2009-11-10)
require_once( "$IP/extensions/Maps/Maps.php" );
+
** Maps 0.4.2 (2009-11-15)
</source>
+
  
For using [[/Google|Google Maps]] or [[/Yahoo|Yahoo! Maps]], you must enter their API keys. You need to add them in [[Manual:LocalSettings.php|LocalSettings.php]], '''after''' the inclusion of Maps.  
+
* '''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)
  
<source lang="php">
+
* '''Maps 0.2''' (2009-07-29)
# API keys configuration
+
** Maps 0.2.1 (2009-07-30)
$egGoogleMapsKey = ""; # Your Google Maps API key. Required for displaying Google Maps, and using the Google Geocoder services.
+
** Maps 0.2.2 (2009-08-01)
$egYahooMapsKey = ""; # Your Yahoo! Maps API key. Required for displaying Yahoo! Maps.
+
</source>
+
  
If you don't already have them, you can obtain them at the [http://code.google.com/apis/maps/signup.html Google Maps API page] and [https://developer.yahoo.com/wsregapp/ 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 [http://code.google.com/apis/maps/terms.html Google Maps terms of service] for further details.
+
* '''Maps 0.1''' (2009-07-20)
  
Once you have successfully installed Maps, please add your wiki to the [[#Sites_that_use_Maps|Sites that use Maps]] section.
 
  
==Version==
+
{{#widget:Ohloh Project|id=maps|type=basic_stats}}
Maps is currently at version {{Maps version}}. 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. Since this is the second minor update to 0.4.0, it's pretty stable.
+
 
+
===Planned features===
+
Curious about the upcoming features in the next release? The [[/Future|future work page]] contains on overview of the [[/Future#Accepted_to-do.27s|planned features]], and the proposals that have been [[/Future#Turned_down_proposals|turned down]].
+
 
+
===Change log===
+
 
+
This list only contains the versions and their release dates. For a list of all changes made, view the [[/Version_history#Maps_change_log|change log]] section of the [[/Version_history|version history]].
+
 
+
* '''[[/Version_history#Maps_0.5|Version 0.5]]''' (2009-12-17)
+
** [[/Version_history#Maps_0.5.1|Version 0.5.1]] (2009-12-25)
+
** [[/Version_history#Maps_0.5.2|Version 0.5.2]] (2010-01-20)
+
** [[/Version_history#Maps_0.5.3|Version 0.5.3]] (2010-02-01)
+
** [[/Version_history#Maps_0.5.4|Version 0.5.4]] (2010-03-01)
+
** [[/Version_history#Maps_0.5.5|Version 0.5.5]] (2010-03-20)
+
 
+
* '''[[/Version_history#Maps_0.4|Version 0.4]]''' (2009-11-03)
+
** [[/Version_history#Maps_0.4.1|Version 0.4.1]] (2009-11-10)
+
** [[/Version_history#Maps_0.4.2|Version 0.4.2]] (2009-11-15)
+
 
+
* '''[[/Version_history#Maps_0.3|Version 0.3]]''' (2009-08-14)
+
** [[/Version_history#Maps_0.3.1|Version 0.3.1]] (2009-08-18)
+
** Version 0.3.2 (2009-08-18)
+
** [[/Version_history#Maps_0.3.3|Version 0.3.3]] (2009-08-25)
+
** [[/Version_history#Maps_0.3.4|Version 0.3.4]] (2009-09-12)
+
 
+
* '''[[/Version_history#Maps_0.2|Version 0.2]]''' (2009-07-29)
+
** Version 0.2.1 (2009-07-30)
+
** Version 0.2.2 (2009-08-01)
+
 
+
* '''[[/Version_history#Maps_0.1|Version 0.1]]''' (2009-07-20)
+
  
 
== Supported languages ==
 
== 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.
+
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.
 
+
==Settings==
+
Maps allows you to configure a variety of settings, and so affect how the extension works. All settings are located in '''Maps_Settings.php''', in the root of the extension. You can modify a setting by copying its code and placing it with the adapted value in [[Manual:LocalSettings.php|LocalSettings.php]], '''after''' the inclusion of Maps. Here you have a list of the common settings (the ones that affect all mapping services). For the specific settings, see the [[#Map_services|map services]]. Note that the settings file is documented, and should provide you with sufficient information to understand the working of all settings.
+
 
+
=== Available mapping services ===
+
 
+
Array containing all the services that will be made available to the user.
+
 
+
Default: <code>$egMapsAvailableServices = array('googlemaps', 'yahoomaps', 'openlayers', 'osm');</code>
+
 
+
When not using a service, you might consider removing it's inclusion.
+
 
+
<source lang="php">
+
include_once $egMapsIP . '/GoogleMaps/Maps_GoogleMaps.php';    // Google Maps
+
include_once $egMapsIP . '/OpenLayers/Maps_OpenLayers.php';    // OpenLayers
+
include_once $egMapsIP . '/YahooMaps/Maps_YahooMaps.php';      // Yahoo! Maps
+
include_once $egMapsIP . '/OpenStreetMap/Maps_OSM.php';        // OpenLayers optimized for OSM
+
</source>
+
 
+
Doing this will cause Maps to completely ignore it, and so improve performance.
+
 
+
===Default mapping service===
+
The default mapping service for each feature, which will be used when no valid service is provided by the user. This service needs to be enabled, if not, the first one from [[#Available_mapping_services|the available services]] will be taken. Note: The default service needs to be available for the feature you set it for, since it's used as a fall-back mechanism.
+
 
+
Default: <code>$egMapsDefaultServices = array('pf' => 'googlemaps');</code>
+
 
+
This list contains all available features, and their feature code, which should be used as name in the $egMapsDefaultServices array.
+
* pf - parser functions - This default will be used for all display_ parser functions.
+
 
+
An additional fall-back value is present, that will be used in case no default is specified for a certain feature. This service needs to be enabled, if not, the first one from the available services will be taken.
+
 
+
Default: <code>$egMapsDefaultService = 'googlemaps';</code>
+
 
+
===Available mapping features===
+
 
+
Array containing all the mapping features that will be made available to the user.
+
 
+
Default:
+
 
+
<source lang="php">
+
$egMapsAvailableFeatures['geocode'] = array(
+
                            'name' => 'Geocoding',
+
                            'class' => 'Geocoders',
+
                            'file' => 'Geocoders/Maps_Geocoders.php',
+
                            'local' => true,
+
                            );
+
 
+
$egMapsAvailableFeatures['pf'] = array(
+
                            'name' => 'Parser Functions',
+
                            'class' => 'MapsParserFunctions',
+
                            'file' => 'ParserFunctions/Maps_ParserFunctions.php',
+
                            'local' => true,
+
                            );
+
</source>
+
 
+
Removing an element will cause the corresponding feature to be unavailable.
+
 
+
===Available geocoding services===
+
 
+
Array containing all the geocoding services that will be made available to the user. The allowed values are 'yahoo', 'google' and 'geonames'.
+
 
+
===Default geocoding service===
+
The default geocoding service, which will be used when no service is provided by the user. This service needs to be enabled, if not, the first one from [[#Available_geocoding_services|the available geocoding services]] will be taken.
+
 
+
Default: <code>$egMapsDefaultGeoService = 'geonames';</code>
+
 
+
===Default map coordinates===
+
The default coordinates of the marker. This value will only be used when the user does not provide one.
+
 
+
Default: <code>$egMapsMapLat = '1'; $egMapsMapLon = '1';</code>
+
 
+
===Default map width===
+
The default width of a map. These values will only be used when the user does not provide them.
+
 
+
Default: <code>$egMapsMapWidth = 600;</code>
+
 
+
===Default map height===
+
The default height of a map. These values will only be used when the user does not provide them.
+
 
+
Default: <code>$egMapsMapHeight = 350;</code>
+
 
+
=== Map size restrictions ===
+
 
+
The minimum and maximum width and height for all maps. First min, then max. Min needs to be smaller then max. When the height or width exceed their limits, they will be changed to the closest allowed value.
+
 
+
Default:
+
<source lang="php">
+
$egMapsSizeRestrictions = array(
+
'width'  => array( 100, 1000 ),
+
'height' => array( 100, 1000 ),
+
);
+
</source>
+
 
+
===Default map zoom===
+
 
+
The default zoom of a map. This value will only be used when the user does not provide one. Each service has it's own zoom setting. Please refer to the [[#Map_services|mapping services]] for more info.
+
 
+
=== Default map title ===
+
 
+
The default title for all markers. If set, it will be visible as text or title in a pop-up when the user clicks a marker.
+
 
+
Default: <code>$egMapsDefaultTitle = <nowiki>''</nowiki>;</code>
+
 
+
=== Default map label ===
+
 
+
The default label for all markers. If set, it will be visible as text in a pop-up when the user clicks a marker.
+
 
+
Default: <code>$egMapsDefaultLabel = <nowiki>''</nowiki>;</code>
+
 
+
== Contributing to the project ==
+
 
+
=== Supporting further development ===
+
 
+
Are you using Maps, and want to show a sign of gratitude? You can [https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=K8YM95XBUQ7R6&lc=BE&item_name=Development%20of%20Maps%20and%20Semantic%20Maps&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donate_LG%2egif%3aNonHosted make a donation] to support further development.
+
 
+
=== Extending Maps ===
+
 
+
Maps has been designed to be very extendible. It has several hooks that enable you to add support for new mapping services, geocoding services or entirely new features (such as parser functions) to it without having to change anything to the code of Maps. This enables you to add things to Maps in your own extension, or simply create a new extension to Maps. [[Extension:Semantic Maps|Semantic Maps]] is an example of an extension to Maps.
+
 
+
There are multiple important reasons why you should consider creating an extension to Maps, versus creating your own mapping extension. These include:
+
 
+
* Maps provides the scaffolding for most mapping functionality. If you want to add a new parser function, it'll have support for, amongst other things, geocoding and coordinate parsing without you having to ever bother these things. This reduces the amount of work you have, decreases the chances of bugs and code redundancy, and ensures the conventions toward the users.
+
 
+
* Installing one extension (possibly bundled with 3rd party mapping service implementations) is far easier then installing half a dozen for an end user. It also solves issues with incompatibility between multiple mapping services, which can cause extensions to break.
+
 
+
* Since Maps is the only mapping extension for MediaWiki that handles a true mapping service independent platform, and cause of that provides multiple mapping services and a variety of both common and specific features, users are far more likely to choose Maps, and it's extensions, instead of multiple individual extensions.
+
 
+
==== How to extend Maps ====
+
 
+
You can learn how to create your own extension for Maps by looking at the source code and doing some experimenting, or you can [[/Extending_Maps#Introduction|read the manual]], that goes through all the required steps.
+
 
+
=== Bugs, patches and new features ===
+
 
+
If you found some bug and fixed it, please create a patch by going to the "Maps" directory, and typing:
+
 
+
svn diff >descriptivename.patch
+
 
+
Then add the patch to the [[/Future#Bugs|bugs section]] of the [[/Future|future work page]]. Bug reports should also be added here. You can also send them to Jeroen De Dauw, jeroendedauw -at- gmail.com, and Yaron Koren, at yaron57 -at- gmail.com.
+
 
+
If you created new functionality for Maps, please contact one of the developers to discuss the best way to integrate it.
+
 
+
===Feature requests ===
+
 
+
Feel free to add feature requests to the [[/Future#New_proposals|new proposals section]] of the [[/Future|future work page]].
+
 
+
=== Translating ===
+
 
+
Translation of Maps is done through [http://translatewiki.net/wiki/Main_Page translatewiki.net]. The translation for this extension can be found [http://translatewiki.net/w/?title=Special:Translate&group=ext-maps here]. To add language values or change existing ones, you should create an account on translatewiki.net, then request permission from the administrators to translate a certain language or languages on [http://translatewiki.net/wiki/Project:Translator this page] (this is a very simple process). Once you have permission for a given language, you can log in and add or edit whatever messages you want to in that language.
+
 
+
Translations for this documentation, especially the extension description, are also welcome.
+
  
 
== Work for hire ==
 
== Work for hire ==
  
The following people can be hired to set up a wiki that uses Maps and [[Extension:Semantic Maps|Semantic Maps]], along with other MediaWiki components.
+
The following people can be hired to set up a wiki that uses Maps and [[Semantic Maps]], along with other MediaWiki components.
  
 
* [[User:Jeroen_De_Dauw|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.
 
* [[User:Jeroen_De_Dauw|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.
  
 
== Getting support ==
 
== Getting support ==
If you have any Maps related questions, you can [http://www.mediawiki.org/w/index.php?title=Extension_talk:Maps&action=edit&section=new add them] to [[Extension_talk:Maps|the Talk page]]. You can alternatively also place any questions on the Semantic MediaWiki mailing list, semediawiki-user. 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.
 
  
==Sites that use Maps==
+
{{Maps support}}
  
Are you using Maps? Then be sure to add your wiki to the top of this list, and feel free to link your favourite Maps-using articles!
+
== Supporting further development ==
  
* [http://www.TansaniaLexikon.de TansaniaLexikon.de]
+
Are you using Maps, and want to show a sign of gratitude for it's development? You can [https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=K8YM95XBUQ7R6&lc=BE&item_name=Development%20of%20Maps%20and%20Semantic%20Maps&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donate_LG%2egif%3aNonHosted make a donation] to support further development.
* [http://www.deurnewiki.nl/wiki DeurneWiki: all about history of Dutch village Deurne (dutch)]
+
* [http://wiki.pmg-gabrovo.bg Природоматематическа гимназия "Акад. Иван Гюзелев"]
+
* [http://www.buccaneerchronicals.uk.to World of Arkmeda (customised Map Extension)]
+
* [http://vflashdesign.nl/ 5000+ Locations in Holland]
+
* [http://www.nycanals.com/ NY Canals]
+
* [http://venciclopedia.com/ Venciclopedia]
+
* [http://ghent.hackerspace.be Hackerspace Gent]
+
* [http://www.wittieproject.org WiTTIE]
+
* [http://en.wikiarquitectura.com/index.php?title=Main_Page WikiArquitectura]
+
* [http://hackerspace.be/ Hackerspace Brussels]
+
* [[translatewiki:|translatewiki.net]]
+
* [http://www.bluewater-info.net Bluewater Wiki]
+
* [http://www.ticopedia.de Ticopedia.de]
+
* [http://www.bougna.info Bougna Citizen Information]
+
* [http://www.childrenarewelcome.co.uk/ Children are Welcome]
+
* [http://sheltercrisis.referata.com ShelterCrisis]
+
* [http://b3ok.org/wiki/Main_Page B3OK]
+
* [http://civicstudio.org/river/ Civic Studio "On the River" project]
+
* [http://discoursedb.org/wiki Discourse DB]
+
* [http://foodfinds.referata.com Food Finds]
+
* [http://gingerwiki.com/wiki/The_price_comparison_wiki GingerWiki]
+
* [http://smw.referata.com/wiki/ Semantic MediaWiki community wiki]
+
* [http://malariapedia.info/ Malariapedia]
+
* [http://www.mow-wiki.tk/ Men of War - Wiki]
+
* [http://www.mikomos.com/ Mikomos]
+
* [http://openei.org/wiki/Main_Page OpenEnergyInfo]
+
* [http://participedia.net/wiki/Welcome_to_Participedia Participedia]
+
* [http://tlcwiki.com/ Tlcwiki]
+
* [http://www.transitunlimited.org/Main_Page Transit Unlimited]
+
* [http://wiki.bn2vs.com/wiki/Maps BN's demo wiki]
+
* [http://nederwiki.nl NederWiki]
+
* [https://www.hackerspace.lu/wiki/Calendar#Map_View syn<sub>2</sub>cat Hackerspace]
+
* [http://www.wecowi.de Web Community Wiki]
+
  
 
==External links==
 
==External links==
  
* [http://wiki.bn2vs.com/wiki/Maps Maps demo's]
+
* [http://www.mediawiki.org/wiki/Extension:Maps Extension page on mediawiki.org]
 
+
* [http://blog.bn2vs.com/tag/maps/ Blog posts of the author about Maps]
* Blog of the author about [http://blog.bn2vs.com/tag/semantic-maps/ Maps and Semantic Maps]
+
 
+
 
* [http://ext.bn2vs.com/screencasts/maps_display_map.htm Maps display_map screencast]  
 
* [http://ext.bn2vs.com/screencasts/maps_display_map.htm Maps display_map screencast]  
 
 
* [http://ext.bn2vs.com/screencasts/maps_display_point.htm Maps display_point screencast]  
 
* [http://ext.bn2vs.com/screencasts/maps_display_point.htm Maps display_point screencast]  
 
 
* [http://ext.bn2vs.com/2010_02_04_Semantic%20mapping%20with%20MediaWiki.pptx Powerpoint presentation] about MediaWiki, SMW, Maps and Semantic Maps 0.5.3 used at [http://wiki.bn2vs.com/Semantic_Mapping_with_MediaWiki a presentation] in Gent, February 2010.
 
* [http://ext.bn2vs.com/2010_02_04_Semantic%20mapping%20with%20MediaWiki.pptx Powerpoint presentation] about MediaWiki, SMW, Maps and Semantic Maps 0.5.3 used at [http://wiki.bn2vs.com/Semantic_Mapping_with_MediaWiki a presentation] in Gent, February 2010.
  
* [http://ext.bn2vs.com/SemanticMaps.zip Powerpoint presentation] about Maps and Semantic Maps 0.4 used at Semantic MediaWiki Camp 2009.
+
== See also ==
 
+
==See also==
+
 
+
* [[Extension:Semantic MediaWiki|Semantic MediaWiki]]
+
* [[Extension:Validator|Validator]]
+
* [[Semantic Bundle|Semantic Bundle]]
+
* [[Extension:Google Maps|Google Maps]] - A non-semantic Google Maps extension.
+
* [[Extension:MathFunctions|Math Functions]] - Contains the function #geodistance, which calculates the distance between two coordinates.
+
 
+
{{Maps Extension Services}}
+
  
{{Maps Extension Navigation}}
+
* [http://www.mediawiki.org/wiki/Extension:Validator Validator]
 +
* [http://www.mediawiki.org/wiki/Semantic_Bundle Semantic Bundle]
 +
* [http://www.mediawiki.org/wiki/Extension:Semantic_MediaWiki Semantic MediaWiki]
 +
* [http://www.mediawiki.org/wiki/Extension:Google_Maps Google Maps extension]
  
{{Semantic Maps Navigation}}
+
{{docu|master page=Maps|language=en|minversion=0.7}}

Latest revision as of 17:10, February 10, 2012

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 1.0.5 (2011-11-30)
MediaWiki 1.15.* or higher
License GPL v3+
Download Latest version

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.

Description

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.

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

Download

Maps 1.0.5 dependencies
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
Crystal Clear action build.png Download Maps

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.

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_1_0_5. From a command line, you can call the following:

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

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:

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

Package downloads

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.

Installation

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.

Version

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.

Roadmap

For a list of planned features and idea's, see the roadmap.

Version history

This list contains all releases of Maps. For a lift of the release notes, see the release notes file on svn.

  • 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)


Supported languages

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.

Getting support

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.

External links

See also

This documentation page applies to all (Semantic) Maps versions from 0.7 to the most current version.
Other versions: 0.1 – 0.6.6      

Maps en 0.7