Viewmap : Différence entre versions

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

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.

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

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.

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.

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.

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é

Contact

Pour toute question concernant ce module ou nos services :

@@ 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.
-Le module Viewmap permet de géolocaliser vos différents tiers, tels que les prospects, les clients, les fournisseurs, les contacts et les adhérents, sur une carte Google Maps. En effet, lors de la création d'un nouveau tiers, ce module effectue automatiquement la géolocalisation de son adresse et vous offre la capacité d'afficher l'ensemble de vos tiers sur une carte unique.
+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 ==
-Depuis l'interface à la page Configuration > Modules/Applications Cliquez sur l'onglet Déployer/Installer un module externe.
+# 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'''.
-Après avoir terminé l'installation, rendez-vous sur la page de configuration pour saisir votre clé Google Map.
+La carte sera ensuite accessible depuis l’onglet '''Outils''', ainsi que depuis les fiches de vos tiers.
-La carte sera accessible depuis l'onglet "outils" et également sur les fiches de vos tiers.
 == Configuration ==
-Une fois l'installation du module terminée dans l'application Dolibarr, vous devez activer le module qui se trouve dans la session Modules/Applications
-[[Fichier:Viewmap index.jpg| 900px ]]
+Après installation, activez le module depuis '''Configuration > Modules/Applications'''.
-[[Fichier:Viewmap screen config.jpg|900px]]
+[[Fichier:Viewmap index.jpg|900px]]
+[[Fichier:Viewmap screen config.jpg|900px]]
+=== Test du géocodage lors de la création d’un tiers ===
-'''Test du géocodage pendant le processus de création'''
 <pre>
-Vous pouvez tester de géolocaliser une adresse postale pendant la saisie d'un nouveau tiers avec l'option "Test du géocodage pendant le processus de création"
+Vous pouvez tester la géolocalisation d’une adresse postale directement lors de la création d’un nouveau tiers grâce à l’option
-</pre>
+« Test du géocodage pendant le processus de création ».
+</pre>
+=== Clé API Google Maps ===
-'''Clé Google Map'''
 <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 dans votre module Viwmap.
+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.
-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 un au préalable.
+Un compte Gmail est requis pour générer cette clé.
+</pre>
-</pre>
-'''Zoom de la fiche client et de la carte '''
-Vous pouvez modifier le zoom des cartes.
-*1 = Le monde entier
-*6 = La France entière
-*11 = un département
-*16 = un quartier
-'''Clusterisation des marqueurs sur la carte principale'''
+=== Niveau de zoom des cartes ===
-Cette fonction permet de regrouper les markers en zone.
+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 ===
-'''Géocodage en masse de vos contacts'''
+Le module propose une fonction de '''regroupement automatique des marqueurs''' lorsque plusieurs tiers sont situés dans la même zone.
-[[Fichier:Geocodage_setting.png]]
+=== Géocodage en masse ===
-Pour chaque clic sur le bouton "géocoder" vous effectuez un géocodage sur 100 adresses.
+[[Fichier:Geocodage_setting.png]]
-Appuyez sur autant de fois que nécessaire pour géocoder l'ensemble de vos contacts.
+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">
-L'utilisation de l'API Google Geocoding est limitée par un quota de 2.500 requêtes de géolocalisation par jour.
+L’API Google Geocoding est limitée à 2 500 requêtes de géolocalisation par jour.
 </pre>
