====== SpatialHelper Plugin ======

---- plugin ----
description: Provides utility functions such as spatial indexing and search
author     : Mark Prins
email      : mprins@users.sf.net
type       : action, helper
lastupdate : 2024-04-08
compatible : Hogfather, Igor, Jack Jackrum
depends    : geoPHP
conflicts  : 
similar    : 
tags       : !experimental, meta, search geo spatial

downloadurl: https://github.com/mprins/dokuwiki-plugin-spatialhelper/archive/master.zip
sourcerepo : https://github.com/mprins/dokuwiki-plugin-spatialhelper
bugtracker : https://github.com/mprins/dokuwiki-plugin-spatialhelper/issues/
donationurl: https://github.com/sponsors/mprins

----

===== Installation =====

:!: **External requirements:**\\ 
This plugin needs to have one of the following additional plugins installed to be useful

  * [[plugin:geotag|]]
  * [[plugin:openlayersmap]]
  * any other plugin that stores latitude and longitude in the same manner, ie. in the ''meta['geo']'' array ((see: [[devel:metadata#metadata_and_plugins]])).

Search and install the plugin using the [[plugin:extension|Extension Manager]] or manually with the download from  [[https://github.com/mprins/dokuwiki-plugin-spatialhelper/archive/master.zip|Github]]. Refer to [[:Plugins]] on how to install plugins manually. 

===== Usage =====
This plugin will generate a (geohash based) spatial index in your wiki.
The geo locations are taken from pages tagged using [[plugin:geotag|geotag]] or [[plugin:openlayersmap|openlayersmap]] plugin or images uploaded using media manager.
Currently only JPG images with EXIF tags are supported.

When sitemaps are enabled, whenever a sitemap is generated (see [[config:sitemap]] KML and GeoRRS sitemaps will be generated in the media directory. These can be displayed using eg. [[plugin:openlayersmap]]

You can create search links in pages using the "findnearby" action to search the spatial index, see the [[https://dokuwikispatial.sourceforge.io/dokuwiki/doku.php/spatialhelper/start|examples]]

===== Configuration =====

The name of the sitemaps can be configured as well as additional, per namespace, sitemaps.

===== Development =====

==== Change Log ====

{{rss>https://github.com/mprins/dokuwiki-plugin-spatialhelper/commits/master.atom date}}


===== Discussion =====

It looks very interesting, but how to use it? Where I can find more info?
> this is a work in progress, some examples are shown on the [[https://dokuwikispatial.sourceforge.io/dokuwiki/doku.php/spatialhelper/start|sample website]] --- [[user>mprins|Mark]] //2011/06/09 10:34//