«SERVICES EN LIGNE - GEOCODAGE BD ADRESSE»

Transcription

1 «SERVICES EN LIGNE - GEOCODAGE BD ADRESSE» SERVICES DE GEOCODAGE BD ADRESSE 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 1

2 Sommaire 1. Contenu du document 3 2. Description du géocodage Le géocodage dans ArcGIS Utilisation des localisateurs dans ArcGIS Desktop Utilisation du service de géocodage BD Adresse Dans les API ou clients mobiles Dans un client bureautique 6 3. Le référentiel de géocodage 7 4. Les localisateurs d'adresses Description Informations en sortie 8 5. Utilisation du service de géocodage BD Adresse Client bureautique Localisation d'une adresse Géocodage par lot Client web Requêtes supportées en REST Token Exemple d'utilisation du service dans une application Javascript Exemple d'utilisation du service dans une application Flex Spécifications du service Convention de nommage Système de coordonnées Les limites d'usage Matrice de compatibilité 24 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 2

3 1. Contenu du document Ce document décrit les spécifications du service en ligne «Géocodage BD Adresse» fournit par ESRI France. De nombreux utilisateurs des produits Esri ont demandé à Esri France un service prêt à emploi utilisant les données de la BD Adresse de l IGN. Esri France a donc conçu le produit «Géocodage BD Adresse» en partenariat avec l IGN pour répondre aux sollicitations de ses utilisateurs. La valeur ajoutée apportée par Esri France est forte : Accès à un géocodeur fiable, robuste et performant, Utilisation directe depuis les produits ArcGIS Desktop ou les Web Applications utilisant la technologie REST, Support et maintenance du service. Ce document décrit le service en ligne Esri France ainsi que les caractéristiques techniques de celui-ci. Ce document n est pas un descriptif du produit BD Adresse. Ce document ne décrit pas le produit BD adresse Premium for ArcGIS dont les spécifications sont disponibles sur demande. Ce document ne décrit pas l'ensemble des services en ligne Esri France dont la documentation est disponible à l'adresse suivante : 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 3

4 2. Description du géocodage Afin d'assurer les fonctionnalités de géocodage et géocodage inverse de données décrit dans ce document, le produit BD Adresse Premium for ArcGIS est utilisé. Celui-ci inclut des localisateurs au code postal. Ces localisateurs permettent d'assurer ces la fonctionnalité de géocodage et reverse géocodage dans l'environnement ArcGIS. Le service peut être utilisé soit dans des clients bureautiques de type ArcGIS for Desktop soit dans différents clients légers de la gamme ArcGIS (API, ArcGIS Mobile etc) 2.1. Le géocodage dans ArcGIS Le géocodage dans ArcGIS peut se faire soit en utilisant directement des localisateurs d'adresses dans ArcGIS for Desktop (avec le produit BD Adresse Premium for ArcGIS par exemple), soit au travers de la connexion à un service de géocodage publié par ArcGIS for Server. Fig. 1 : le géocodage dans ArcGIS Utilisation des localisateurs dans ArcGIS Desktop Dans ArcGIS for Desktop le géocodage peut être distingué selon deux modes : - le mode unitaire - le mode de masse ou de batch Le géocodage unitaire consiste à localiser une adresse dans une interface dédiée. Ceci peut se faire dans ArcGIS for Desktop soit à l'aide de la fenêtre 'Rechercher', soit à l'aide de la barre d'outils 'Géocodage d'adresses'. 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 4

