Semantic Maps

Category:MediaWiki extension Semantic Maps
Extension name	Semantic Maps
About this article / disclaimer	This is not official documentation
Logo
Screenshot
Location of the main author	Gent, Belgium
Coordinates of the main authors	51.053829, 3.725012
Developers	Jeroen De Dauw, others
Licences	GPL v2+
Description	Semantic Maps is an extension to Semantic MediaWiki (SMW) that adds semantic capabilities to the Maps extension and adds the datatype Geographic coordinate.
Mediawiki requirements	1.17.* or greater. Probably 1.21 or better works best
Dependencies	Maps (MediaWiki extension), Semantic MediaWiki, ParamProcessor
Related extensions (documented here)	Semantic Forms, Semantic Forms Inputs, Semantic MediaWiki, Semantic Result Formats
Related extensions
Discussion
Language support
Status	stable
First release date	2009/07/01
Last release date (as of 2013/08/15!)	2012/12/13
Last version number	2.0.1 (2012-12-13)
Programming language	PHP
Alternatives
Website	home page
Publications
Support websites	web site, web site
Example websites
Last edited	2013/08/15

“Semantic Maps is an extension to Semantic MediaWiki (SMW) that adds semantic capabilities to the Maps extension and adds the datatype Geographic coordinate. This includes the ability to add, edit, aggregate and visualize coordinate data stored through the Semantic MediaWiki extension. It is based on the Maps extension and replaces the earlier implementations Semantic Google Maps and Semantic Layers.” Semantic Maps, retrieved Aug 2013

Basic how to

Semantic maps are based on the Maps extension. This Maps extension has two types of features:

• Display maps with markers for a coordinates using varies mapping services
• One can use Geocoding, i.e. normal addresses instead of coordinates. However, this doesn't seem to work all the time - Daniel K. Schneider (talk) 19:30, 7 January 2014 (CET)

Read more in Maps

Semantic Maps, as suggested by its name, allows to retrieve coordinates from properties.

Let's look at some data:

{{#ask: [[Category:MediaWiki extension]]
| ?Has address
| ?Has location
| format=table
}}

	Has address	Has location
Maps (MediaWiki extension)	Gent, Belgium	51° 3' 15.63" N, 3° 43' 2.73" E
Mediawiki collection extension installation	Germany	51° 5' 0.31" N, 10° 25' 24.41" E
Page Forms	New York, USA	40° 42' 45.82" N, 74° 0' 21.65" W
Semantic Drilldown	New York	40° 42' 45.99" N, 74° 0' 21.50" W
Semantic Forms Inputs	Noordwijk	52° 14' 23.96" N, 4° 27' 0.03" E
Semantic Maps	Gent, Belgium	51° 3' 15.63" N, 3° 43' 2.73" E
Semantic MediaWiki	Oxford, England	51° 45' 7.25" N, 1° 15' 28.26" W
Semantic Result Formats	Gent, Belgium	51° 3' 15.63" N, 3° 43' 2.73" E
VisualEditor	Berlin	52° 31' 1.33" N, 13° 23' 19.90" E

And produce a map from the "has location" properties

{{#ask: [[Category:MediaWiki extension]]
| ?Has location
| format=map
}}

Loading map...

