Difference between revisions of "Semantic Maps"

From Mapping on MediaWiki
Jump to: navigation, search
(Change log)
Line 2: Line 2:
| name        = Semantic Maps
| name        = Semantic Maps
| status      = beta
| status      = beta
| author      = [[User:Jeroen_De_Dauw|Jeroen De Dauw]], [[User:Yaron Koren|Yaron Koren]] and [https://www.ohloh.net/p/semanticmaps/contributors others]
| author      = [[User:Jeroen_De_Dauw|Jeroen De Dauw]] and [https://www.ohloh.net/p/semanticmaps/contributors others]
| image      = SemanticMaps.png
| image      = SemanticMaps.png
| version    = {{Maps version}}
| version    = {{Maps version}}

Revision as of 17:50, July 31, 2010

Crystal Clear action run.png
Semantic Maps

Release status: beta

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-08-26)
MediaWiki 1.15.* or greater
License GPL
Download Latest version

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.

Functionality overview

Semantic Maps and Maps provide a map interface Semantic MediaWiki, through the following features:

  1. Display of coordinates.
  2. Semantic handling of coordinates. Semantic Maps adds a Geographic coordinates data type to Semantic MediaWiki.
  3. 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.
  4. 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.


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

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

svn checkout http://svn.wikimedia.org/svnroot/mediawiki/tags/extensions/SemanticMaps/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/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:

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

Package downloads

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.

Installing 0.7.x

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 displaying the result of a compound query with Google Maps.

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.

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.

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 page.

  • Version 0.2 (2009-07-29)
    • Version 0.2.1 (2009-07-30)
    • Version 0.2.2 (2009-08-01)

Languages supported

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.

Getting support

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.

External links

See also

Facts about "Semantic Maps"RDF feed
Has version0.6.6 (2010-08-26) +