«SERVICES EN LIGNE - GEOCODAGE BD ADRESSE»



Documents pareils
Développer des Applications Internet Riches (RIA) avec les API d ArcGIS Server. Sébastien Boutard Thomas David

Nouveautés ArcGIS 10.1 for Server

NFA016 : Introduction. Pour naviguer sur le Web, il faut : Naviguer: dialoguer avec un serveur web

ArcGIS 10.1 for Server

Intégration ESRI - SAP Geo-Enablement de l ERP SAP Exemple : GEO.e. Christophe Lapierre Enrique Yaptenco Professional Services - ESRI Suisse

Conférence SIG 2011 Versailles 5-6 Octobre 2011 Atelier Technique ArcGIS for Server en 10.1

Didacticiel de mise à jour Web

TP JAVASCRIPT OMI4 TP5 SRC

FORMATION PcVue. Mise en œuvre de WEBVUE. Journées de formation au logiciel de supervision PcVue 8.1. Lieu : Lycée Pablo Neruda Saint Martin d hères

ArcGIS for INSPIRE SIG RAIL 2011

Serveur d'application Client HTML/JS. Apache Thrift Bootcamp

Développer avec les technologies ESRI. ESRI Developer Network (EDN) Gaëtan LAVENU ESRI France Jérémie MAJEROWICZ ESRI France

arcopole Studio Annexe 7 Architectures Site du programme arcopole :

ArcGIS. for Mobile. Comprendre notre monde

Déploiement, administration et configuration

arcopole Studio Version 3.3

ArcGIS Server 9.3 Partie 2. Les API d'accès à ArcGIS Server. Thomas DAVID Gaëtan LAVENU

MANUEL. de l application «CdC Online» pour Windows. Table des matières

RAPPORT AUDIT SEO. Élaboré à l'attention de : Monsieur Greber Élaboré par : Cédric Peinado

Optimiser pour les appareils mobiles

Mettre en place un Géoportail avec ArcGIS Server Armel OUEDRAOGO Pierre TEYSSENDIER

Qu est-ce que ArcGIS?

Support de TD ArcGIS Introduction à l automatisation et au développement avec ArcGIS 10.1 JEAN-MARC GILLIOT e année ingénieur

Service de certificat

Extended communication server 4.1 : VoIP SIP service- Administration

Matérialiser les données d une BdD : créer une carte de densité de points par maillage

Didacticiel du service cartographique en cache

TAGREROUT Seyf Allah TMRIM

Didacticiel des serveurs de bases de données

CONCOURS DE L AGRÉGATION INTERNE «ÉCONOMIE ET GESTION» SESSION 2015 SECONDE ÉPREUVE

Boîte à outils OfficeScan

NAS 109 Utiliser le NAS avec Linux

Gestion des documents associés

Programme TechDay Romandie

Guide de configuration de SQL Server pour BusinessObjects Planning

Démonstration de la mise en cache via HTML 5 sur iphone

Programmation Internet Cours 4

ArcGIS Server / 9.4. Gaëtan LAVENU Jean-Marie DULISCOUET

Les messages d erreur d'applidis Client

Manuel d'utilisation d'apimail V3

Connexion entre une BD FileMaker Pro 10 et ArcGis 10.x sous Windows 7

Exploration des technologies web pour créer une interaction entre Mahara et les plateformes professionnelles et sociales

CONFIGURER VOTRE HEBERGEMENT WINDOWS

ArcGIS 10 Christophe Tourret Gaëtan Lavenu

Guide d'utilisation du portail d'authentification Cerbère à usage des professionnels et des particuliers

Guide d utilisation. Table des matières. Mutualisé : guide utilisation FileZilla

Manuel Utilisateur de l'installation du connecteur Pronote à l'ent

Guide de déploiement

MANUEL D UTILISATION DES OUTILS «MapCERN»

Guide Utilisateur - Guide général d'utilisation du service via Zdesktop ou Webmail v.8. Powered by. - media-2001.communication &.

ContactForm et ContactFormLight - Gestionnaires de formulaire pour Prestashop Edité par ARETMIC S.A.

Par Daniel FAIVRE WebMapper ... Publication de cartes pour Internet avec ArcGis

ArcGIS. for Server. Comprendre notre monde