{"format":"leaflet","minzoom":false,"maxzoom":false,"limit":50,"offset":0,"link":"all","sort":[""],"order":[],"headers":"show","mainlabel":"","intro":"","outro":"","searchlabel":"... further results","default":"","import-annotation":false,"width":"auto","height":"350px","centre":false,"title":"","label":"","icon":"","lines":[],"polygons":[],"circles":[],"rectangles":[],"copycoords":false,"static":false,"zoom":false,"defzoom":14,"layers":["OpenStreetMap"],"image layers":[],"overlays":[],"resizable":false,"fullscreen":false,"scrollwheelzoom":true,"cluster":false,"clustermaxzoom":20,"clusterzoomonclick":true,"clustermaxradius":80,"clusterspiderfy":true,"geojson":"","clicktarget":"","showtitle":true,"hidenamespace":true,"template":"","userparam":"","activeicon":"","pagelabel":false,"ajaxcoordproperty":"","ajaxquery":"","locations":[{"text":"\u003Cb\u003E\u003Ca href=\"/en/Maps_(MediaWiki_extension)\" title=\"Maps (MediaWiki extension)\"\u003EMaps (MediaWiki extension)\u003C/a\u003E\u003C/b\u003E","title":"Maps (MediaWiki extension)","link":"","lat":51.054341666667,"lon":3.717425,"icon":""},{"text":"\u003Cb\u003E\u003Ca href=\"/en/Mediawiki_collection_extension_installation\" title=\"Mediawiki collection extension installation\"\u003EMediawiki collection extension installation\u003C/a\u003E\u003C/b\u003E","title":"Mediawiki collection extension installation","link":"","lat":51.083419444444,"lon":10.423447222222,"icon":""},{"text":"\u003Cb\u003E\u003Ca href=\"/en/Page_Forms\" title=\"Page Forms\"\u003EPage Forms\u003C/a\u003E\u003C/b\u003E","title":"Page Forms","link":"","lat":40.712727777778,"lon":-74.006013888889,"icon":""},{"text":"\u003Cb\u003E\u003Ca href=\"/en/Semantic_Drilldown\" title=\"Semantic Drilldown\"\u003ESemantic Drilldown\u003C/a\u003E\u003C/b\u003E","title":"Semantic Drilldown","link":"","lat":40.712775,"lon":-74.005972222222,"icon":""},{"text":"\u003Cb\u003E\u003Ca href=\"/en/Semantic_Forms_Inputs\" title=\"Semantic Forms Inputs\"\u003ESemantic Forms Inputs\u003C/a\u003E\u003C/b\u003E","title":"Semantic Forms Inputs","link":"","lat":52.239988888889,"lon":4.4500083333333,"icon":""},{"text":"\u003Cb\u003E\u003Ca href=\"/en/Semantic_Maps\" title=\"Semantic Maps\"\u003ESemantic Maps\u003C/a\u003E\u003C/b\u003E","title":"Semantic Maps","link":"","lat":51.054341666667,"lon":3.717425,"icon":""},{"text":"\u003Cb\u003E\u003Ca href=\"/en/Semantic_MediaWiki\" title=\"Semantic MediaWiki\"\u003ESemantic MediaWiki\u003C/a\u003E\u003C/b\u003E","title":"Semantic MediaWiki","link":"","lat":51.752013888889,"lon":-1.25785,"icon":""},{"text":"\u003Cb\u003E\u003Ca href=\"/en/Semantic_Result_Formats\" title=\"Semantic Result Formats\"\u003ESemantic Result Formats\u003C/a\u003E\u003C/b\u003E","title":"Semantic Result Formats","link":"","lat":51.054341666667,"lon":3.717425,"icon":""},{"text":"\u003Cb\u003E\u003Ca href=\"/en/VisualEditor\" title=\"VisualEditor\"\u003EVisualEditor\u003C/a\u003E\u003C/b\u003E","title":"VisualEditor","link":"","lat":52.517036111111,"lon":13.388861111111,"icon":""}],"imageLayers":[]}

• More tests: Category:MediaWiki_extension

Installation notes

Versions and dependencies

Semantic maps is based on other extensions. Typically, you must include Validator (or ParamProcessor), SMW, semantic Forms, Maps, and finally Semantic Maps.

As of August 2013, you have to make a choice between and older and a newer version. In addition, documentation for ParamProcessor isn't up-to-date, i.e. some confusion of what you need. Also read Wikidata/Notes/SMW and Wikidata

Version 3.0.x

Currently (dec 2013), beta but should be working fine with MW 1.22 and SMW 1.9x

• We suggest using the composer dependency manager to install, read the Semantic MediaWiki article.

Version 2.0.x

Download and instructions: Extension:Semantic_Maps

• Maps 2.0.1 or above
• ParamProcessor 1.0 or above. This is a new version of Validator and it also keeps the validator extension directory.
• DataValues (needed by ParamProcessor)
• Mediawiki 1.18 or above
• PHP 5.3 or above

Version 1.0.5

Download and instructions: Extension:Semantic_Maps and the old documentation wiki

• Maps 1.0.5
• MediaWiki 1.17 or above
• Validator later than 0.4.12

Requirements

PHP and Mediawiki version

You need some sort of "magic combo". We suggest upgrading the wiki to alpha (i.e. get all the code, including extension code from GET).

