Ce produit à pour but de permettre la visualisation de certains lieux dans une carte Google (cf exemple ci-dessous).

Le marqueur bleu étant la localisation. Il est possible de définir plusieurs lieux, avec des couleurs de marqueur différentes, sur une même carte (cf la partie utilisation).

A ce nouveau type de document, vient s'ajouter la possibilité d'utiliser un portlet Map (boîte dans la colonne gauche ou droite).

L'installation du produit se fait de manière classique dans la configuration du site via le menu "Produits d'extension" ou "Ajout/Suppression de produits".

La configuration du produit se fait via le menu "Maps".

Ce qui amène à la page de configuration du produit Maps :

Cette page contient les zones suivantes:

• La clé Google Maps API : Elle permet d'utiliser les cartes Google. Sans cette clé, vous aurez un message disant "clé map manquante" lors de la navigation dans le site.

Voici la procédure pour recevoir les clés :

1. Vous devez aller sur le site de Google-Maps (http://code.google.com/intl/fr/apis/maps/signup.html) afin de demander une clé pour votre site. 

2. Indiquer l'url de votre site de test et ensuite faites de même pour l'url de production (ce ne sera plus à faire plus tard) : 

3. Cliquer sur "Generate API Key" et remonter au dessus de la page. Il vous suffira de copier la clé (en vert) dans un nouveau label_google_map_api_keys (avec l'url de votre site)

• La clé Google Ajax search API : Pour avoir les clé Ajax. C'est le même principe que pour les clés API à partir de l'URL suivant http://code.google.com/apis/ajaxsearch/signup.html.
• Type de carte par défaut : C'est le type de carte qui sera utilisé lors de l'ajout d'un nouvel élément de type "localisation". Il y a 3 valeurs possibles (schématique, satellite, satellite avec schéma des rues)
• Coordonnées par défaut : Ce sont les coordonnées qui seront utilisées lors de l'ajout d'un nouvel élément de type "localisation".

Voici un petit truc : Après avoir ajouté les clés, ajoutez votre première localisation (par exemple l'adresse de la commune). Copier les coordonnées ainsi calculées dans la valeur par défaut. A chaque nouvelle localisation, vous commencerez de cette adresse.

Il ne reste plus qu'à activer, via la ZMI, le mode "debug" pour les javascript (portal_javascripts) afin que les clé soient directement activées.

Maintenant que le produit Maps est installé et correctement configuré, il ne reste plus qu'a ajouter les différentes localisations :

1. Créer un dossier qui deviendra une carte et contiendra les pointeurs de cette carte.

2. Changer la vue de ce dossier en "vue cartographique"

3. Ajouter les différentes localisations

Vous pourrez y indiquer le titre, une description qui pourra être affichée en cliquant sur le marqueur, les coordonnées (ou faire une recherche sur l'adresse) comme on le voit ci-dessous :

 Vous pourrez également choisir la couleur du marqueur et y mettre des informations complémentaires (apparaîtra dans un second onglet si vous cliquez sur la marqueur).