Release status: stable
|Description||Allows users to edit and display semantic coordinate data using multiple mapping services.|
|Author(s)||Jeroen De Dauw and others|
|Last Version||0.6.6 (2010-8-26)|
|MediaWiki||1.15.* or greater|
Semantic Maps is an extension that adds semantic capabilities to the Maps extension. This includes the ability to add, edit, aggregate and visualize coordinate data stored through the Semantic MediaWiki extension.
For usage, see Help:Semantic Maps.
Since Semantic Maps uses the Maps API, you can use multiple mapping services. These include Google Maps (with Google Earth support), Yahoo! Maps, OpenLayers and OpenStreetMap.
Both Semantic Maps and Maps are based on Semantic Google Maps and Semantic Layers, and are meant to replace these extensions. Having Semantic MediaWiki and Maps installed is a prerequisite for the Semantic Maps extension; the code will not work without it.
Semantic Maps and Maps provide a map interface Semantic MediaWiki, through the following features:
- Display of coordinates.
- Semantic handling of coordinates. Semantic Maps adds a Geographic coordinates data type to Semantic MediaWiki.
- Aggregation of coordinates. Each mapping service has it's own special output format, that can be used in Semantic MediaWiki queries, allowing a set of coordinate data stored on multiple pages to be displayed together on a single map.
- Insertion of coordinates. Semantic Maps provides custom Semantic Forms input types. These input types display a map with a geocoder in a form to make the insertion (and editing) of coordinates easy for users.
|Name||Required||Recommended Version||Supported Versions|
|MediaWiki||Yes||1.18 or above||1.17 or above|
|Maps||Yes||1.0.5||1.0.5, 1.0.4, 1.0.3, 1.0.2|
|Validator||Yes||0.4.13||0.4.x later then 0.4.10|
|Semantic MediaWiki||Yes||1.7||1.7 or above|
|Semantic Forms||No||2.3 or above||1.9 or above, possibly older ones|
|Download Semantic 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.
You can also download the code directly via SVN from the MediaWiki source code repository, at http://svn.wikimedia.org/svnroot/mediawiki/tags/extensions/SemanticMaps/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/SemanticMaps
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/SemanticMaps0.7.x
Note that this is discouraged when stability is a big concern.
To update a branch, use:
- Semantic Bundle is a pre-packaged bundle of extensions for use with wikis that are based around the Semantic MediaWiki extension.
Compatibility and dependencies
Notice: Semantic Maps and Maps are always released together. This means you should always use the same version of Maps as the one of Semantic Maps you have. For example Maps 0.3.4 and Semantic Maps 0.3.4, but not Maps 0.2 and Semantic Maps 0.3.
For a full list of dependency tables of all releases, see the Semantic Maps dependencies category.
Make sure you have Semantic MediaWiki, Maps and Validator successfully installed before proceeding with the installation. Once you have downloaded the code, place the 'SemanticMaps' directory within your MediaWiki 'extensions' directory. Then add the following code to your LocalSettings.php file after the lines that install Maps:
require_once( "$IP/extensions/SemanticMaps/SemanticMaps.php" );
The placement of the inclusion of Maps and Semantic Maps needs to be at a certain position. Hold the following rules into account:
- Maps needs to be included before Semantic Maps.
- Semantic MediaWiki needs to be included before Maps.
- Semantic Forms (if used) needs to be included before Maps (after SMW).
An example of a typical inclusion order: ..., SMW, ..., SF, ..., Maps, SM, ...
Once you have successfully installed Semantic Maps, please add your wiki to the sites that use Semantic Maps section on mediawiki.org.
This applies only to people installing version 0.7.x. It does not apply for those installing 1.0 or later.
Once You installed Semantic Maps, go to Special:SMWAdmin and run "database installation and upgrade". Skipping this step will result in database errors on pages with geographical coordinates and other functionality that interacts with the storage of geographical coordinates.
Upgrading from 0.5.x or older
Make sure you have the latest version of Semantic MediaWiki when installing Semantic Maps 1.0 or later. If you are installing Semantic Maps 0.7.x, get Semantic MediaWiki 1.5.6.
When upgrading from any of these versions, you need to run the "database installation and upgrade" script in Special:SMWAdmin. Not doing this will result into fatal PHP errors. You will also need to run the "data repair and upgrade" script on the same page, which is required in order to store all coordinates so that Semantic Maps recognizes them. Not doing this will result into queries not returning any coordinates.
Upgrading from Semantic Google Maps
If you have Semantic Google Maps installed, and want to upgrade to Semantic Maps, these are the steps you need to follow:
- Remove the SemanticGoogleMaps directory from your extension directory.
- Remove (when you use it) Google Geocoder in a similar fashion.
- Upload both Maps and Semantic Maps to your extension directory.
- Make sure your API keys are in the right place (the variable $wgGoogleMapsKey will need to be renamed, or copied, to $egGoogleMapsKey).
- Change all #semantic_google_map parser functions with #display_point.
- Add parameter names to the value of the #display_point calls.
After doing all these steps, you should be done. Maps and Semantic Maps are designed to be backward compatible with SGM, so all SGM code should work on Semantic Maps. If you encounter some problem though, please let the extension developers know.
Semantic Maps is currently at version 0.6.6 (2010-08-26). It is still considered beta, since some small issues might be present. However, it has been tested quite thoroughly, and should not cause any big problems.
Semantic Maps is currently at version 1.0.5, released on 30 November 2011. 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 page.
- Version 0.6 (2010-05-31)
- Version 0.5 (2009-12-17)
- Version 0.3 (2009-08-14)
- Version 0.2 (2009-07-29)
- Version 0.2.1 (2009-07-30)
- Version 0.2.2 (2009-08-01)
- Version 0.1 (2009-07-21)
Semantic Maps has support for English, Afrikaans, Arabic, Egyptian Spoken Arabic, Belarusian, Breton, Bosnian, Catalan, German, Lower Sorbian, Greek, Esperanto, Spanish, Basque, Finnish, French, Galician, Swiss German, Hebrew, Upper Sorbian, Hungarian, Interlingua, Indonesian, Italian, Japanese, Khmer, Ripoarisch, Luxembourgish, Macedonian, Dutch, Norwegian Nynorsk, Norwegian, Occitan, Polish, Piedmontese, Portuguese, Brazilian Portuguese, Romanian, Tarandíne, Russian, Slovak, Serbian Cyrillic ekavian, Serbian Latin ekavian, Swedish, Telugu, Tagalog, Veps, Vietnamese, Volapük, Simplified Chinese, Traditional 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 Semantic Maps related questions, you can add them to the Semantic Maps talk page. You can alternatively also place any questions on the Semantic MediaWiki mailing list, semediawiki-user. If possible, add "[SM]" 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 Semantic Maps, and want to show a sign of gratitude for it's development? You can make a donation to support further development.