5 Fig. 2 : les barres d'outils et fonctionnalités de géocodage dans ArcMap Les fonctionnalités d'appariement interactif et géocodage inverse sont également disponibles et utilisables dans ArcGIS for Desktop en utilisant les localisateurs BD Adresse. Fig. 3 : les outils de géo-traitement et de reprise interactive dans ArcGIS for Desktop Pour plus d'information sur le processus de géocodage dans ArcGIS for Desktop consulter Utilisation du service de géocodage BD Adresse Le géocodage unitaire ou par lot peut être également réalisé par l'usage d'un service de géocodage. Par exemple, un client ArcGIS for Desktop peut directement, au travers de l'infrastructure de services en ligne Esri France, assurer ces fonctions. Le service de géocodage BD Adresse peut également être consommé dans les API ArcGIS for Server ou par les différents types de client Esri au travers des protocoles REST et/ou SOAP. 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 5

6 Dans les API ou clients mobiles Le géocodage se fait au travers d'une connexion au service de géocodage publié par Esri France Dans un client bureautique Ce service est disponible dans un client ArcGIS for Desktop pour réaliser du géocodage unitaire ou par lot. Les fonctionnalités de géocodage inverse et interactif sont également possibles au travers de ce service. 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 6

7 3. Le référentiel de géocodage Le référentiel de géocodage utilisé par le service Esri France est le produit BD Adresse IGN incluant Point Adresse et Route Adresse. De cette base de données, un référentiel de géocodage est dérivé par Esri France. Ce référentiel correspond au produit BD Adresse Premium for ArcGIS. Ce référentiel est issu des données sources BD Adresse IGN desquelles ont été extraites les données nécessaires au géocodage. Ces données ont été optimisées pour le géocodage sous ArcGIS. Les traitements réalisés sont notamment : - Sélection des entités concernées par chaque niveau de géocodage, - Correction de codes Insee et postaux, - Doublonnage de voies, adresses en limites de commune ou zones postales, - Suppression d'entités ne permettant pas le géocodage, - Suppression des doublons, - Affectation des codes INSEE et postaux le cas échéant, - etc Pour plus d'informations sur le produit BD Adresse Premium for ArcGIS, contacter Esri France. 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 7

8 Localisateurs d'adresses 4. Les localisateurs d'adresses Le service de géocodage BD Adresse Esri France est issu d'un localisateur d'adresses composite. Celui-ci géocode en cascade sur différents niveaux d'adresses Description Les localisateurs utilisés par le service de géocodage BD Adresse sont les suivants : Nom Description Geocodage_BDAdresse_France Localisateur Composite du service en ligne BD Adresse sur la France 1_PointAdresse Localisateur permettant le géocodage au ponctuel adresse 2_AdresseInterpolee Localisateur permettant le géocodage à l'adresse par interpolation 3_Voie Localisateur permettant le géocodage au centroïde de voie 4_LieuDitHabite Localisateur permettant le géocodage au lieu-dit-habité 5_ChefLieu Localisateur permettant le géocodage au chef-lieu de commune 6_CodePostal Localisateur permettant le géocodage au code postal 7_Ville Localisateur permettant le géocodage au nom de la ville Fig. 4 : Descriptif des localisateurs utiisés par le service de géocodage 4.2. Informations en sortie Après le géocodage d'une table d'adresses ou après une localisation unitaire, les informations en sortie sont celles de l'adresse initiale complétées de champs additionnels liés au processus de géocodage. L'un des objectifs du transfert des champs d'adresse est le ré-appariement. Le préfixe ARC_ est ajouté aux noms de cet ensemble de champs d'adresse. Par ailleurs, voici les autres informations en sortie pour les résultats de géocodage : Loc_name Nom du localisateur participant utilisé pour l'appariement de l'adresse. Ce champ est disponible uniquement lorsque le localisateur composite 'Geocodage_BDAdresse_Zone' est utilisé. Cette information va permettre en fin de géocodage d'avoir une indication sur le niveau de géocodage de l'adresse. Etat Code indiquant si l'adresse a été appariée. Cet attribut prend les valeurs suivantes : M Apparié. L'adresse est appariée. U Non appariée. L'adresse n'est pas appariée. T Multiples. L'adresse a plusieurs candidats avec le même meilleur score d'appariement, mais à des emplacements différents. 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 8

