==== Dashboard Block ====
===== Mapped Data Configuration =====


Displaying data on a GoogleMaps map assumes the availability of information
with geolocation coordinates, or address mentions that can be converted. The "Dashboard" block can handle the conversion of addresses into location coordinates and will cache
this information.

Converting address data into geolocation coordinates is subject to the terms of service
of the Google Geocoding API. The "free" conversion for an unregistered user
cannot exceed 2500 calls per day. See the documentation on the
[[https://developers.google.com/maps/documentation/geocoding/start|Google Geocoding
API]] for more information.

{{ :blocks:dashboard:googleparams_fr.jpg |}}

=== Map data settings ===

Geolocatable data are placed on the map as markers. These markers can be defined:

   * As a quadruplet: Title, Latitude, Longitude, Type</li>
   * As a sextuplet: Title, Address, Postal code, City, Region, Type</li>

The expected values are:

   * **Title**: The marker's text label
   * **Latitude**: The geolocation latitude (float)
   * **Longitude**: The geolocation longitude (float) 
   * **Address**: Street data, number
   * **Postal code**: The postal code or Zip code for English-speaking countries
   * **City**: The city
   * **Type**: A type label, allowing selection of a particular graphic icon

=== Query output fields configuration ===

The setting fields let you designate the query output fields that provide this information.
The setting fields generally take one or more result column names (or aliases).

   * **Title field**: The name of the output column providing the text label
   * **Location fields**:
      * **Case 1**: The name of the output column providing the geolocation pair as a comma pair: "lat,lng"
      * **Case 2**: the list of column names that successively provide (in order): the address information, the postal code, the city, and the region code <nowiki>(*)</nowiki>
   * **Type fields**: The name of the output column providing the marker classification

<nowiki>(*)</nowiki> It is possible to give constant values here, by enclosing the list value in quotes:

    address;cp;city;'FR'

For example, this will always provide the region code with the value 'FR'.

<html><!-- nomoodle --></html>
-----

==== Credits ====

  * Valéry Frémaux (valery@activeprolearn.com)- Development and documentation
  * Florence Labord (florence@activeprolearn.com) - documentation



[[:blocks:dashboard:userguide|Back to the configuration guide index]] - [[:Blocks:Dashboard|Back to the component index]] - [[:Blocks:Dashboard:QueryCatalogue|Go to the generic query catalog]] - [[:Plugins|Back to the plugin index]] - [[:start|Back to the catalog]]

<html><!-- /nomoodle --></html>