... French Géoportail API v. 1.2.4 User Guide.... Institut National de l'information Géographique et Forestière - France

... French Géoportail API v. 1.2.4 User Guide... Institut National de l'information Géographique et Forestière - France 06/29/2015

Table of Contents i Table of Contents... 1. Table of Contents........................................................... i 2. Forewords................................................................... 1 3. License...................................................................... 4 4. Historical.................................................................... 5 5. ChangeLog.................................................................. 7 6. Prerequisites............................................................... 27 7. Overview.................................................................... 29 8. Geoportal layers........................................................... 31 9. Coordinates Reference Systems......................................... 38 10. Controls.................................................................... 40 11. Using the loader........................................................... 51 12. Using the JS API.......................................................... 59 13. Adding layers.............................................................. 67 13..1. Adding vector layers.......................................................... 70 13..2. Adding image layers.......................................................... 75 Adding controls............................................................ Changing styles............................................................ Changing srs............................................................... GPS positionning.......................................................... Adding a proxy............................................................ Multi-keys................................................................... Multi-lingual............................................................... Using the Flash API...................................................... Adding layers............................................................. 77 14. 15. 16. 17. 18. 19. 20. 21. 22. 83 87 89 93 97 100 102 106 22..1. Adding layers in MXML...................................................... 107 22..2. Adding layers in as.......................................................... 112 23. 24. 25. 26. 26. 26. 26. 26. Adding controls........................................................... Compiling.................................................................. OpenLayers............................................................... Advanced WMTS layers.................................................. API key.................................................................... Advanced search services............................................... Advanced elevation service.............................................. Multi-lingual............................................................... 119 121 122 123 126 135 153 164

Table of Contents ii

1 Forewords 1 1 Forewords... 1.1 Avant propos API Web 2D API Web 2D en Javascript API Web 2D en Flex API 3D L'API du Géoportail a pour but de permettre la superposition des couches métiers utilisateurs avec les référentiels Géoportail pour différents types d'applications cartographiques. Le schéma ci-dessus décrit son fonctionnement: architecture