Using MW 1.20x, default PHP of Ubuntu LTS 20.04, we had a severe problem with Validator and SMW (relatated to the version of this wiki).

 Class '\\ValueValidators\\RangeValidator' not found in /export/data/portails/mediawiki/extensions/Validator/includes/ParamProcessor/ParamDefinitionFactory.php on line 181, referer: http://edutechwiki.unige.ch/en/Semantic_Forms

This might be due to an older php version but we don't know ....

After upgrading both the server and the wiki (see special:version) to bleeding edge code, it worked. See our Mediawiki version

Semantic MediaWiki version

SMW and SMF should be installed and working. Read the Semantic MediaWiki article for some installation notes ...

Download

(tested on Jan 30, 2014)

Since MW 1.22 (end of 2013), we suggest to use the composer manager. Read the Semantic MediaWiki article for more details about this framework and how to install it.

cd /your/mediawiki-installation-directory

• To install the require maps extensions, type:

composer require mediawiki/maps "*"

• To install Semantic Maps, type:

composer require mediawiki/semantic-maps "dev-master"

• To update (all extensions), type:

composer update

However, this may change at some point, e.g. instead of downloading "dev-master", you rather should take a stable version.

Configure LocalSettings.php for older MediaWikis

This is before composer, do not use this for MW 1.22 or more recent !

(1) Add DataValues before Validator

(2) Add the SemanticMaps after all the other SMW extensions (e.g. Validator, SMW and SMF and Maps).

Example configuration:

// Start of SMW namespaces (after 106/107 = Coap)
$smwgNamespaceIndex = 108;
# DataValues (needed for ParaProcessor)
require_once( "$IP/extensions/DataValues/DataValues.php" );
# aka ParamProcessor (needed for SMW)
require_once( "$IP/extensions/Validator/Validator.php" );
# SMW
include_once("$IP/extensions/SemanticMediaWiki/SemanticMediaWiki.php");
enableSemantics('edutechwiki.unige.ch'); // adjust to yours

$smwgShowFactbox = SMW_FACTBOX_NONEMPTY;
// $smwgShowFactbox = SMW_FACTBOX_HIDDEN;

include_once("$IP/extensions/SemanticForms/SemanticForms.php");

# If one or more of your fields can contain internal links entered by users (e.g., "This is a [[cat]]")
$smwgLinksInValues = true;

# Semantic Drilldown. Needs yet another namespace
$sdgNamespaceIndex = 118;
include_once("$IP/extensions/SemanticDrilldown/SemanticDrilldown.php");

# Semantic Result Forms
require_once("$IP/extensions/SemanticResultFormats/SemanticResultFormats.php");

# Semantic Forms Inpus
require_once("$IP/extensions/SemanticFormsInputs/SemanticFormsInputs.php");

# Maps
require_once( "$IP/extensions/Maps/Maps.php" );
# Semantic Maps
require_once( "$IP/extensions/SemanticMaps/SemanticMaps.php" );

Understanding and Testing Maps

Since SemanticMaps are based on Maps, it's a good idea to understand how to use Maps first.

Read:

• coordinates
• geocoding
• Maps/Displaying maps

Try a simple Geocoding function like this:

{{#geocode:location=40 bouledvard du Pont-d'Arve, Geneva, Switzerland}}

It should show like this:

Geocoding failed

Then, create a map, using geocoding:

{{#display_map:address=40 bouledvard du Pont-d'Arve, Geneva, Switzerland}}

It should produce something like that, i.e. the location where this very page has been written :)

Loading map...

{"minzoom":false,"maxzoom":false,"mappingservice":"leaflet","width":"auto","height":"350px","centre":false,"title":"","label":"","icon":"","lines":[],"polygons":[],"circles":[],"rectangles":[],"copycoords":false,"static":false,"zoom":false,"defzoom":14,"layers":["OpenStreetMap"],"image layers":[],"overlays":[],"resizable":false,"fullscreen":false,"scrollwheelzoom":true,"cluster":false,"clustermaxzoom":20,"clusterzoomonclick":true,"clustermaxradius":80,"clusterspiderfy":true,"geojson":"","clicktarget":"","imageLayers":[],"locations":[],"imageoverlays":null}

Test the Special:MapEditor page

• Insert stuff and export the wiki code, then paste into some page.