9 Score Score d'appariement du candidat auquel l'adresse a été appariée. Le score peut se trouver dans une plage de 0 à 100, où 100 indiquent que le candidat est en correspondance parfaite entre le référentiel et l'adresse saisie. Match_type Code indiquant le mode d'appariement d'une adresse. Vous pouvez grouper les résultats en fonction de cet attribut pour montrer le type d'appariement des adresses ou pour sélectionner des enregistrements à ré-apparier. A Apparié ou ré-apparié automatiquement. M Apparié manuellement ou non apparié. Si les classes d'entités géocodées sont ré-appariées à l'aide de la boîte de dialogue Ré-appariement interactif, le champ peut avoir le code M lorsque vous appariez ou annulez l'appariement manuellement à l'aide du bouton Apparier ou Ré-apparier. PP Sélection par point. L'adresse a été appariée au point de clic à l'aide de l'outil Adresse dans la carte dans la boîte de dialogue Ré-appariement interactif dans ArcMap. PA Sélection par adresse. L'adresse a été appariée à l'adresse la plus proche à l'aide de l'outil Adresse dans la carte dans la boîte de dialogue Ré-appariement interactif dans ArcMap. Match_addr Adresse réelle de la localisation appariée d'après les données du candidat apparié. Par exemple, une adresse en entrée '21 Rue des capucins Meudon' est appariée à un candidat portant le code postal '92190', tous les autres composants étant appariés correctement. Le champ Match_addr contient alors '21 Rue des capucins Meudon' comme adresse réelle d'appariement. Addr_type Le type d'adresse géocodée. Cet attribut a les valeurs suivantes : Adresse Adresse. Intersection Adresse d'intersection qui contient un connecteur d'intersection. Coordonnées Coordonnées géographiques, par exemple SpatialOperator Emplacement qui contient une distance de décalage par rapport à l'adresse trouvée. MGRS Emplacement du Système militaire de quadrillage de référence (MGRS). Côté Le côté de la rue auquel l'adresse a été appariée. Ce champ est disponible si le localisateur d'adresses utilisé pour l'appariement de la table contient les informations d'adresse des deux côtés de la rue. Cet attribut a les valeurs suivantes : L L'adresse est appariée sur le côté gauche de la rue. R L'adresse est appariée sur le côté droit de la rue. Aucune valeur L'adresse n'est pas appariée, ou le localisateur n'a pas pu déterminer le côté de la rue. User_fld Ce champ contient une information provenant de la base de données source BD Adresse. En fonction des niveaux de géocodage cette information est variable. Par exemple, dans le cas d'un géocodage au 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 9

10 Localisateurs d'adresses lieu-dit habité, l'information renvoyée dans ce champ est le nom du département correspondant au lieu-dit. Cette information est important notamment lorsque plusieurs candidats de même score sont retournés par le localisateur, cela permet de distinguer et choisir la bonne localisation. Ci-dessous le détail par localisateur des informations User_fld retournées en fin de géocodage : Nom Valeur User_fld Geocodage_BDAdresse_France N/A 1_PointAdresse Type de localisation du point adresse en accord avec la documentation BD Adresse. 2_AdresseInterpolee N/A 3_Voie Code INSEE de la voie. 4_LieuDitHabite Nature du lieu-dit habité. 5_ChefLieu Nom du département d'appartenance du chef-lieu de commune. 6_CodePostal Nom du département d'appartenance du code postal. 7_Ville Nom du département d'appartenance de la ville. Fig. 5 : Description des valeurs du champ utilisateur Il existe également des champs facultatifs si les options concernées ont été activées dans les propriétés du localisateur d'adresses lors du géocodage. Pct_along Pour les localisateurs d'adresses utilisant des classes d'entités à géométrie polyligne comme données de référence, Pct_along (avec pourcentage) précise où se trouve l'adresse appariée le long de l'entité de référence sous la forme d'un pourcentage de la longueur totale de l'entité. Le pourcentage est mesuré le long du sens de numérisation de l'entité linéaire. Ceci est notamment le cas pour le géocodage à l'adresse interpolée par exemple. Ref_ID Identifiant de référence de l'entité appariée. Stan_addr Adresse standardisée. X Coordonnée X de l'adresse appariée. Y Coordonnée Y de l'adresse appariée. 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 10

