Geocoding addresses [Fiche expert]
- Stéphane Becker
- Bertrand Littel
- Karima EL AMRI
Fonctionnalité
Automate d'événement Geocoding addresses qui permet de géocoder les adresses de différentes tables.
Automate
Paramétrage par défaut :
Jours de la semaine : Tous
Jours du mois : Tous
Mois de l’année : Tous
Horaires fixes :
23:00
Intervalle d’exécution : /
Principe de fonctionnement
La géolocalisation d’une adresse consiste à résoudre les coordonnées GPS (latitude, longitude) d’une adresse.
Toute table avec des informations d’adresses peut faire l’objet d’un mécanisme de géolocalisation.
La table doit donc contenir les informations (colonnes) qui constituent l’adresse et aussi des colonnes pour stocker les coordonnées GPS ainsi que la date de calcul, la précision et la clé (hash) de l’adresse qui a été utilisée lors de la résolution.
Les lignes des tables avec des adresses, et donc des coordonnées GPS, pourront alors faire l’objet d’affichage sur une carte, d’intégration à des tournées de visites à partir d’un client pivot, etc…
Les colonnes de l’adresse qui doivent être présentes sur la table sont :
Nom de la colonne | Contenu | Détails |
|---|---|---|
Street | Rue avec numéro | La position du numéro dans cette donnée peut être différente selon pays (en début ou en fin d’indication de la rue) |
City | Ville |
|
PostalCode | Code postal |
|
Country | Pays | NB : veillez à utiliser les code normalisés des pays (notamment ISO3) |
Concernant les colonnes de résultat de géolocalisation, qui doivent aussi être présente sur la table, voici leur description détaillée :
Nom de la colonne | Type | Détails |
|---|---|---|
gpsLatitude | FLOAT | Stocke le résultat : latitude de l’adresse |
gpsLongitude | FLOAT | Stocke le résultat : longitude de l’adresse |
gpsUpdateDate | DATETIME | Stocke le résultat : date de calcul de la géolocalisation. Si cette colonne n’est pas renseignée, l’adresse sera à nouveau géolocalisée |
gpsPrecision | INT | Stocke le résultat : précision de géolocalisation. Plusieurs précisions sont possibles et dépendent de la demande de précision lors du traitement Le moteur de géolocalisation peut ne pas trouver la précision demandée (par exemple : « adresse ») dans le cas d’une adresse inconnue (par exemple : nom de rue invalide) et fournir une précision plus faible (par exemple : « ville ») Les valeurs possibles ici sont :
|
| VARCHAR | Stocke le résultat : hash de l’adresse utilisée lors du géocodage. Lors de l’exécution des géocodages successifs, seules les adresses qui ne correspondent plus à leur « hash » feront l’objet d’une réévaluation de leurs coordonnées GPS (géolocalisation), et un nouveau hash sera donc regénéré. |
La géolocalisation nécessite aussi de connaitre le pays de l’adresse.
Ce pays peut être indiqué sur la ligne de l’adresse ou faire l’objet d’un paramétrage « pays par défaut ».
Le projet doit aussi avoir les autorisations de géolocalisation sur le pays. Cela fait partie des options commerciales du projet.
De plus, cela permet d’éviter les géolocalisations invalides (cas d’un pays mal renseigné sur un ensemble de lignes d’adresses).
La spécification de la table et des colonnes se fait dans le paramétrage de l’action « Geocoding » dans le Studio.
Illustration de l’interface de paramétrage, sur la table sw_data_customeraddress (« adresse client ») :
Actions
[SWB v4] Geocoding (Company)
Type d'action : Géocodage
Description : Géocodage de l’adresse des sociétés (sw_data_companyinfo) si les coordonnées GPS ne sont pas mises à jour manuellement (sw_data_companyinfo..gpsManual=1)
[SWB v4] Geocoding (User)
Type d'action : Géocodage
Description : Géocodage de l'adresse des utilisateurs (sw_data_baseuser) si les coordonnées GPS ne sont pas mises à jour manuellement (sw_data_baseuser..gpsManual=1)
[SWB v4] Geocoding (BranchOffice)
Type d'action : Géocodage
Description : Géocodage de l'adresse des agences (sw_data_branchoffice) si les coordonnées GPS ne sont pas mises à jour manuellement (sw_data_branchoffice..gpsManual=1)
[SWB v4] Geocoding (CustomerContact)
Type d'action : Géocodage
Description : Géocodage de l'adresse des contacts des tiers (sw_data_customercontact) si les coordonnées GPS ne sont pas mises à jour manuellement (sw_data_customercontact..gpsManual=1)
[SWB v4] Geocoding (Customer)
Type d'action : Géocodage
Description : Géocodage de l’adresse des tiers (sw_data_customer) si les coordonnées GPS ne sont pas mises à jour manuellement (sw_data_customer..gpsManual=1)
[SWB v4] Geocoding (Address)
Type d'action : Géocodage
Description : Géocodage des adresses des tiers (sw_data_customeraddress) si les coordonnées GPS ne sont pas mises à jour manuellement (sw_data_customeraddress..gpsManual=1)