Guide Utilisateur - Guide général d'utilisation du service via Zdesktop ou Webmail v.8. Powered by. Version EXOCA 1

VM Card. Manuel des paramètres des fonctions étendues pour le Web. Manuel utilisateur

Manuel d'installation et de déploiement. Sécurité complète pour portables d entreprise

THEGREENBOW FIREWALL DISTRIBUE TGB::BOB! Pro. Spécifications techniques

Chapitre 2 Accès aux partages depuis votre système d'exploitation

L accès à distance du serveur

Esri Maps for IBM Cognos

Windows Serveur 2012 : DHCP. Installation et mise en place

Guide Google Cloud Print

HTML. Google Maps. Approfondir. 3 :HIKONB=^UZ^Z]:?k@l@g@h@a"; Codez une fois, déployez sur Android, ios, Kindle... Smartphones. Matériel.

Atelier Le gestionnaire de fichier

Qlik Sense Cloud. Qlik Sense Copyright QlikTech International AB. Tous droits réservés.

Qu'est-ce que c'est Windows NT?

Corrigé de l'atelier pratique du module 8 : Implémentation de la réplication

MANUEL D INSTALLATION D UN PROXY

Séminaire Partenaires Esri France 7-8 juin Paris La Road Map ArcGIS

Créer et partager des fichiers

NAS 208 WebDAV Une alternative au protocole FTP pour le partage sécurisé des fichiers

PHP 5.4 Développez un site web dynamique et interactif

HTML, CSS, JS et CGI. Elanore Elessar Dimar

HTTP Commander. Table des matières. 1-Présentation de HTTP Commander

Les Géodatabases en 9.2

ArcGIS Mobile 9.3. Cédric Pesty Gael Simon. Conférence SIG 2008 Ateliers Techniques. S'il vous plait! Merci d'éteindre vos appareils portables

F O R M A T I O N S LOTUS NOTES. 8.5 Utilisateurs rue de la Bôle. E U R L. a u c a p i t a l d e

Module d introduction Comment réaliser vos propres cartes avec ArcGIS Online

KWISATZ_TUTO_module_magento novembre 2012 KWISATZ MODULE MAGENTO

Initiation à html et à la création d'un site web

Observatoires du Bruit. Import des données du Classement sonore : Utilisation de l'outil VSMAP

Configurer ma Livebox Pro pour utiliser un serveur VPN

Créer une base de données

Séminaire Partenaires Esri France 7-8 juin Paris Cloud Computing Stratégie Esri

italc supervision de salle

API SMS CONSEIL HTTP V2.01. Sommaire. Documentation V1.0 au 21/05/2011

Séance d ED n 5 : HTML et JavaScript

PRODIGE V3. Manuel utilisateurs. Consultation des métadonnées

Guide de démarrage rapide

Installation de Windows 2000 Serveur

Gestionnaire d emploi du temps

Formation. Module WEB 4.1. Support de cours

Evolutions technologiques : ArcGIS Desktop. Mehdi HUGUET Thierry BABELAERE

TigerPro CRM Application mobile

Compte Rendu d intégration d application

INTERNET est un RESEAU D ORDINATEURS RELIES ENTRE EUX A L ECHELLE PLANETAIRE. Internet : interconnexion de réseaux (anglais : net = réseau)

< Atelier 1 /> Démarrer une application web

Géoréférencement et RGF93

Transcription:

«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

Sommaire 1. Contenu du document 3 2. Description du géocodage 4 2.1. Le géocodage dans ArcGIS 4 2.1.1. Utilisation des localisateurs dans ArcGIS Desktop 4 2.1.2. Utilisation du service de géocodage BD Adresse 5 2.1.3. Dans les API ou clients mobiles 6 2.1.4. Dans un client bureautique 6 3. Le référentiel de géocodage 7 4. Les localisateurs d'adresses 8 4.1. Description 8 4.2. Informations en sortie 8 5. Utilisation du service de géocodage BD Adresse 11 5.1. Client bureautique 11 5.1.1. Localisation d'une adresse 11 5.1.2. Géocodage par lot 14 5.2. Client web 16 5.2.1. Requêtes supportées en REST 16 5.2.2. Token 16 5.2.3. Exemple d'utilisation du service dans une application Javascript 17 5.2.4. Exemple d'utilisation du service dans une application Flex 20 6. Spécifications du service 22 6.1. Convention de nommage 22 6.2. Système de coordonnées 22 6.3. Les limites d'usage 23 7. Matrice de compatibilité 24 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 2

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 : http://www.esrifrance.fr/iso_album/docws_4.5.pdf 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 3

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 2.1.1. 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

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 http://help.arcgis.com/fr/arcgisdesktop/10.0/help/index.html#/na/002500000001000000/ 2.1.2. 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