-''' Effacer les données du géocodage'''
+=== Suppression des données de géocodage ===
-Cette fonction supprimer les coordonnées GPS de tous vos société/contacts.
+Vous pouvez réinitialiser les coordonnées GPS de tous vos tiers et contacts via l’option '''Effacer les données de géocodage'''.
-''' Définir ses propres marqueurs '''
+=== Personnalisation des marqueurs ===
-Le module propose de remplacer les marqueurs par défaut suivant le type de tier.
+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'''.
-il est recommandé d'utiliser des images de 48px maximum au format PNG, GIF, JPG
+[[Fichier:Viewmap marqueurs.jpg]]
-[[Fichier:Viewmap marqueurs.jpg]]
+== Obtenir une clé API Google Maps ==
-==Obtenir une clé d'API Google Map:==
+Rendez-vous sur [https://console.developers.google.com console.developers.google.com].
-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]
+=== 1. Création d’un projet ===
-===1. Création d'un nouveau 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.
-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".
+=== 2. Génération de la clé ===
-Il suffit de cocher 2 cases :
+* 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'''
-*indiquez si vous souhaitez recevoir ou non l'actualité Google APIs
+<pre style="color: red">
-*acceptez les conditions d'utilisation.
+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é===
-*Vous devez nommer la clé ou laisser le nom par défaut "Clé API 1"
-*Pour sécuriser votre clé, appliquez une restriction en choisissant "Adresse IP" et entrez l'adresse IP de votre serveur Dolibarr. Ainsi, seule cette adresse sera autorisée à utiliser la clé.
-*Assurez-vous d'associer à votre clé les API suivantes : "Maps JavaScript API" et "Geocoding API"
 <pre style="color: red">
+Important : le module Viewmap utilise l’API de géocodage uniquement lors de la première géolocalisation d’une adresse.
+</pre>
-Depuis le 11 juin 2018, il est obligatoire d’activer un compte de facturation afin de pouvoir utiliser les services Google Maps.
+Cliquez ensuite sur '''Créer'''.
-Toutefois, Google fournit généralement un crédit gratuit mensuel, ce qui signifie que pour une utilisation modérée, il n'y a souvent pas de frais réels à payer.</pre>
-<pre style="color: red">
-Important : Viewmap fait appel à l'API de géocodage uniquement une seule fois lors de la géolocalisation de l'adresse.
-</pre>
-Poursuivez en cliquant 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 pour l'intégrer dans votre configuration Viewmap.
 == Utilisation ==
-=== Carte sur la fiche client ===
+=== Carte intégrée à la fiche d’un tiers ===
-Géocoder une adresse postale sur la fiche d'un tiers :
+Lors de la saisie d’une adresse, vous pouvez la géocoder directement depuis la fiche du tiers.
-[[Fichier:Viewmaptier.jpg | 700px]]
+[[Fichier:Viewmaptier.jpg|700px]]
-=== Option d'affichage ===
+=== Options d’affichage ===
-Contrôle des données lorsque vous utilisez l'API Viewmap.
+Avec l’API Viewmap, vous pouvez choisir de masquer certaines informations (e-mail, téléphone, URL) ou de les afficher selon vos besoins.
-Pour le tier en cours, vous pouvez choisir de masquer certaine information comme l’e-mail, téléphone, Url ou ne rien afficher.
+[[Fichier:Viewmap option api.jpg|900px]]
-(cette fonctionnalité est prise en compte uniquement avec l'API Viewmap)
+=== Carte globale des tiers ===
-[[Fichier:Viewmap option api.jpg | 900px]]
+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é
-=== Carte d'ensemble ===
+[[Fichier:Viewmap map2.jpg|900px]]
-Dans Outils, une carte est disponible pour visualiser l'ensemble des tiers.
-Vous pouvez filtrer vos données par type de tier, pays, département, catégorie ou par commerciaux
-[[Fichier:Viewmap map2.jpg | 900px]]
 == Contact ==
-Pour toutes questions sur les produits et services, veuillez nous contacter:
+Pour toute question concernant ce module ou nos services :
-[[Fichier:Siladel.png|link=https://www.siladel.fr|alt=développeur web sur albi]]
-[https://www.siladel.fr/service/developpement-dolibarr Développeur Dolibarr]
+[[Fichier:Siladel.png|link=https://www.siladel.fr|alt=Développeur web à Albi]]
-[https://www.dolistore.com/product.php?id=1398&title=viewmap&l=fr Module disponible sur Dolistore]
+* [https://www.siladel.fr/service/developpement-dolibarr Développement Dolibarr par SILADEL]
+* [https://www.dolistore.com/product.php?id=1398&title=viewmap&l=fr Module Viewmap disponible sur Dolistore]