1 Forewords 2 On distingue trois parties principales : les composants côté serveur : Les entrepôts de données sont gérés ici. Ils peuvent être sous un gestionnaire de base de données (postgresql, mysql, Oracle, Informix, ArcSDE, etc...) ou directement sur le système de fichiers sous forme de répertoires de fichiers (cache, arborescences). les services : Ces entrepôts sont accessibles par des services (Web Map Service, Web Feature Service,...) ou par des transferts HTTP classiques (Keyhole Markup Language,...). L'accès à ces services est protégé par le contrôle des droits d'accès: chaque requête aux serveurs nécessite une clef d'accès. les composants côté client : L'API cliente est chargée ici. 1.2 API Web 2D Disponible dans deux langages de programmation (JavaScript et Flex), elle permet d'intégrer les référentiels Géoportail dans un site Web via un client cartographique. L'utilisation de l'api en Flex n'est cependant pas encouragée du fait de l'obsolescence de la technologie flash. 1.2.1 API Web 2D en Javascript Réalisée en JavaScript et basée sur la bibliothèque OpenLayers (logiciel libre sous licence BSD), elle surcharge les librairies de cette dernière pour apporter de nouvelles fonctionnalités comme des contrôleurs, des visualiseurs,... Toutes ces fonctionnalités sont accessibles d'une manière très simple grâce à la classe Geoportal.Map, qui encapsule toute la puissance de l'api derrière quelques méthodes. Les développeurs peuvent également utiliser l'intégralité des fonctions OpenLayers. Les livraisons sont construites sur différentes versions d'openlayers. Un exemple est donné là. les composants côté client : Pour le client Web 2D, son architecture interne est la suivante : Bibliothèques OpenSource utilisées : Prototype Javascript Framework (jusqu'à 1.0beta2), Script.aculo.us - Web 2.0 javascript (jusqu'à 1.0beta2), PROJ4JS, OpenLayers, NaturalDocs (depuis 1.0beta3) Sarissa (depuis 1.0beta3) la bibliothèque Geoportal Cette bibliothèque met en oeuvre la charte graphique de l'api.

1 Forewords 3 1.2.2 API Web 2D en Flex Réalisée en Flex et basée sur le projet open source OPENSCALES (licence LGPL v3), elle surcharge les librairies de ce dernier pour apporter de nouvelles fonctionnalités. Elle permet ainsi d'intégrer les données du Géoportail dans une application flash. Un exemple est donné là. 1.3 API 3D Réalisée en javascript, l'api 3D permet d'intégrer dans une page web le globe virtuel VirtualGeo avec les données du Géoportail. Un exemple est donné là.

2 License 4 2 License... 2.1 Licence BSD Copyright (c) 2008-2015, Institut National de l'information Géographique et Forestière France Tous droits réservés. La redistribution du code source, modifié ou non, sous forme de binaire est soumise aux conditions suivantes : Le copyright ci-dessus, la présente liste des conditions et l'avertissement qui la suit doivent figurer dans le code source. La documentation et/ou les fichiers accompagnant le code source distribué sous forme de binaire doivent faire apparaître le copyright ci-dessus, la présente liste des conditions et l'avertissement qui la suit. Le nom de l'institut National de l'information Géographique et Forestière, pas plus que ceux de ses collaborateurs, ne sauraient être utilisés dans le but de promouvoir ou de légitimer un produit dérivé de ce programme sans autorisation écrite préalable à cet effet. CE PROGRAMME EST FOURNI «TEL QU'EN L'ÉTAT» PAR LES MEMBRES DU CONSEIL D'ADMINISTRATION ET LEURS COLLABORATEURS ET IL N'EST DONNÉ AUCUNE GARANTIE, IMPLICITE OU EXPLICITE, QUANT À SON UTILISATION COMMERCIALE, PROFESSIONNELLE OU AUTRE. LES MEMBRES DU CONSEIL D'ADMINISTRATION ET LEURS COLLABORATEURS NE PEUVENT EN AUCUN CAS ÊTRE TENUS POUR RESPONSABLES DE QUELQUE DOMMAGE OU PRÉJUDICE DIRECT, INDIRECT, SECONDAIRE OU ACCESSOIRE (Y COMPRIS LES PERTES FINANCIÈRES DUES AU MANQUE À GAGNER, À L'INTERRUPTION D'ACTIVITÉS, OU LA PERTE D'INFORMATIONS ET AUTRES) DÉCOULANT DE L'UTILISATION DU PROGRAMME, OU DE L'IMPOSSIBILITÉ D'UTILISER CELUI-CI, ET DONT L'UTILISATEUR ACCEPTE L'ENTIÈRE RESPONSABILITÉ. Le texte de la licence en anglais est donné là.

3 Historical 5 3 Historical... 3.1 Historique des versions Les livraisons de l'api Web 2D en Javascript sont construites sur différentes versions d'openlayers : Date de livraison Version Fonctionnalités 2 avril 2015 2.1.2 Version correctrice de bugs Voir les évolutions. 24 novembre 2014 2.1.1 Gestion du service d'altimétrie de la plateforme Géoportail Voir les évolutions. 27 mai 2014 2.1 OpenLayers 2.12, nouvelle procédure de compilation. Voir les évolutions. 9 juillet 2012 2.0 Accès à l'infrastructure du Géoportail 3. Remplacement du WMSC par le WMTS, support du HTTPS, refonte de la gestion des droits d'accès... Voir les évolutions. 20 février 2012 1.3 OpenLayers 2.11, introduction des interfaces pour les visualisateurs, d'un chargeur exposant des fonctionnalités liées avec la version 2.0 à venir mi-2012. Voir les évolutions. 17 janvier 2011 1.2 OpenLayers 2.10, les données vectorielles sont dorénavant chargés en utilisant OpenLayers.Protocol et OpenLayers.Strategy sans impact sur l'api elle-même et pour se rapprocher d'openlayers 3.0. 2 août 2010 1.1 OpenLayers 2.9.1. 15 mars 2010 1.0 OpenLayers 2.8, support expérimental des ExtendedData pour KML. Voir les évolutions. Analyse des capacités WMS (1.3.0) et WFS (1.1.0). Les accès OpenLS sont dorénavant protégés par GeoDRM.

3 Historical 6 6 mai 2009 1.0beta4 Séparation entre le visualisateur et la carte en préparation de la version 1.0 : il est nécessaire de modifier les pages pour passer à cette version comme indiqué dans les évolutions. Introduction des API minimum, standard et étendue. Ajout du support de la recherche par OpenLS (Location Utility Service). Expérimental. 4 novembre 2008 1.0beta3 OpenLayers 2.7, support préliminaire en écriture du format Geoconcept export. Retrait de Prototype et Script.aculo.us. Nouvelle barre d'édition et nouveaux composants pour le gestionnaire de couches. Documentation basée sur NaturalDocs. Ouverture au zoom mondial. 1er juillet 2008 1.0beta2 OpenLayers 2.6, plus de fonctionnalités au support du format GPX. 4 juin 2008 1.0beta1 Corrections de quelques boggues, quelques fonctionnalités OpenLayers 2.6 et support préliminaire du format GPX. 28 avril 2008 1.0beta OpenLayers 2.5 avec le support des projections.

4 ChangeLog 7 4 ChangeLog... 4.1 Modifications 4.1.1 API Web 2D en Javascript 4.1.1.1 02/04/2015 (2.1.2) : Corrections de bugs : Résolution du bug d'affichage du layer Switcher sous IE introduit par la version 2.1.1. Retrait des paramètres JSONP lors de l'appel à l'autoconf lorsque celle-ci est chargée localement. Affichage d'images "nodata" lorsque les tuiles attendues sont en HTTP 404 en mode HTTPS (comme c'est déjà le cas en HTTP). Géocodage inverse : lorsqu'on saisit un cercle ou rectangle comme zone de recherche, celuici est réduit aux tailles limites acceptées par le service (par défaut : 1000m) de façon à ne pas avoir d'erreur du service. Gestion par les CSS de certaines images utilisées par les widgets API. Modification des styles d'affichage des tracés des outils de mesure. Retrait des dépendances Flex du packaging GeoportalExtended. 3D : correction du bug de centrage par géocodage. 3D : ajout de la couche MNT par défaut. correction d'un bug dans la gestion des ratios min et max de l'éechelle dans la mini carte (OverviewMap). meilleure gestion des événements claviers dans le controle d'autocompletion. Prise en compte native des résolutions des pyramides des couches en Lambert 93. Mise en place d'entêtes Expires sur les fichiers js et CSS de l'api. 4.1.1.2 24/11/2014 (2.1.1) : Gestion du service d'altimétrie de la plateforme Géoportail. un nouveau parser ; des nouveaux contrôles Geoportal.Control.Measure.Elevation et Geoportal.Control.Measure.ElevationPath pour calculer une altitude ou un profil altimétrique sur une carte. Disponibles dans l'api Standard. des exemples d'illustration : paramétrage des outils d'altimétrie, intégration des outils altimétriques avec les outils de mesure et personnalisation de l'affichage du profil altimétrique avec une bibliothèque tierce. Amélioration de la gestion du géocodage inverse : rajout du parsing de la balise SearchCenterDistance dans la gestion du format OpenLS. Le contrôle ne propose que les ressources (toponymes, adresses ou parcelles) disponibles sur la clef. Possibilité de paramétrer le contrôle sur les ressources utilisées (allowsearchtype). Changements sur le LayerSwitcher : rajout des méthodes movelayerup et movelayerdown. gestion plus fine des identifiants des panneaux relatifs aux couches décrites : ils sont construits à la fois à partir de l'identifiant de la couche et de celui du LayerSwitcher.

4 ChangeLog 8 Debug divers : Modification du contrôle LayerCatalog pour qu'il n'affiche que les couches disponibles sur la clef. diverses retouches de pictos et CSS (notamment pour la compatibilité avec Wordpress). API 3D : prise en compte des paramètres heading et tilt d'orientation de la caméra. Gestion correcte du WFS 1.1.0 par le contrôle AddVectorLayer. Mise à jour des emprises des regions et departements à partir de GEOFLA. Le format WFST v2 utilise bien les filtres v2. 4.1.1.3 27/05/2014 (2.1.0) : Utilisation d'openlayers 2.12 cf. Changelog d'openlayers 2.12 Réorganisation de l'arborescense des sources et du système de compilation Le projet api-js est désormais éclaté en trois projets : api-js-libraires (pour le source de l'api), api-js-examples (pour les exemples d'utilisation) et api-js-techdocs (pour la présente documentation technique). Le système de compilation a été revu pour être en phase avec l'infrastructure du Géoportail phase 3, permettant désormais des procédures de livraison plus simples. Nouvelle définition de l'api Minimale : celle-ci est désormais indépendante de tout chargement préalable d'openlayers (elle en embarque les classes nécessaires), mais elle n'écrase pas ses définitions si ce dernier est chargé en premier. Le thème geoportal3 devient le thème par défaut et remplace l'ancien geoportal qui est renommé en 'legacy'. Voir le nouveau thème par défaut. Gestion du géocodage inverse par l'api (contrôles et parseur) Ajout d'un contrôle printmapdom qui repose sur une copie du DOM de la carte et non la création d'un nouveau viewer. La copie des couches vecteurs ne fonctionne pas pour les navigateurs utilisant VML comme moteur de rendu (ie8 et ie9). Reste encore expérimental. cohabite avec le controle printmap existant Intégration d'un correctif d'openlayers 2.13 permettant le support d'ie10 (et 11). Un nouveau design pour la page d'index des exemples d'utilisation. Voir la nouvelle page. Optimisation de l'affichage des pictos par l'utilisation de sprites css Modification de la gestion des territoires En 2.0, lorsqu'on initialisait la carte par défaut, sans spécification de territoire, celle-ci permettait de naviguer sur le territoire métropolitain (FXX) aux grandes échelles et sur le territoire monde entier (WLD) aux petites échelles. En 2.1.0, la carte est initialisée uniquement sur le territoire métropolitain par défaut à toutes les échelles : du coup la navigation est limitée à son emprise. Par contre, le territoire monde entier a été étendu à toutes les échelles (même s'il n'y a pas de données partout) et du coup, si on veut pouvoir débrider la navigation, il faut indiquer que l'on créé la carte avec ce territoire.

4 ChangeLog 9 Diverses corrections de bugs. 4.1.1.4 26/02/2013 (2.0.3) : Refactoring des classes d'affichage des informations sur les couches Refactoring des classes du "Location Utility Service" gestion du KML tuilé Ajout d'un nouveau thème "geoportal3" Diverses corrections de bugs 4.1.1.5 15/10/2012 (2.0.2) : Corrections de bugs : outils de mesure : correction de bug sur le calcul des surfaces Echelle graphique : prise en compte de la résolution terrain pour le calcul de l'échelle Logos : correction de bug sur l'affichage des logos en fonction du niveau de zoom 4.1.1.6 19/09/2012 (2.0.1) : Corrections de bugs : outils de mesure : les distances sont calculées sur l'ellipsoide https : invocation des services en https si la page est en https PrintMap : gestion des urls commençant par '/' Ajout des grilles de transformation NTF - RGF93 4.1.1.7 09/07/2012 (2.0) : Accès à l'infrastructure du Géoportail 3: Remplacement du WMS-C par le WMTS Support du HTTPS Une nouvelle gestion des droits d accès aux données: http://wxs-ign-fr/clef/contexte/service => plus de notion de jetons Une nouvelle projection de visualisation : Web Mercator Sphérique Ajout de nouveaux contrôles: Catalogue de couches, barre de croquis,... Accès aux nouveaux services: Auto-configuration, géocodage inverse, autocomplétion,... Utilsation de la version 1.2 d'openls Les services de géocodage possibilité d'éffectuer une recherche par identifiant parcellaire ou par sites géodesiques à travers le service de géocodage 4.1.1.8 20/02/2012 (1.3) : Ajout d' OpenLayers.UI et Geoportal.UI pour séparer les contrôleurs de leur rendu; OpenLayers.Format.WMC fait maintenant partie de l'api standard en prévision de son utilisation de la version 2.0 à venir pour charger les informations liées au clef API; Ajout de OpenLayers.Protocol.WFS.v2 dans l'api étendue (expérimental); Correction du calage des grilles dans Geoportal.Layer.Grid; Ajout de la classe Geoportal.Layer.WMTS; Correction de la lecture des capacités WMTS et modifications de geturl() de Geoportal.Layer.WMTS pour propager les informations en provenance des capacités. Ajout de

4 ChangeLog 10 la lecture de la balise TileMatrixSetLimits, et correctif pour ows:wgs84boundingbox dans la lecture des capacités de WMTS; Premier support du WMTS dans Geoportal.Control.AddImageLayer; Correction boggues lecture des capacités de service WFS : le préfixe des typenames n'était pas stocké et sauvegarde des SRS dans la liste des SRS disponibles. Prise en compte des préfixes et espaces de nommage dans Geoportal.Control.AddVectorLayer. Correction boggue sur le style par défaut des couches WFS, la taille des points était oubliée. Corrections boggues sur Geoportal.Control.AddVectorLayer et ajout de l'utilisation de DescribeFeatureInfo pour le champ géométrie lors d'un accès WFS. Correction des URLs WFS de Geoportal.Control.AddVectorLayer; Ajout de la documentation sur le GET KVP d''openls. Correction d'un boggue dans Geoportal.Layer.OpenLS.Core.LocationUtilityService dans le cas des requêtes GET : les options de la couche étaient écrasées par celles passées à la construction de la requête. Modification des méthodes tostring() et tohtmlstring() de Geoportal.OLS.Address; Ajout des méthodes setcenteratlocation() et setcenteratgeolocation() sur Geoportal.Map pour se positionner sur un toponyme ou une adresse ou à une IP; Ajout des méthodes setkeys() et getallowedgeoportallayers() sur Geoportal.Catalogue; Ajout de la méthode setkeys() sur Geoportal.Viewer; Ajout du support des légendes dans la configuration des couches API; Internationalisation des libellés associés aux légendes des couches; Mise à jour de PROJ4JS : entre autres, utilisation du code Google Mercator officiel (EPSG:3857). Ajout des caractères ` et `` dans l'analyse des degrés sexagésimaux; Retrait des systèmes de référence de coordonnées STEREOSX (non utilisé) et UTM39ETRS89 (hors emprise Europe INSPIRE). Correction TERA50GEO par TERA50G; Modification du registre IGNF (suite à commit sur PROJ.4); Suppression des appels à OpenLayers.Element.hide() et OpenLayers.Element.show() dépréciés; Prise en compte du ticket 3486 sur OpenLayers.Protocol.Script; Prise en compte du ticket 3567 d'openlayers 2.11 sur l'option autosize des OpenLayers.Popup; Modification du constructeur d' OpenLayers.Control.ZoomPanel pour pouvoir passer des options aux sous-contrôles; Changement du logo Géoportail et des CSS associées (proposition); Modification des styles associés à Geoportal.Control.PermanentLogo et Geoportal.Control.TermsOfService; Correction boggue et utilisation de toutes les couches du contrat dans l'exemple geoportalmap_all; Correction de l'exemple geoportalmap_basicviewer.html : support d' OpenLayers.UI, blocage de la miniaturisation de Geoportal.Control.Information (contrôle externalisé); Ajout des exemples simple1.2 (thème), simple1.3 (fonctions de rappel), simple6.1 (GPX), simple6.2 (WMS), simple7 (contrôle externe) et simple8 (WFS); API Flash : intégration d'une application developpée avec une version alpha de l'api version 2.0 ; API Flash : Ajout d'exemples utilisant la nouvelle application version 2.0 : simple1 (intégration simple), simple2 (ajout de données au format KML), simple2.1 (ajout de données au format GPX) et simple3 (positionnement par noms de lieux); Ajout de l'exemple geoportalmap_wmts.html; Ajout d'un exemple mimiquant l'utilisation de GoogleMaps API;

4 ChangeLog 11 Ajout d'un premier exemple sur les mobiles : geoportalmap_mobile1.html; Ajout d'un second exemple sur les mobiles avec JQueryMobile : geoportalmap_mobile2.html; Mise-à-jour de la documentation sur les modèles de codes API : l'ancienne méthode de chargement via l'utilisation de http://api.ign.fr/geoportail/api? <script type="text/javascript" src="http://api.ign.fr/geoportail/api? v=version&key=clef&instance=visu&"><!--//--><![cdata[// ><!-- //--><!]]></script> est dépréciée à partir de cette version de l'api. il est conseillé d'utiliser soit Geoportal.load, soit un chargement "manuel" de l'api et de passer à cette version de l'api. Les plus anciennes ne sont plus maintenues. Plus d'informations sur la migration là. Problèmes connus : Le contrôleur PrintMap présente des dysfonctionnements sous Chrome, IE et Safari (il reste expérimental) ; Les halo des labels ne se déplacent pas correctement lors d'un déplacement de la carte; 4.1.1.9 28/02/2011 (1.2) : Correction boggue de la désactivation du clavier quant activeovermaponly est faux; Correction des surcharges OpenLayers.Map.getObjectProjection() et OpenLayers.Layer.getNativeProjection() pour mimiquer OpenLayers correctement; Changement de signature de Geoportal.Control.LocationUtilityService. [Geocode GeoNames].setZoom() : la méthode attend un OpenLayers.Feature.Vector issu de la recherche. Répercution sur Geoportal.Control.LocationUtilityService.GeoNames.setZoomForBDNyme(); Modification du nom du callback onselectaddress() par onselectlocation(); Désactivation de la gestion de la visibilité des couches lors de leur chargement; Les fenêtres flottantes sont désormais 'resizable' ( Geoportal.Control.Floating); Prise en compte des modifications de la taille des fenêtres flottantes et des résultats dans Geoportal.Control.Form; Prise en compte de la propriété resultdiv de Geoportal.Control.Form dans les sous-classes; Désactivation du test sur l'existance d'une extension lors de l'import de fichiers vecteurs pour permettre d'importer des webservices qui retournent des kml, gpx, osm, etc... Ajout des méthodes Geoportal.Viewer.(get set)application(); Ajout du module Geoportal.GeoRMHandler.getConfig() et de son callback Geoportal.GeoRMHandler.getContract(); Ajout des méthodes Geoportal.GeoRMHandler.getServicesCapabilities() et du callback associé Geoportal.GeoRMHandler.getCapabilities() et autres corrections mineures; Ajout de la lecture de TimeStamp/when et TimeSpan/(begin end) sur les KML; Ajout des codes EPSG: 4467, 4471, 4474, 4559 pour RGSPM06 / UTM zone 21N, RGM04 / UTM zone 38S, Cadastre 1997 / UTM zone 38S, RRAF 1991 / UTM zone 20N; Les Geoportal.Layer.Aggregate transmettent dorénavant leurs zooms aux couches aggrégées qui ne peuvent appartenir qu'à un seul groupe. Simplification de la gestion de la visibilité des couches aggrégées;

4 ChangeLog 12 Support des classes OpenLayers.Popup dans les callback de création des popups via la nouvelle propriété popupclass; Ajout de la recherche affinée sur les adresses lors d'un cntrl-alt-clic sur un résultat de type 'city'; Correction boggue dans l'affichage du résultat de la recherche par adresse : clonage de l'objet résultat pour ne pas vider la pile d'objets lors de plusieurs cntrl-clic consécutifs; Retour des tailles des caractères des en-têtes Geoportal.Control.Floating à 0.8em à cause de IE8 sous W$ vista, mais augmentation des tailles des labels et champs de saisies et diminutation des tailles des champs de saisies; Modification de l'exemple geoportalmap_localise.html : les services IPinfoDB et GeoNames sont utilisés en JSON; Ajout du test basic-token-uncompressed.html pour tester l'api sans passer par la servlet api (lecture du getconfig et récupération du getcontract); Correction boggue sur geoportalmap_overview.html : ajout d'un timer sur les appels à Geoportal.Control.Information.showControls() et Geoportal.Control.Information.toggleControls() pour attendre que la carte soit prête; Ajout des exemples geoportalmap_simple1.html, geoportalmap_simple2.html, geoportalmap_comparator.html et geoportalmap_ignrge.html; Correction pour IE7 des labelbordercolor et labelbordersize non supportées; Modification de la documentation en mode développeur par défaut; Mise à jour de la documentation en ligne; Mise à jour des composants Mediawiki et Joomla; 4.1.1.10 17/01/2011 (1.2) : Remplacement d'openlayers 2.9.1 par OpenLayers 2.10; Prise en charge de http:// trac.osgeo.org/openlayers/ticket/2870 (régression OpenLayers 2.10); Application du ticket 2933 : chargement de l'api dans les navigateurs comptabiles HTML5; Ajout du nouveau mécanisme évitant de charger OpenLayers.js ou Geoportal*.js qui sera mis en place avec OpenLayers 2.11 et retrait des *._scriptname; Ajout des cartes littorales, topographiques, cassini et RPG 2007, 2008 et 2009. Désactivation des cartes de Cassini, Corine Land Cover. Mises à jour des échelles des couches; Modification des Geoportal.VERSION_NUMBER : la chaîne est du type INF;DATE avec INF valant "Geoportal versionapi typeapi"; Modification des Geoportal.Viewer.Default et Geoportal.Viewer.Standard : le contrôleur Geoportal.Control.Information peut dorénavant s'escamoter/se minimiser; mise-à-jour des CSS; Ajout de l'évènement controlvisibilitychanged sur OpenLayers.Map et prise en charge dans les contrôleurs Geoportal.Control.PermanentLogo, Geoportal.Control.Logo, Geoportal.Control.TermsOfService; Ajout de l'évènement controldeleted sur OpenLayers.Map et prise en charge dans les contrôleurs Geoportal.Control.Projections, Geoportal.Control.Form et Geoportal.Control.MousePosition; Ajout de la méthode OpenLayers.Map.getApproxScaleDenominator() en substitution de la méthode OpenLayers.Map.getScale(); Ajout de l'écouteur Geoportal.Control.SliderBase.displayInfo() pour l'évènement mouseover; Prise en charge des évènements mapmouseover et mapmouseout dans Geoportal.Control.LayerSwitcher, Geoportal.Control.Floating, Geoportal.Control.ToolBox; Ajout des méthodes Geoportal.Control.mapMouseOut() et Geoportal.Control.mapMouseOver() en charge de lancer les évènements mapmouseover et mapmouseout;

4 ChangeLog 13 Prise en charge de visibilitychanged sur OpenLayers.Protocol.Response pour arrêter le chargement dans les stratégies OpenLayers.Strategy.BBOX, OpenLayers.Strategy.Fixed; Mise à jour de PROJ4JS et du catalogue IGNF pour les systèmes de référence INSPIRE. Ajout du support de l'option +axis= ( patch envoyé au projet); Remplacement des procédures de chargements KML, GPX, OSM, GeoRSS, GML et WFS par des nouvelles utilisant OpenLayers.Strategies et OpenLayers.Protocol (anticipation OpenLayers 3.0); Développement de l'option preventdefaultbehavior du constructeur de Geoportal.Map pour supporter diverses sous-options; Support des emprises sur l'affichage des logos des couches au travers de Geoportal.Control.Logo; Support des Geoportal.Layer.Aggregate par Geoportal.Control.Loading; Support de l'option logosize à la création d'un Geoportal.Viewer; Support en tant que tableau des propriétés description, legends, dataurl and metadataurl des couches par Geoportal.Control.LayerSwitcher. Mises à niveau des contrôleurs Geoportal.Control.AddImageLayer et Geoportal.Control.AddVectorLayer; Support des couches Géoportail dans Geoportal.Control.AddVectorLayer; Déplacement du code lié à l'évènement onload dans le body des exemples HTML et non dans l'en-tête; Restriction des systèmes de projection de coordonnées "compatibles" aux seuls plate-carré et équidistant cylindrique; Restriction des WMS du Géoportail aux seules projections légales; Correction boggue dans Geoportal.Popup.setPointerCursorForFeature() : création d'un clone des styles modifiés pour éviter l'écrasement des styles originaux; Correction de la taille des champs pour l'affichage des coordonnées dans Geoportal.Control.MousePosition; Correction boggue OpenLayers.Renderer.*.setExtent() : cas où l'emprise est nulle; Séparation des styles IE6 des autres styles; 4.1.1.11 22/11/2010 (1.0, 1.1) : Ajout des paramètres center et zoom dans les exemples Flex; Correction du calcul des résolutions des Geoportal.Layer.Grid : test sur les résolutions de la couche versus la base; Correction des zooms minimum et maximum et correction de la pyramide des résolutions lors de l'ajout d'un service WMS-C; Ajout du support de l'attribut skipattributes sur les couches pour l'affichage des popups étendant le support actuel; Correction d'une régression sur OpenLayers.Control.WMSGetFeatureInfo.buildWMSOptions() affectant l'api depuis la version 1.1 (le CRS envoyé n'est pas celui des couches, mais de la carte); Correction typographique dans l'api Standard : "OpenLayers.Protocol" et non "OpenLayers.Protocole" (certaines classes OpenLayers manquaient); Retrait de l'interception du clic droit dans la carte : trop de problèmes avec IE; Correction boggue sur la fermeture des popup dans le cas d'un contrôleur gérant plusieurs couches;

4 ChangeLog 14 4.1.1.12 18/10/2010 (1.1) : Création des fichiers d'en-tête des APIs minimum, standard et étendue : GeoportalMin.js, GeoportalStandard.js et Geoportal.js; Extension du composant Geoportal.Control.Logo : prise en compte du champ attribution; Ajout de la propriété privée OpenLayers._document (avec ses méthodes OpenLayers.getDoc() et OpenLayers.setDoc() associées) pour contenir le document de travail courant. Modifications de toutes les classes OpenLayers et Geoportail qui utilisaient document directement; Ajout des contrôleurs Geoportal.Control.PrintMap, Geoportal.Control.CSW et Geoportal.Control.PageManager; Date of publication and author fields are now taken into account for GeoRSS streams; Passage à PROJ4JS 1.0.2; Mise-à-jour du catalogue IGNF de PROJ4JS pour ajouter les CRS basés sur RGTAAF07. Renommage de IGNF:TERA50GEO en IGNF:TERA50G. Retrait de IGNF:TERA50STPA; Ajout de l'exemple sur les fils GeoRSS; Ajout du style virtuel lors de l'utilisation d' OpenLayers.Control.ModifyFeature (geoportalalert.html); Activation de la case "Code postal" du moteur de recherche par adresses; Modification d' OpenLayers.Control.Measure (patch 2820); Récriture de Geoportal.Format.GPX, support des versions 1.0 et 1.1; Ajout des styles "black" et "covisu" et corrections de boggues associés à la gestion des thèmes; Ajout de la méthode Geoportal.Control.Form.buildRadioFields() et diverses optimisations dans Geoportal.Control.Form; Ajout de l'ortho-photographie littoral dans Geoportal.Catalogue; Support de OpenLayers.Request.abort() pour les contrôleurs Geoportal.Control.LocationUtilityService, Geoportal.Control.AddVectorLayer, Geoportal.Control.AddImageLayer; Corrections de boggues sur Geoportal.Map : prise en compte de options.formatoptions correctement, vérification des contrôles déjà chargés, prise en charge du i18n sur des couches OpenLayers.Layer, prise en charge de OpenLayers.Layer.Markers pour les popup; Amélioration du chargement de la fenêtre ( Geoportal.Viewer.Default et Geoportal.Viewer.Standard); Correction boggue sur l'exemple geoportalmap_providers.html (suite au portage en OpenLayers 2.9.1); Prise en compte de la nouvelle capacité de la servlet API (clefs et instances multiples) sur certains exemples de test et de production; 4.1.1.13 02/08/2010 (1.1) : Remplacement d'openlayers 2.8 par OpenLayers 2.9.1. 4.1.1.14 02/08/2010 (1.0) : Déplacement de OpenLayers.Tile de l'api standard vers l'api minimum à cause de la gestion GeoRM; Ajout de OpenLayers.Control.ArgParser, OpenLayers.Control.Attribution, OpenLayers.Control.PanZoom pour être en conformité avec OpenLayers.Map; Ajout des styles olcontroldragpanitemactive, olcontroldragpaniteminactive, olcontrolzoomoutitemactive, olcontrolzoomoutiteminactive; Le nombre de CRS lors de la lecture des capacités des WMS est maintenant une option de Geoportal.Control.AddImageLayer;

4 ChangeLog 15 Amélioration du chargement des couches OpenLayers.Layer.GeoRSS dans Geoportal.Map.addLayer(), ajout d'une légende par défaut; Ajout de la méthode Geoportal.Map.setCursor() et retrait de la règle cursor 'crosshair' sur la classe gpmap, l'api utilise la méthode pour assigner le type de curseur; Correction d'un boggue sur Geoportal.Layer.OpenLS.LocationUtilityService.GEOCODE() et Geoportal.Layer.OpenLS.LocationUtilityService.REVERSE_GEOCODE() pour protéger les paramètres d'une destruction par clonage de ceux-ci; Correction d'un boggue sur Geoportal.GeoRMHandler lors du partage de clefs ayant des écouteurs d'évènements; Correction de fuites de mémoire dans Geoportal.Control.LayerSwitcher (évènements non libérés); Correction de Geoportal.Viewer.Default pour IE (suppression d'une ligne d'un tableau vide provoquant un décalage d'un pixel); Correction d'un boggue label sous OpenLayers.Renderer.VML (OpenLayers 2.9); Correction d'un boggue OpenLayers.Layer.setOpacity() pour les couches à base d' OpenLayers.Layer.Vector; Correction d'un boggue lors du chargement du type de service WFS dans Geoportal.Control.AddVectorLayer; Correction d'un boggue sur Geoportal.Control.MeasureToolbar pour IE à cause d'une virgule trainant en fin de ligne; Ajout des îles Amsterdam et Saint-Paul, de la Terre Adélie et de leurs systèmes de références de coordonnées; Geoportal.Control.Logo est intégré dans l'api Géoportail minimum; Les informations sur la GeoRM sont dorénavant stockées dans le catalogue de la carte et non plus la carte elle-même; Les noms des territoires sont maintenant traduits (leur code sert de clef de traduction). L'exemple geoportalmap_all.html est mis-à-jour en accord; proxy.php.zip and proxy.php.zip.md5 sont maintenant à jour; Les exemples complexes ( geoportaladdressform.html, geoportalalert.html, geoportalgeocoder.html, geoportalxyform.html) ont été revus à cause d'ie; Mise-à-jour de la documentation sur le non-support du protocole HTTPS. 4.1.1.15 21/06/2010 (1.0) : Correction de boggue sur OpenLayers.Format.WFST.v1.getSrsName() : la propriété externalprojection n'était pas prise en compte quant elle est définie; Correction de la règle CSS gpcontrolinformation pour éviter une erreur de calcul sur la largeur de l'élément DOM; OpenLayers.Util.onImageLoadError() réutilise OpenLayers.Util.onImageLoadErrorColor quand les images ne sont en provenance ni d'osm, ni du Géoportail; Mise à jour de OpenLayers.Request.XMLHttpRequest sur le trunk OpenLayers; Prise en compte des modifications du trunk de PROJ4JS (somerc); Corrections boggues OpenLayers.Format.GML.Base sur les reprojections des BBOX des objets lus; Améliorations de OpenLayers.Protocol.WFS.v1.prototype.read() pour supporter des features multiples en entrée; Prise en compte de OpenLayers.Control.GetFeature d'openlayers 2.9; Correction des problèmes de reprojection des BBOX dans OpenLayers.Control.GetFeature;

4 ChangeLog 16 Ajout du support des requêtes par polygones dans OpenLayers.Control.GetFeature; Prise en compte des cartes en très grandes échelles (1:4000 à 1:1000) dans les territoires; Correction du moteur de changement de baselayer pour Geoportal.Control.ZoomSlider, pour Geoportal.Control.ZoomBar (les zooms sont toujours au nombre de 22), des fonctions par défaut pour Geoportal.Control.SliderBase (les zooms retournent null et non -1 dans les fonctions génériques); Correction boggue Geoportal.Control.Form : réactivation du clavier lors de la fermeture du contrôle; Correction boggue dans la création des couches Geoportal.Map.addLayer : les options passées s'appliquent bien en dernier pour ne pas être écrasées par les valeurs par défaut; Le contenu des Geoportal.Popup.Anchored est dorénavant basé sur name, description et les attributs étendus; Correction boggue sur les Geoportal.Layer.Aggregate lors des changements de zoom et de baselayer; Ajout de l'option usedefaultbaselayers pour désactiver la création des baselayers Géoportail par défaut Geoportal.Viewer; Correction de la méthode Geoportal.Viewer.addSphericalMercatorBaseLayer() et ajout de la méthode Geoportal.Viewer.addPlateCarreBaseLayer(); Correction boggue sur l'option global lors de l'appel à Geoportal.Viewer.addGeoportalLayer(); Vérification des extensions des fichiers dans Geoportal.Control.AddVectorLayer, du type de service dans Geoportal.Control.AddVectorLayer (WFS) et Geoportal.Control.AddImageLayer (WMS); Correction boggue sur affectation des territoires SBA et SMA; Nettoyage zindex Geoportal.Control.LayerSwitcher; Ajout de l'option attachdefaultpopup pour les couches vectorielles directement chargées via Geoportal.Map.addLayer() afin d'ajouter, en conjonction avec l'option preventdefaultbehavior, les popups automatiquement; Correction de la désactivation du contrôle Geoportal.Control.Measure: réinitialisation de targetelement si besoin. Geoportal.Control.Measure.Azimuth ouvre un panneau de résultats (distance et angle). Réorganisation de Geoportal.Control.MeasureToolbar pour faciliter les surcharges utilisateurs. Ajout du style gpcontrolmeasureazimuthazimuthinput; Modification du code des proxy PHP/Perl; Amélioration des codes RIG pour les territoires des "Îles éparses"; Correction des explications liés à la GeoRM; Correction de liens cassés dans la documentation; Retrait de OpenLayers.Control.Measure de l'api standard (API étendue); Retrait de OpenLayers.Control.MousePosition de l'api étendue (API standard); Correction inclusion de OpenLayers.Control.OverviewMap dans l'api standard au lieu de l'api étendue; Mise-à-jour de la date de la licence, ajout de la license XmlHttpRequest.js, ajout du lien téléchargement du code source de l'api dans le texte des licences; Modification du style gpcontrolmeasuretoolbarresult pour que sa hauteur s'adapte à son contenu. Ajout de la régle gpcontrolmeasureazimuthazimuthinput; Prise en compte des tickets http://trac.openlayers.org/ticket/2501 et http://trac.openlayers.org/ ticket/2096 dans OpenLayers.Control.Measure; Mise-à-jour de XmlHttpRequest en version 1.0.3 (http://trac.openlayers.org/ticket/2065);