Maps

From semantic-mediawiki.org
Jump to: navigation, search
Maps
Allows embedding of dynamic maps, geocoding and geospatial operations
Further Information
Homepage: follow this link
Maintainer(s): Jeroen De Dauw
First released: July 2009
Release status: stable
Development status: active
Area of usage: Displaying data
Associated with:SMW = Semantic MediaWiki, SB = Semantic Bundle, SMW+ = Semantic MediaWiki Plus, MW = MediaWiki MW, SB
Table of Contents

Maps is a 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 built-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. It is used by the Semantic Maps extension.

Installation

Installation instructions can be found in the INSTALL.md file.

Examples

Many examples of how to use Maps can be found on the Maps examples page.

Usage

Details of usage will vary depending on which mapping service you elect to use (see the installation instructions for details). These include Google Maps (with Google Earth support), Yahoo! Maps, OpenLayers and OpenStreetMap.

Each mapping service has its own unique features, and may add its own parameters to the #display_map and #display_points functions. See the documentation on the mapping services for more info about these.

Maps can use coordinates in a variety of formats, and they can also take in addresses directly, using geocoding. Geocoding is a mapping service that converts a given address into coordinates.

Here is an example using the default geocoding service (Google) and the default coordinate format (Degrees Minutes Seconds):

{{#geocode:Brandenburg Gate, Berlin, Germany}}

results in: 52° 30' 58.5886" N, 13° 22' 39.7344" E

see → Maps/Coordinates and Maps/Geocoding for details.

You also can call #display_map directly on worldwide addresses using the address parameter with geocoding-on-the-fly like in the following example:

{{#display_map:address=Brandenburg Gate, Berlin, Germany}}
{{#display_map:address=Brandenburg Gate, Berlin, Germany|width=400|height=300|zoom=17|type=hybrid}}

is rendered as:

Loading map...

Loading map...
see → Maps/Displaying maps for details.

All documentation relevant for users can be found in the Maps category:

Maps, Maps/Coordinates, Maps/Displaying maps, Maps/Geocoding, Maps/geocoding service, Maps/mapping service

Support

If you have problems with the usage of any mapping related features, you should provide the community or developers with the information needed to help you out. Reporting simply that you have a problem without describing it properly wastes people's time. Also look at the documentation before asking for help. All support requests should answer at least the following questions:

  • Can the problem be viewed online in a public wiki? (If yes, provide its URL.)
  • Which versions of the relevant extension(s) was/were used?
  • Which version of MediaWiki was used?

Where

General mapping questions are welcome on the mapping mailing list.

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.

Reporting bugs

Bugs and feature requests for should be filed at the Maps bugtracker. As usual, all bug reports should answer at least the following questions:

  • Can the problem be viewed online in a public wiki? (If yes, provide its URL.)
  • Which versions of the relevant extension(s) was/were used?
  • Which version of MediaWiki was used?
  • Which server setup was used (PHP, MySQL, OS)?
  • Can the problem be reproduced on another wiki (like this one)? (If yes, provide its URL.)

Improvements and patches can also be discussed on the mailing list. You can also view the current bug list for Maps online. It might contain hotfixes, patches, or workarounds even for unsolved issues.

How to get more information on your problem

Here are some tips to get more information on a problem, which will help us to solve it faster.

  • In general, it may also be useful to turn on debugging in MediaWiki (try http://meta.wikimedia.org/wiki/How_to_debug_MediaWiki). This should provide you with more instructive error messages in your log file.
  • If some page will not display correctly or causes critical errors, directly access the page in edit mode. To do that, edit any other page on your wiki and replace the page's name in the URL with the name of the broken page. Then try to remove parts of the page to find out what causes the problem, and include this in your bug report.

Version history

You can find a list of releases and their associated changes in the RELEASE-NOTES.md file .


This documentation page applies to all SMW versions from 1.4.2 to the most current version.
      Other languages: de

Maps en 1.4.2