This "GeoCMS Maps 22" Profile provides a quick setup to use geolocation capabilities in many Tiki features, that can be shown in customisable maps, in Tiki versions starting from https://doc.tiki.org/Tiki22.

You are provided with a simple navigation module at the top bar to display partial content (by tiki feature), or all geolocated content together in a map. In addition, different map parameters are predefined to let you have quick different look and feels in them.

1.1. Tiki Features

These Tiki features are enabled, and included some demo content with geolocation details:

• Wiki pages, Tracker items, Blog posts, articles and web services.

1.2. Further configuration steps

Rebuild unified search index

• You need to ensure that the unified search index is run after you apply this profile.

Add Web service 1 - with NO params

You need to setup your webservices here:

• System menu > Settings > Webservices (tiki-admin_webservices.php)

Add this information:

• url: https://opendata-ajuntament.barcelona.cat/data/api/action/datastore_search?resource_id=8808bc24-e14c-45a5-9c24-5e67846f087a
• Type: REST
• Body of POST request:
  (leave this previous box empty)

And click at | Lookup | button.

Then, since there are no special parameters defined in this example, you can proceed to test it.
Click at | Test Input | button

This will produce some results a the "Response Information" box, in json format. And they should contain a section with 100 [records] (out of the several thousand records available in total (with no filtering based on web service params)

Then you can register this web service by means of:

1. providing this name for it: bcnterrassesnoparams (since it's the predefined web service name expected by wiki pages created by this tiki profile), and
2. click at the | Register Service | button

Once the web service is registered, then you can register a webservice template, providing this information in the form at the bottom of that page:

• Name: bcnterrassesnoparamstemplate
• Engine: Index
• Output: Multi-index
• (Text area field):
  
  Copy to clipboard

  {
  	"records": [
  		{
  			"EMPLACAMENT": {
  				"type": "sortable",
  				"field": "title"
  			},
  			"NOM_BARRI": {
  				"type": "plaintext",
  				"field": "type"
  			},
  			"LONGITUD": {
  				"type": "numeric",
  				"field": "lon"
  			},
  			"LATITUD": {
  				"type": "numeric",
  				"field": "lat"
  			}
  		}
  	]
  }

And click at | Register Template | button.

Last, you will need to rebuild the unified search index again:

• Rebuild unified search index

Add Web service 2 - WITH params

You need to setup your webservices here:

• System menu > Settings > Webservices (tiki-admin_webservices.php)

Add this information:

• url: https://opendata-ajuntament.barcelona.cat/data/api/action/datastore_search?limit=%n_limit%&q=%wsq%&resource_id=8808bc24-e14c-45a5-9c24-5e67846f087a
• Type: REST
• Body of POST request:
  (leave this previous box empty)

And click at | Lookup | button.

Then test the parameters defined. You can test with:

• n_limit: 8
• wsq: {"NOM_DISTRICTE":"Sant Andreu"}
• Bypass cache (X) (leave it checked)

And click at | Test Input | button

This will produce some results a the "Response Information" box, in json format. And they should contain a section with 8 [records] (out of the 380 records available passing this filter of district name (NOM_DISTRICTE)

Then you can register this web service by means of:

1. providing this name for it: bcnterrassesparams (since it's the predefined web service name expected by wiki pages created by this tiki profile), and
2. click at the | Register Service | button

Once the web service is registered, then you can register a webservice template, providing this information in the form at the bottom of that page:

• Name: bcnterrassesparamstemplate
• Engine: Index
• Output: Multi-index
• (Text area field):
  
  Copy to clipboard

  {
  	"records": [
  		{
  			"EMPLACAMENT": {
  				"type": "sortable",
  				"field": "title"
  			},
  			"NOM_BARRI": {
  				"type": "plaintext",
  				"field": "type"
  			},
  			"LONGITUD": {
  				"type": "numeric",
  				"field": "lon"
  			},
  			"LATITUD": {
  				"type": "numeric",
  				"field": "lat"
  			}
  		}
  	]
  }

And click at | Register Template | button.

Last, you will need to rebuild the unified search index again:

• Rebuild unified search index

Map enhancements (optional)

Optionally:

• If you use Tiki version 20.1 or higher, you can use some extra background maps. Some of them require that you have an api key:
  • nextzen (vector tiles),
  • bing maps (which include satellite images, among other tilesets).
  
  More information in the Maps control panel

1.3. How to use it....

Browse geolocated content through the menu shown in the top bar module.

See further details on the parameters used in the documentation:

• https://doc.tiki.org/PluginMap
• https://doc.tiki.org/GeoLocation
• https://doc.tiki.org/PluginWebService

Last, but not least, remember that you can extend this profile!:

• https://profiles.tiki.org/GeoCMS_Maps_22