Viewmap : Différence entre versions

De SILADEL
Aller à : navigation, rechercher
(2. Création de la clé)
 
(65 révisions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
 +
Le module '''Viewmap''' permet de '''géolocaliser vos tiers''' (prospects, clients, fournisseurs, contacts et adhérents) directement sur une carte Google Maps. 
 +
Lors de la création d’un nouveau tiers, son adresse est automatiquement géolocalisée. Vous pouvez ainsi afficher l’ensemble de vos tiers sur une seule et même carte. 
  
Module permettant de géolocaliser vos tiers (prospects, client, fournisseurs, contact, adhérents) sur une carte Google Map.
+
== Installation ==
 +
 
 +
# Depuis l’interface Dolibarr, rendez-vous dans '''Configuration > Modules/Applications'''. 
 +
# Cliquez sur l’onglet '''Déployer/Installer un module externe'''. 
 +
# Une fois l’installation terminée, ouvrez la page de configuration du module et saisissez votre '''clé API Google Maps'''. 
 +
 
 +
La carte sera ensuite accessible depuis l’onglet '''Outils''', ainsi que depuis les fiches de vos tiers
 +
 
 +
== Configuration ==
 +
 
 +
Après installation, activez le module depuis '''Configuration > Modules/Applications'''. 
 +
 
 +
[[Fichier:Viewmap index.jpg|900px]] 
 +
[[Fichier:Viewmap screen config.jpg|900px]] 
 +
 
 +
=== Test du géocodage lors de la création d’un tiers ===
  
Viewmap géolocalise vos tiers pendant le processus de création et permet d'afficher l'ensemble de vos tiers sur une carte Google Map.
+
<pre>
 +
Vous pouvez tester la géolocalisation d’une adresse postale directement lors de la création d’un nouveau tiers grâce à l’option
 +
« Test du géocodage pendant le processus de création ».
 +
</pre> 
  
 +
=== Clé API Google Maps ===
  
== Installation ==
+
<pre style="color: red">
 +
Pour afficher les cartes Google Maps dans Dolibarr, vous devez renseigner une clé API valide.
 +
Ce tutoriel vous explique comment l’obtenir et l’intégrer au module Viewmap.
 +
Un compte Gmail est requis pour générer cette clé.
 +
</pre> 
  
Décompressez le fichier dans le dossier "htdocs/custom" ou à la racine htdocs/
+
=== Niveau de zoom des cartes ===
  
== Configuration ==
+
Vous pouvez ajuster le zoom sur la fiche client et sur la carte générale : 
Une fois l'installation du module terminé, dans l'application Dolibarr, vous devez activer le module qui se trouve dans la session Modules/Applications
+
* 1 = vue monde 
 +
* 6 = pays (France entière) 
 +
* 11 = département 
 +
* 16 = quartier 
  
[[Fichier:Viewmap index.jpg| 900px ]]
+
=== Clusterisation des marqueurs ===
[[Fichier:viewmapconf.jpg]]
 
  
'''Test du géocodage pendant le processus de création'''
+
Le module propose une fonction de '''regroupement automatique des marqueurs''' lorsque plusieurs tiers sont situés dans la même zone. 
  
<pre>
+
=== Géocodage en masse ===
Vous pouvez tester de géolocaliser une adresse postale pendant la saisie d'un nouveau tier avec l'option "Test du géocodage pendant le processus de création"
 
</pre>
 
  
 +
[[Fichier:Geocodage_setting.png]] 
  
'''Clé Google Map'''
+
Chaque clic sur le bouton '''« Géocoder »''' permet de traiter 100 adresses à la fois. 
 +
Répétez l’opération jusqu’à ce que l’ensemble de vos tiers soit géolocalisé. 
  
 
<pre style="color: red">
 
<pre style="color: red">
Pour afficher une carte Google Maps sur votre Dolibarr, il est nécessaire de spécifier une clé d'API. Nous allons voir dans ce tutoriel comment l'obtenir et l'utiliser sur votre manager.
+
L’API Google Geocoding est limitée à 2 500 requêtes de géolocalisation par jour.
 +
</pre> 
 +
 
 +
=== Suppression des données de géocodage ===
 +
 
 +
Vous pouvez réinitialiser les coordonnées GPS de tous vos tiers et contacts via l’option '''Effacer les données de géocodage'''.
 +
 
 +
=== Personnalisation des marqueurs ===
  
Pour être en mesure d'obtenir une clé d'API, il est nécessaire de disposer au préalable d'un compte Gmail. Si ce n'est pas votre cas, vous devez en créer au préalable
+
Le module permet de définir vos propres marqueurs en fonction du type de tiers. 
 +
Il est recommandé d’utiliser des images au format '''PNG, GIF ou JPG''', d’une taille maximale de '''48 px'''.
  
</pre>
+
[[Fichier:Viewmap marqueurs.jpg]] 
  
==Obtenir une clé d'API :==
+
== Obtenir une clé API Google Maps ==
  
Pour obtenir cette clé, vous devez vous rendre sur [https://console.developers.google.com/flows/enableapi?apiid=maps_backend&keyType=CLIENT_SIDE&reusekey=true&hl=fr&pli=1 console.developers.google.com]
+
Rendez-vous sur [https://console.developers.google.com console.developers.google.com]
  
===1. Création d'un nouveau projet===
+
=== 1. Création d’un projet ===
  
S'il s'agit de votre première connexion sur la console, vous allez automatiquement créer un nouveau projet qui sera nommé "My Projet".
+
Lors de votre première connexion, un projet par défaut « My Project » sera créé. 
 +
Cochez simplement : 
 +
* Recevoir ou non l’actualité Google APIs. 
 +
* Accepter les conditions d’utilisation.
  
Il suffit de cocher 2 cases :
+
=== 2. Génération de la clé ===
  
*indiquez si vous souhaitez recevoir ou non l'actualité Google APIs
+
* Donnez un nom à la clé (par défaut : « Clé API 1 »). 
*acceptez les conditions d'utilisation.
+
* Sécurisez-la en restreignant son usage à l’'''adresse IP de votre serveur Dolibarr'''
 +
* Activez les API nécessaires : 
 +
** '''Maps JavaScript API''' 
 +
** '''Geocoding API''' 
  
 +
<pre style="color: red">
 +
Depuis le 11 juin 2018, l’activation d’un compte de facturation est obligatoire.
 +
Cependant, Google propose un crédit gratuit mensuel couvrant la majorité des usages courants.
 +
</pre> 
  
===2. Création de la clé===
+
<pre style="color: red">
A nouveau 2 champs à remplir :
+
Important : le module Viewmap utilise l’API de géocodage uniquement lors de la première géolocalisation d’une adresse.
 +
</pre> 
  
*Vous devrez ensuite nommer la clé (vous pouvez laisser le nom par défaut "Clé de navigateur 1")
+
Cliquez ensuite sur '''Créer'''.
*Dans le champ Accepter les requêtes provenant de ces référents HTTP : saisissez le libellé de votre domaine sans "www", suivi d'un slash (/) et en ajoutant une astérisque avant et après : par exemple *.domaine.fr/*
 
  
Puis cliquez sur Créer
+
=== 3. Récupération de la clé ===
  
===3. Votre clé a été créée===
+
Une fenêtre s’affiche avec votre clé API. Copiez-la et collez-la dans la configuration du module Viewmap.
Une nouvelle fenêtre s'affiche avec votre clé d'API, copiez-la afin d'aller l'intégrer dans votre configuration Viewmap.
 
  
 
== Utilisation ==
 
== Utilisation ==
  
Géocoder une adresse postale sur la fiche d'un tier :
+
=== Carte intégrée à la fiche d’un tiers ===
[[Fichier:Viewmaptier.jpg | 800px]]
+
 
 +
Lors de la saisie d’une adresse, vous pouvez la géocoder directement depuis la fiche du tiers. 
 +
 
 +
[[Fichier:Viewmaptier.jpg|700px]] 
 +
 
 +
=== Options d’affichage ===
 +
 
 +
Avec l’API Viewmap, vous pouvez choisir de masquer certaines informations (e-mail, téléphone, URL) ou de les afficher selon vos besoins. 
 +
 
 +
[[Fichier:Viewmap option api.jpg|900px]] 
 +
 
 +
=== Carte globale des tiers ===
 +
 
 +
Depuis le menu '''Outils''', vous accédez à une carte regroupant l’ensemble de vos tiers. 
 +
Des filtres permettent de restreindre l’affichage par :
 +
* Type de tiers 
 +
* Pays 
 +
* Département 
 +
* Catégorie 
 +
* Commercial associé 
 +
 
 +
[[Fichier:Viewmap map2.jpg|900px]]
 +
 
 +
== Contact ==
 +
 
 +
Pour toute question concernant ce module ou nos services : 
  
 +
[[Fichier:Siladel.png|link=https://www.siladel.fr|alt=Développeur web à Albi]] 
  
Visualisation des cartes :
+
* [https://www.siladel.fr/service/developpement-dolibarr Développement Dolibarr par SILADEL] 
[[Fichier:Viewmapmap.jpg | 800px]]
+
* [https://www.dolistore.com/product.php?id=1398&title=viewmap&l=fr Module Viewmap disponible sur Dolistore]

Version actuelle datée du 30 août 2025 à 10:34

Le module Viewmap permet de géolocaliser vos tiers (prospects, clients, fournisseurs, contacts et adhérents) directement sur une carte Google Maps. Lors de la création d’un nouveau tiers, son adresse est automatiquement géolocalisée. Vous pouvez ainsi afficher l’ensemble de vos tiers sur une seule et même carte.

Installation

  1. Depuis l’interface Dolibarr, rendez-vous dans Configuration > Modules/Applications.
  2. Cliquez sur l’onglet Déployer/Installer un module externe.
  3. Une fois l’installation terminée, ouvrez la page de configuration du module et saisissez votre clé API Google Maps.

La carte sera ensuite accessible depuis l’onglet Outils, ainsi que depuis les fiches de vos tiers.

Configuration

Après installation, activez le module depuis Configuration > Modules/Applications.

Viewmap index.jpg Viewmap screen config.jpg

Test du géocodage lors de la création d’un tiers

Vous pouvez tester la géolocalisation d’une adresse postale directement lors de la création d’un nouveau tiers grâce à l’option
« Test du géocodage pendant le processus de création ».

Clé API Google Maps

Pour afficher les cartes Google Maps dans Dolibarr, vous devez renseigner une clé API valide.
Ce tutoriel vous explique comment l’obtenir et l’intégrer au module Viewmap.
Un compte Gmail est requis pour générer cette clé.

Niveau de zoom des cartes

Vous pouvez ajuster le zoom sur la fiche client et sur la carte générale :

  • 1 = vue monde
  • 6 = pays (France entière)
  • 11 = département
  • 16 = quartier

Clusterisation des marqueurs

Le module propose une fonction de regroupement automatique des marqueurs lorsque plusieurs tiers sont situés dans la même zone.

Géocodage en masse

Geocodage setting.png

Chaque clic sur le bouton « Géocoder » permet de traiter 100 adresses à la fois. Répétez l’opération jusqu’à ce que l’ensemble de vos tiers soit géolocalisé.

L’API Google Geocoding est limitée à 2 500 requêtes de géolocalisation par jour.

Suppression des données de géocodage

Vous pouvez réinitialiser les coordonnées GPS de tous vos tiers et contacts via l’option Effacer les données de géocodage.

Personnalisation des marqueurs

Le module permet de définir vos propres marqueurs en fonction du type de tiers. Il est recommandé d’utiliser des images au format PNG, GIF ou JPG, d’une taille maximale de 48 px.

Viewmap marqueurs.jpg

Obtenir une clé API Google Maps

Rendez-vous sur console.developers.google.com.

1. Création d’un projet

Lors de votre première connexion, un projet par défaut « My Project » sera créé. Cochez simplement :

  • Recevoir ou non l’actualité Google APIs.
  • Accepter les conditions d’utilisation.

2. Génération de la clé

  • Donnez un nom à la clé (par défaut : « Clé API 1 »).
  • Sécurisez-la en restreignant son usage à l’adresse IP de votre serveur Dolibarr.
  • Activez les API nécessaires :
    • Maps JavaScript API
    • Geocoding API
Depuis le 11 juin 2018, l’activation d’un compte de facturation est obligatoire.
Cependant, Google propose un crédit gratuit mensuel couvrant la majorité des usages courants.
Important : le module Viewmap utilise l’API de géocodage uniquement lors de la première géolocalisation d’une adresse.

Cliquez ensuite sur Créer.

3. Récupération de la clé

Une fenêtre s’affiche avec votre clé API. Copiez-la et collez-la dans la configuration du module Viewmap.

Utilisation

Carte intégrée à la fiche d’un tiers

Lors de la saisie d’une adresse, vous pouvez la géocoder directement depuis la fiche du tiers.

Viewmaptier.jpg

Options d’affichage

Avec l’API Viewmap, vous pouvez choisir de masquer certaines informations (e-mail, téléphone, URL) ou de les afficher selon vos besoins.

Viewmap option api.jpg

Carte globale des tiers

Depuis le menu Outils, vous accédez à une carte regroupant l’ensemble de vos tiers. Des filtres permettent de restreindre l’affichage par :

  • Type de tiers
  • Pays
  • Département
  • Catégorie
  • Commercial associé

Viewmap map2.jpg

Contact

Pour toute question concernant ce module ou nos services :

Développeur web à Albi