Module version: auto  
Editeur/Licence: Federico García-Patiño / GPL-v3
Langage interface: Espagnol, Anglais, Français
Assistance: [email protected]
Prérequis:

• Dolibarr min version: auto
• Dolibarr max version: auto

Installation (A partir de Dolibarr v9+)

• Aller dans le menu Accueil - Configuration - Modules - Déployer un module externe et soumettez le zip
• Le module ou thème est alors disponible et activable.

Installation (Pour Dolibarr v8-):

• Télécharger le fichier archive du module (.zip) depuis le site web DoliStore.com
• Placer le fichier dans le répertoire racine de dolibarr.
• Decompressez le fichier zip, par exemple par la commande  unzip module_geoaddresses-1.0.zip  
• Le module ou thème est alors disponible et activable.

Introduction

Il existe des processus métier dont l'efficacité dépend de la qualité des informations des adresses postales qui sont stockées pour les clients, les fournisseurs, les contacts, les entrepôts... Des exemples de ces services seraient l'optimisation des tournées pour un sous-système de livraison, ou d'autres actions de marketing ou de communication d'entreprise qui sont effectuées par courrier postal (Noël, félicitations, modifications des conditions de service...). Il existe même d'autres utilitaires, où la possibilité d'avoir des données sur des emplacements de qualité permet des représentations de données beaucoup plus intuitives et directes que les vues tabulaires habituelles.

Ainsi, la géolocalisation des adresses postales apporte conceptuellement une plus-value sur les chapitres suivants :

• Améliore la qualité des données par la validation visuelle et

• Permet le déploiement de nouveaux services

• Permet le développement de nouvelles représentations des données

La solution

Module GeoAddresses est s'intègre aux composants habituels de Dolibarr où apparaissent les adresses postales (magasins, tiers et contacts) et ajoute un utilitaire graphique pour la saisie automatique des informations à partir des données existantes, et sa validation ultérieure. Quel que soit l'état des données, il est possible de commencer à consommer les services du GeoAddresses dès le premier instant.

Carte et localisation

Les services du module GeoAddresses reposent sur l'intégration avec mapbox (mapbox.com) des services de cartographie et de localisation pour les développeurs, qui propose ses services gratuitement via une API pour tous ses produits, dans grand gammes d'utilisation, qui dans le cas de la consommation de GeoAddresses (forward geocoding) sont dans la limite de 50 000 services cartographiques et 100 000 requêtes de géolocalisation (04/03/2022 tous les deux mensuels). 

Vous pouvez consulter d'autres possibilités de service sur le site Web du fabricant mapbox.com.

GeoAddresses utilise les services de mapbox.com et n'est pas responsable des changements dans les conditions de service, ni dans les interfaces techniques utilisées pour l'intégration avec Dolibarr que ce fournisseur pourrait appliquer à ses produits à l'avenir.

Installation

Pour installer le module GeoAddresses, suivez les étapes habituelles d'installation de n'importe quel module dans Dolibarr.

Configuration

Avant de commencer à utiliser GeoAddresses, il est nécessaire de compléter un processus d'enregistrement d'utilisateur dans mapbox.com, à partir duquel les informations nécessaires sont obtenues pour pouvoir consommer ses services. Le registre active un panneau de contrôle où il est possible de consulter à tout moment la consommation des services mapbox.

Une fois l'enregistrement terminé, il suffit de terminer la configuration du module comme indiqué dans l'écran suivant :

Où :

• Système de projection : EPSG:3857

• URL du service : https://api.mapbox.com/geocoding/v5/mapbox.places /

• Nom du paramètre pour le jeton de sécurité : access_token

• jeton : celui attribué par mapbox.com dans la base de registre

Cas d'utilisation

Après l'installation et la configuration de GeoAddresses, un onglet nommé « Map » est activé dans les onglets d'informations des modules concernés : entrepôts, tiers (clients, clients potentiels, fournisseurs), et contacts.

 Lors de l'accès au contenu de cet onglet, le module effectue une requête auprès du service d'adresse mapbox, traite et envoie les données qui apparaissent comme l'adresse postale de l'objet Dolibarr en question et propose une tentative de localisation sur la carte. A ce moment, un enregistrement est inséré avec les données obtenues dans un état "brouillon" qui peut être validé visuellement par l'utilisateur. 

Accès aux services

L'écran suivant correspond à un client Dolibarr, et il présente les principaux éléments fonctionnels de l'intégration mapbox :

Où

1. Accès aux services

2. Moteur de recherche alternatif d'adresses : en cas de vérification que la localisation calculée automatiquement n'est pas valide, il est possible pour effectuer des recherches alternatives et établir l'emplacement à partir d'ici.

3. Marqueur : indique visuellement l'emplacement. Il est possible d'affiner ce repère par des actions de « drag & drop ». La couleur orange indique que l'adresse n'est pas validée, et la couleur verte indiquera que l'adresse a été validée.

4. Panneau d'information : offre des informations sur les coordonnées (longitude et latitude) du système de projection utilisé.

5. Commandes :

1. Valider : indique que l'information est validée

2. Rétablir la position : Si une modification manuelle a été effectuée, elle permet de remettre le repère dans sa position d'origine.

Validation des adresses

Validation rend le marqueur vert. Une fois qu'une adresse est validée, il est possible de revenir à l'état brouillon pour correction si une erreur est détectée.

Bonnes pratiques

Au moment de l'installation, il n'y a pas d'informations géographiques disponibles pour la base d'adresses existante, il peut donc être judicieux d'inclure une visite dans l'onglet carte et de valider les données de chaque client à chaque accès. 

Pour l'inscription de nouveaux clients, il est conseillé que les données des adresses postales suivent une nomenclature claire et propre, en faisant attention à la documentation des informations administratives standardisées (ville, code postal, province, région, pays). En règle générale, la ligne d'adresse peut être précisée comme suit :

1. Type de rue

2. rue Nom 

3. rue Numéro

4. Informations complémentaires (bloc, étage, escalier, porte…)