Semantic Maps

From Mapping on MediaWiki
(Redirected from Semantic Maps/Version history)

This is the approved revision of this page, as well as being the most recent.
Jump to: navigation, search
Semantic Maps

Release status: stable

SemanticMaps.png
Description Allows users to edit and display semantic 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 greater
License GPL v3+
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.

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.

Help

For usage, see Help:Semantic Maps.

Download

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.

Installation

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.

Version

Semantic Maps displaying the result of a compound query with Google Maps.

Semantic Maps is currently at version 1.0.5, released on 30 November 2011. 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.

Roadmap

For a list of planned features and ideas, 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.

  • Semantic Maps 0.6 (2010-05-31)
    • Semantic Maps 0.6.1 (2010-06-04)
    • Semantic Maps 0.6.2 (2010-06-07)
    • Semantic Maps 0.6.3 (2010-06-20)
    • Semantic Maps 0.6.4 (2010-07-08)
    • Semantic Maps 0.6.5 (2010-07-27)
    • Semantic Maps 0.6.6 (2010-08-26)
  • Semantic Maps 0.5 (2009-12-17)
    • Semantic Maps 0.5.1 (2009-12-25)
    • Semantic Maps 0.5.2 (2010-01-20)
    • Semantic Maps 0.5.3 (2010-02-01)
    • Semantic Maps 0.5.4 (2010-03-01)
    • Semantic Maps 0.5.5 (2010-03-20)
  • Semantic Maps 0.4 (2009-11-03)
    • Semantic Maps 0.4.1 (2009-11-10)
    • Semantic Maps 0.4.2 (2009-11-15)
  • Semantic Maps 0.3 (2009-08-14)
    • Semantic Maps 0.3.1 (2009-08-18)
    • Semantic Maps 0.3.2 (2009-08-18)
    • Semantic Maps 0.3.3 (2009-08-25)
    • Semantic Maps 0.3.4 (2009-09-12)
  • Semantic Maps 0.2 (2009-07-29)
    • Version 0.2.1 (2009-07-30)
    • Version 0.2.2 (2009-08-01)
  • Semantic Maps 0.1 (2009-07-21)

Languages supported

Semantic Maps has support for over 55 languages, including English, Afrikaans, Gheg Albanian, Arabic, Egyptian Spoken Arabic, Belarusian, Breton, Bosnian, Catalan, German, Lower Sorbian, Greek, Esperanto, Spanish, Basque, Finnish, French, Franco-Provençal, Galician, Swiss German, Hebrew, Croatian, Upper Sorbian, Hungarian, Interlingua, Indonesian, Italian, Japanese, Khmer, Colognian, Luxembourgish, Macedonian, Dutch, Norwegian Nynorsk, Norwegian, Occitan, Polish, Piedmontese, Pashto, Portuguese, Brazilian Portuguese, Romanian, Tarandíne, Russian, Slovak, Serbian Cyrillic ekavian, Serbian Latin ekavian, Swedish, Telugu, Tagalog, Turkish, 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

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

Semantic Maps en 0.7