11 5. Utilisation du service de géocodage BD Adresse Le service de géocodage BD Adresse permet de localiser une adresse géographique par simple saisie, mais aussi de géocoder un listing d adresse complet, respectant certaines normes. Il est intégrable dans une architecture par simple connexion au serveur SIG depuis ArcGIS for Desktop via le protocole HTTPS ou via le protocole HTTP. Les URL de connexion sont les suivantes : ou Fig. 6 : Interface de connexion au serveur de géocodage NB : Il est conseillé d'utiliser la connexion sécurisée https en lieu et place d'http afin de s'affranchir du message informatif à la connexion au service Client bureautique Localisation d'une adresse L exemple ci-dessous montre l usage du service de géocodage BD Adresse pour localiser une adresse dans ArcMap : 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 11

12 Fig. 7 : Exemple d'usage du service de géocodage dans ArcGIS for Desktop Il est également possible d'utiliser la barre d'outil 'Géocodage d'adresses' dans ArcMap pour effectuer une localisation d'adresse. Cette barre d'outils permet de charger un service de géocodage en vous connectant au serveur Esri France. Fig. 8 : Barre d'outils géocodage et de gestion des localisateurs Après avoir ouvert la connexion au serveur SIG, vous trouverez dans le répertoire 'GEOCODAGE' les services de géocodage BD Adresse disponibles : 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 12

13 Fig. 9 : Interface de connexion au serveur de géocodage Il est dès lors possible de rechercher une adresse directement depuis la barre d'outils 'géocodage d'adresses' et profiter des fonctionnalités attenantes à cette opération : 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 13

14 Fig. 10 : Fonctionnalités de la barre d'outils de géocodage Géocodage par lot Pour le géocodage de lots d adresses, il est nécessaire que le listing comporte un champ d adresses standardisées, un champ comportant le code postal et contenant le nom de la commune de rattachement. Il est ensuite possible de géocoder le fichier d adresses dans ArcGIS, avec les outils de géocodage en batch. Celui-ci peut être soit réalisé depuis ArcCatalog, avec les outils de géo traitements ou à l'aide de la barre d'outils 'Géocodage d'adresses'. Exemple de géocodage par lot depuis ArcMap : 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 14

15 Fig. 11 : Géocodage par lors d'une table d'adresses Une fois le service BD Adresse choisi, il convient de définir les champs de la table à géocoder puis, après avoir validé les paramètres, le géocodage du lot d adresses commence. Fig. 12 : Appariement des champs pour géocodage par lot 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 15

