Viewmap : Différence entre versions

De SILADEL
Aller à : navigation, rechercher
(Obtenir une clé d'API Google Map:)
 
(48 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, clients, fournisseurs, contacts, 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]] 
  
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.
+
=== Test du géocodage lors de la création d’un tiers ===
 +
 
 +
<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ée 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 tiers 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 dans votre module Viwmap.
+
L’API Google Geocoding est limitée à 2 500 requêtes de géolocalisation par jour.
 +
</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.
+
=== Suppression des données de géocodage ===
  
</pre>
+
Vous pouvez réinitialiser les coordonnées GPS de tous vos tiers et contacts via l’option '''Effacer les données de géocodage'''. 
  
==Obtenir une clé d'API Google Map:==
+
=== Personnalisation des marqueurs ===
  
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]
+
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'''.
  
===1. Création d'un nouveau projet===
+
[[Fichier:Viewmap marqueurs.jpg]] 
  
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".
+
== Obtenir une clé API Google Maps ==
  
Il suffit de cocher 2 cases :
+
Rendez-vous sur [https://console.developers.google.com console.developers.google.com]. 
  
*indiquez si vous souhaitez recevoir ou non l'actualité Google APIs
+
=== 1. Création d’un projet ===
*acceptez les conditions d'utilisation.
 
  
 +
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. Création de la clé===
+
=== 2. Génération de la clé ===
Vous avez 2 champs à remplir :
 
  
*Vous devez nommer la clé ou laisser le nom par défaut "Clé API 1"
+
* Donnez un nom à la clé (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é).
+
* 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> 
  
 
<pre style="color: red">
 
<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 ==
 
== Utilisation ==
  
Géocoder une adresse postale sur la fiche d'un tiers :
+
=== 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. 
 +
 
 +
[[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]] 
  
[[Fichier:Viewmaptier.jpg | 700px]]
+
== Contact ==
  
 +
Pour toute question concernant ce module ou nos services : 
  
Dans Outils, une page est disponible pour visualiser l'ensemble des cartes.
+
[[Fichier:Siladel.png|link=https://www.siladel.fr|alt=Développeur web à Albi]] 
  
[[Fichier:Viewmapmap.jpg | 700px]]
+
* [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]

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