Doc/Pleade/GoogleMaps

Module Google Maps

Pour installer ce projet il faut l'installer de puis le projet DEV et utiliser le projet pleade-entreprise-gmaps, qui contient une partie des choses nécessaires a son utilisation, le reste est a installer, pour cela il nous faut :

• Avoir installer Mysql, la dernière version est recommandée.

sudo apt-get install mysql-server

• Avoir ajouté la table pour l'application dans la base de données pleade80 qui aura été crée.

--
-- Structure de la table `module_maps`
--
CREATE TABLE IF NOT EXISTS `module_maps` (
  `id_maps` int(11) NOT NULL AUTO_INCREMENT,
  `base_adress_maps` varchar(1000) DEFAULT NULL,
  `formated_adress_maps` varchar(1000) DEFAULT NULL,
  `type_adress_maps` varchar(250) DEFAULT NULL,
  `location_type_maps` varchar(250) DEFAULT NULL,
  `lat_maps` varchar(250) DEFAULT NULL,
  `lng_maps` varchar(250) DEFAULT NULL,
  PRIMARY KEY (`id_maps`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8 AUTO_INCREMENT=0 ;

• Avoir configuré les données de connexions a MySQL dans tomcat sur le fichier context.xml

Il faut ajouter cette balise dans le context.xml si elle n'existe pas afin de permettre au module google maps de se connecter a la base de donnée, celui ci utilise JNDI pour configurer la connexion.

<Resource name="jdbc/pleade" auth="Container" type="javax.sql.DataSource" maxActive="1000" maxIdle="500" maxWait="10000" url="jdbc:mysql://localhost/pleade80" driverClassName="com.mysql.jdbc.Driver" username="sdxapp" password="sdxapp-pwd"/>

• Avoir préalablement activé dans le pleade-plus.properties

Qu'est ce que ce module ?

Ce module apporte une nouvelle fonctionnalité a Pleade qui est l'affichage des résultats de recherche sur une carte de type google maps, le but de cet affichage est de voir ou est localisé géographiquement les séries, les documents publiés sur Pleade en fonction de leur nom de lieu.

Comment s'en sert t'on ?

l'utilisation de ce module est assez simple, cela dépends quand quel contexte on se positionne:

• Utilisateur
  1. Activer le module
  2. Se connecter
  3. Publier un document
  4. Faire une recherche
  5. cliquer sur la petite icône en forme de marqueur en faut a droite pour changer le mode d'affichage des résultats

• Développeur
  1. Activer le module
  2. Avoir fait une publication pour remplir la base de données
  3. Appeler un service cocoon pour utiliser le module google maps

URL	Paramètres	Action
http://localhost:8080/pleade-entreprise-gmaps/functions/gmaps/getgeodata.xml?lieu=VILLE&resolve=true	@place (obligatoire) @resolve (optionnel)	Ce service sert a récupérer des données géographiques afin de localiser un lieu en fonction de son nom de lieu. on spécifie le nom de lieu dans le paramètre @lieu il est obligatoire car ce service ne devinera pas quelque lieu vous souhaitez géocoder enfin le paramètre @resolve lui est optionnel, il permet de spécifier au service si vous souhaitez résoudre en temps réel les noms de lieux que vous donnez, par défaut il est a false.
http://localhost:8080/pleade-entreprise-gmaps/functions/gmaps/getgeodata.xml?lieu=resolve-all&resolve=resolve-all	@lieu=resolve-all (obligatoire) @resolve=resolve-all (obligatoire)	tout comme le précédent service, ce service permet de géocoder des lieux, en effet ce service vas chercher dans toute la base de données en dehors d'un processus de publication, les lieux qui n’ont pu être décodé(limite google) ou qui on des erreurs au niveau de leur syntaxe (que google n'as su résoudre)

Important :

L'API de google maps qui sert a géocoder a une limite qui est de 2500 lieux par tranche de 24heurex a hauteur de 10 lieux géocodés par seconde MAXIMUM !.

Comment fonctionne t'il ?