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.
+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, clients, fournisseurs, contacts, adhérents) sur une carte Google Map.
+== Installation ==
-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.
+# 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.
-== Installation ==
-Décompressez le fichier dans le dossier "htdocs/custom" ou à la racine htdocs/
 == 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 ]]
-[[Fichier:Viewmap screen config.jpg|900px]]
+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 pendant le processus de création'''
+=== Test du géocodage lors de la création d’un tiers ===
 <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é Google Map'''
+=== Clé API Google Maps ===
 <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.
+Un compte Gmail est requis pour générer cette clé.
+</pre>
-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.
+=== Niveau de zoom des cartes ===
-</pre>
+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
-'''Zoom de la fiche client et de la carte '''
+=== Clusterisation des marqueurs ===
-Vous pouvez modifier le zoom des cartes.
+Le module propose une fonction de '''regroupement automatique des marqueurs''' lorsque plusieurs tiers sont situés dans la même zone.
-*1 = Le monde entier
-*6 = La France entière
-*11 = un département
-*16 = un quartier
+=== Géocodage en masse ===
-'''Clusterisation des marqueurs sur la carte principale'''
+[[Fichier:Geocodage_setting.png]]
-Cette fonction permet de regrouper les markers en zone.
+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é.
-'''Géocodage en masse de vos contacts'''
-[[Fichier:Geocodage_setting.png]]
-Pour chaque clic sur le bouton "géocoder" vous effectuez un géocodage sur 100 adresses.
-Appuyez sur autant de fois que nécessaire pour géocoder l'ensemble de vos contacts.
 <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 avez 2 champs à remplir :
-*Vous devez nommer la clé ou laisser le nom par défaut "Clé API 1"
-*Vous devez définir une restriction pour votre clé, choisir "Adresse IP" puis saisir l'adresse de votre serveur Dolibarr. (Seul, votre serveur Dolibarr pourra utiliser la clé).
 <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'''.
-</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.
+== Contact ==
-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 toute question concernant ce module ou nos services :
-Pour toutes questions sur les produits et services, veuillez nous contacter:
+[[Fichier:Siladel.png|link=https://www.siladel.fr|alt=Développeur web à Albi]]
-[[Fichier:Siladel.png|link=https://www.siladel.fr]]
+* [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]