2.1.3. 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. 2.1.4. 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

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

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. 4.1. 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

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 92195 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 92190 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 -84.392 32.722. 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

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

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 : https://tasks.esrifrance.fr/arcgis/services ou http://tasks.esrifrance.fr/arcgis/services 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. 5.1. Client bureautique 5.1.1. 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

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

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

Fig. 10 : Fonctionnalités de la barre d'outils de géocodage 5.1.2. 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

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

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). 5.2. 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. 5.2.1. Requêtes supportées en REST Géocodage unitaire : Instruction REST : findaddresscandidates Exemple d'url : http://tasks.esrifrance.fr/arcgis/rest/services/geocodage/geocodage_bdadresse_france/geocodeserver/fin daddresscandidates?street=&postal=&city=&singleline=rue+frederic+bartholdi+10600+la+chapelle+st +LUC&outFields=*&outSR=2154&f=json&token=IcIzN8rZldAePgNuJ87WQ1HHt7KOq9rFRTcv3todmLguW6Lsy90 RU Géocodage inverse unitaire : Instruction REST : reversegeocode Exemple d'url : http://tasks.esrifrance.fr/arcgis/rest/services/geocodage/bda_composite_beta7_cp/geocodeserver/reve rsegeocode?location=844113%2c+6524590&distance=100&outsr=2154&f=json&token=9woadzsfavmewhfk 6c.Imv1voFFmG0e4mTkL1Ry4g8WDAbQsHNiuv4ZUwcbp 5.2.2. 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 : http://mondomaine.com ou http://199.199.99.99:8080 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

5.2.3. 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" "http://www.w3.org/tr/html4/strict.dtd"> <html> <head> 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 17

<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="http://serverapi.arcgisonline.com/jsapi/arcgis/2.8/js/dojo/dijit/themes/tundra/tundra.css"> <script type="text/javascript" src="http://serverapi.arcgisonline.com/jsapi/arcgis/?v=2.8"></script> <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":6184411,"xmax":1077508,"ymax":6984513,"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("http://server.arcgisonline.com/arcgis/rest/services/esri_streetmap_world_2d/mapserver"); var tiledmapservicelayer = new esri.layers.arcgistiledmapservicelayer("http://services.esrifrance.fr/arcgis/rest/services/cs_raster_teleatlas/csrasterta_v29_fra_l93/mapserver?t oken=" + token); map.addlayer(tiledmapservicelayer); //locator = new esri.tasks.locator("http://sampleserver1.arcgisonline.com/arcgis/rest/services/locators/esri_geocode_usa/geocodeserver"); locator = new esri.tasks.locator("http://tasks.esrifrance.fr/arcgis/rest/services/geocodage/geocodage_bdadresse_france/geocodeserver?token=" + 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

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 : http://help.arcgis.com/en/webapi/javascript/arcgis/help/jshelp_start.htm 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 19

Fig. 14 : résultats de géocodage dans une page Javascript 5.2.4. 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

http://tasks.esrifrance.fr/arcgis/rest/services/geocodage/geocodage_bdadresse_france/geocodeserver?to 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 : http://resources.arcgis.com/en/help/flex-api/apiref/index.html Pour plus d'information sur la consommation d'un service de géocodage dans une application web, consulter : http://help.arcgis.com/en/arcgisserver/10.0/apis/soap/index.htm http://help.arcgis.com/en/arcgisserver/10.0/apis/rest/index.html 22/06/2012 Spécifications service de géocodage BD Adresse - v1.2 21

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

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

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 9.3.1 + - 10.00 à 10.03 + - 10.04 + - 10.1 + - 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 + 2.4 ArcGIS API for Flex + 2.4 ArcGIS API for Silverlight + 2.2 + 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