16 NB : Il est à noter que le service en ligne Esri France de géocodage BD Adresse ne permet pas la modification des paramètres de chaque localisateur d'adresses (Geocoding Options) Client web L'utilisation en mode web du service BD Adresse se fait au travers de l'usage du 'Geocode Server', celui-ci pouvant être appelé au travers d'un appel REST ou SOAP au serveur de publication Requêtes supportées en REST Géocodage unitaire : Instruction REST : findaddresscandidates Exemple d'url : daddresscandidates?street=&postal=&city=&singleline=rue+frederic+bartholdi la+chapelle+st +LUC&outFields=*&outSR=2154&f=json&token=IcIzN8rZldAePgNuJ87WQ1HHt7KOq9rFRTcv3todmLguW6Lsy90 RU Géocodage inverse unitaire : Instruction REST : reversegeocode Exemple d'url : rsegeocode?location=844113%2c &distance=100&outsr=2154&f=json&token=9woadzsfavmewhfk 6c.Imv1voFFmG0e4mTkL1Ry4g8WDAbQsHNiuv4ZUwcbp Token Le token (clef d accès permettant l'authentification au service) vous est délivré par les administrateurs du service et associé à votre compte d accès. Celui-ci est attaché au referer de votre application. Le referer correspond à l ip ou au nom de domaine du serveur qui hébergera l application utilisant les services de géocodage BD Adresse. Par exemple : ou Il prend la forme d une chaine de caractères à intégrer dans le code des applications. 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 16

17 Exemple d'utilisation du service dans une application Javascript Il est possible de mettre en œuvre l accès au service de géocodage dans une page web utilisant l API (Application Programming Interface) ArcGIS API for Javascript : Fig. 13 : Exemple de page Javascript implémentant le service de géocodage BD Adresse Le code de la page «GeocodeAdresse.html» est : <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" " <html> <head> 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 17

18 <meta http-equiv="content-type" content="text/html; charset=utf-8"/> <meta http-equiv="x-ua-compatible" content="ie=7" /> <title>find Address</title> <link rel="stylesheet" type="text/css" href=" <script type="text/javascript" src=" <script type="text/javascript"> dojo.require("esri.map"); dojo.require("esri.tasks.locator"); var map, locator; function init() { // Token associé à votre compte, vous devez mettre celui qui vous sera fourni par Esri france var token = 'j6mnbauh9bxjjrnbzgjzgkl3utidpoo8ijyukaflwurdvhgpdr3sknyb1jhgghjghjgfsdcu1m0po3rbibzh-'; var initextent = new esri.geometry.extent({"xmin":132943,"ymin": ,"xmax": ,"ymax": ,"spatialreference":{"wkid":2154}}); //map = new esri.map("map", { extent: new esri.geometry.extent(-125, 28, -62, 45, new esri.spatialreference({wkid:4326})) }); map = new esri.map("map", initextent); //var tiledmapservicelayer = new esri.layers.arcgistiledmapservicelayer(" var tiledmapservicelayer = new esri.layers.arcgistiledmapservicelayer(" oken=" + token); map.addlayer(tiledmapservicelayer); //locator = new esri.tasks.locator(" locator = new esri.tasks.locator(" + token); dojo.connect(locator, "onaddresstolocationscomplete", showresults); } function locate() { map.graphics.clear(); var add = dojo.byid("address").value.split(","); var address = { Street : add[0], Postal: add[1], City: add[2] }; // Variante //var address = {"SingleLine":dojo.byId("address").value}; locator.addresstolocations(address,["loc_name"]); } function showresults(candidates) { var candidate; var symbol = new esri.symbol.simplemarkersymbol(); var infotemplate = new esri.infotemplate("location", "Address: ${address}<br />Score: ${score}<br />Source locator: ${locatorname}"); symbol.setstyle(esri.symbol.simplemarkersymbol.style_diamond); symbol.setcolor(new dojo.color([255,0,0,0.75])); var points = new esri.geometry.multipoint(map.spatialreference); for (var i=0, il=candidates.length; i<il; i++) { candidate = candidates[i]; if (candidate.score > 70) { var attributes = { address: candidate.address, score:candidate.score, locatorname:candidate.attributes.loc_name }; var graphic = new esri.graphic(candidate.location, symbol, attributes, infotemplate); map.graphics.add(graphic); map.graphics.add(new esri.graphic(candidate.location, new esri.symbol.textsymbol(attributes.address).setoffset(0, 8))); points.addpoint(candidate.location); } } map.setextent(points.getextent().expand(3)); } dojo.addonload(init); </script> <style> body { color:black; 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 18

19 background-color:white; background-image:url(arcgis_background.jpg); background-repeat:no-repeat; } </style> </head> <body class="tundra" style="body"> Adresse : <input type="text" id="address" size="60" value="64 chemin des mouilles, 69130, Ecully" /> <i>(adresse, CP, Ville)</i> <input type="button" value="localiser" onclick="locate()" /><br /> <br /> <div id="map" style="width:700px; height:700px; border:1px solid #000;"></div> </body> </html> En mettant une adresse respectant la structure : «adresse + virgule + code postale + virgule + nom de ville» et en cliquant su le bouton «Localiser» des points «cliquables» montrant les résultats seront affichés. Pour plus d'informations sur ArcGIS API for Javascript, consulter : 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 19

20 Fig. 14 : résultats de géocodage dans une page Javascript Exemple d'utilisation du service dans une application Flex L utilisation du service de géocodage dans une application Flex utilisant ArcGIS API for FLEX peut être très facilement réalisé en utilisant le Widget Locate/Geocode. Il convient pour cela de configurer dans la balise <geocode_server> du fichier de configuration «GeocodeWidget.xml»: le service de géocodage BD Adresse Esri France 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 20

21 ken=xxxxxxxxxxxxxxxxxxx Le token correspond à la clef d accès généré par Esri france selon votre code d'accès. Fig. 15 : Fichier de configuration du widget 'Geocode' du sample Flex Vieuwer Pour l utilisation directe dans l API d'un Geocode Server consulter : Pour plus d'information sur la consommation d'un service de géocodage dans une application web, consulter : /06/2012 Spécifications service de géocodage BD Adresse - v1.2 21

22 6. Spécifications du service 6.1. Convention de nommage La convention de nommage des services suit la règle suivante : Geocodage_BDAdresse_<Unité territoriale> Par exemple pour le service de géocodage BD Adresse sur la France le service porte le nom suivant : Geocodage_BDAdresse_France Les unités territoriales possibles sont les suivantes : Unité territoriale France Guadeloupe Martinique Réunion Guyane Couverture France continentale et Corse Guadeloupe Martinique Réunion Guyane Fig. 16 : Unités territoriales et couverture 6.2. Système de coordonnées Par défaut, chaque service renvoi les coordonnées dans le système géodésique de référence du territoire concerné. Ces systèmes sont les suivants : Unité territoriale France Guadeloupe Martinique Réunion Guyane Projection RGF93 UTM 20N WGS84 UTM 20N WGS84 UTM 40S RGR92 UTM 22N RGFG95 Fig. 17 : Unités territoriales et systèmes de coordonnées NB : Le système de coordonnées peut être modifié lors de l'opération de géocodage. 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 22

23 6.3. Les limites d'usage Les services de géocodage BD adresse utilisent un mode de sécurisation par token. Il est conseillé d'utiliser le mode https afin de crypter la transmission de celui-ci entre le serveur et le client. L'usage du service en ligne ne permet pas l'accès et la modification à la volée des paramètres de géocodage de chaque localisateur implémenté dans le service de géocodage. Les pages de description REST des services Esri France ne permettent pas l'utilisation des fonctions de géocodage et géocodage inverse. Seule la description des services est disponible. Celle-ci décrit les champs exposés en sortie de géocodage. 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 23

24 Consommation d'un service de géocodage 7. Matrice de compatibilité Les localisateurs d'adresses utilisés pour le service de géocodage BD Adresse étant produits avec le nouveau moteur de géocodage en version 10, il est conseillé d'utiliser une version 10 service Pack 4 ou supérieure. Versions Compatibilité Version ArcGIS for Desktop à ArcGIS SDKs ArcGIS RunTime SDK for IOS + ArcGIS RunTime SDK for Android + ArcGIS RunTime SDK for Windows Mobile + ArcGIS RunTime SDK for Windows Phone + ArcObjects SDKs + ArcGIS APIs ArcGIS API for Javascript ArcGIS API for Flex ArcGIS API for Silverlight Disponible - Disponible avec limitations o Non disponible Fig. 18 : Matrice de compatibilité [Fin de document] 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 24