History: Geolocation

            ! Geolocation

Starting at ((Tiki9|version 9)), tiki allows the geolocation of wiki pages, blog posts, articles and tracker items, using OpenStreetMaps. Since ((Tiki20|version 20.1)) new tile providers can be used, and clustering of mapped features is possible.


{img src="display707" url="display707" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

!! Admin panel
__Options shown in Settings section__

*Available tile layers on maps:     
** Valid options are: openstreetmap, openaerialmap, google_street, google_satellite, google_physical, google_hybrid, blank
* Google Street View    
* Google Street View Overlay      
* Geolocate blog posts  
* Geolocate wiki pages    
* Geolocate articles  
* Plugin Map  
* Location  
* Always load OpenLayers    
* Google Maps API Key

__Options shown in MapServer settings__

* MapServer

!!# Requirements
In order to have this feature properly working, you are encouraged to enable the following:

For tiki versions older than 14.0:
*  __Admin home > Textarea > Plugins > Plugin Map__ (to enable the plugin to show the map with geolocated data)
* __Admin home > Textarea > Plugins > Plugin List__ (to select  some subset of objects to be displayed in the map, instead of all) 
*  __Admin home > Maps > Always load OpenLayers __ enabled (for the "__search location__ feature to work).

For ((Tiki14|tiki 14.0)) and newer:
* __Quick Administration > Control Panels > Plugin Map__
* __Quick Administration > Control Panels > Always load OpenLayers__
(Make sure that the ''Preference Filter'' is set to __advanced__ and/or __experimental__)

!!# Geolocate wiki pages

Enable the feature in __Admin home > Wiki > Features > Geolocation of wiki pages__
And ensure that you have the option __Admin home > Maps > Always load OpenLayers __ enabled for the "__search location__ feature to work.

Then edit some Wiki pages (1), go to the properties tab (2), and place a marker for the position in the map you want to set for each page. You can click at "Search location" (3), add some address (4) and click at OK (5):

{img src="display708" url="display708" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

Once the location is found (without page reload), the map will be updated with the new location in the middle. You can save the page to keep the new location associated with the wiki page:

{img src="display709" url="display709" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

If you want that wiki page to show a map with that geolocation shown, add a call to the plugin map in the page:
{CODE()}
{map}
{CODE}

If you want to display all wiki pages that contain geolocation data, and with a different marker from the one shown for the wiki page where the map is shown, you can place this code inside the wiki page:

{CODE()}
{map}

{LIST()}
	{filter type="wiki page"}
	{filter content="y" field=geo_located}
{LIST}
{CODE}

The wiki page will show this type of map:

{img src="display710" url="display710" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

In case you want to show only the item corresponding to this wiki page, you can use this code instead:

{CODE()}
{map}

{LIST()}
	{filter type="wiki page"}
	{filter content="{{page}}" field=object_id}
	{filter content="y" field=geo_located}
{LIST}
{CODE}

In some case you may have some items with a map location set and some items without.
Those without will display a map and you may prefer this not to happen.
You can hide the field using a Javascript plugin and some code on the page:
{CODE(caption="hide location field when location is not set")}{JQ()}
  var map = $('input[name="location"]').val();
  if (map == "0,0,2") {
    $('#openlayers1').hide();
  }
{JQ}{CODE}

For more options to filter which content to be shown in the map, see ((PluginList))

!!# Geolocate blog posts or articles
You must enable the setting in "Admin home > Maps", and this will show a new field in the blog or article edit screen in which you will be able to indicate the position associated with that publication. 

Later on, you can display a map displaying only those geolocated items, or in conjunction with other geolocated items in your site.

See profile "((pr:Easy GeoBlog))" as a working example. 




!!# Geolocate tracker items
Simple example:
{CODE()}
{MAP(scope="center"  controls="controls,search_location,scale,navigation" width="800" height="400" center="2.1421963549255145,41.381029526482095,7")} {searchlayer geo_located="y" maxRecords=100 tracker_id="1" type="trackeritem"}
{MAP}
{CODE}

See some more advanced examples in the page ((PluginMap))


Related:
* ((Maps))
* ((pr:GeoCMS_Maps_18))

-=Alias names for this page=-
(alias(Geolocation of wiki pages)) | (alias(Geolocalization)) | (alias(Geolocate)) | (alias(GIS))