IGN

Géoservices IGN

Les API du Géoportail évoluent !

5 Octobre 2018

De nouvelles versions des API JavaScript du Géoportail ont été publiées (Bibliothèque d'accès, Extensions Géoportail, Kit de développement).

Résumé

La bibliothèque d’accès évolue (diverses corrections et améliorations) et passe en version 2.1.

Les extensions Géoportail évoluent :
* l’extension iTowns ainsi que l’extension OpenLayers passent en version 2.1 (on notera notamment la possibilité d’ajout simplifié de couches Géoportail avec iTowns)
* l’extension Leaflet est désormais disponible en version 2.0.2 (divers correctifs et améliorations du projet)

Le SDK évolue et passe en version 2 pour s’adapter au standard ES6 ainsi qu’à la coexistence de deux versions : 2D et 3D. Attention à bien noter les changements importants par rapport aux versions précédentes (plus d’infos ci-dessous).

Bibliothèque d’accès aux ressources du Géoportail

Une nouvelle version de la bibliothèque d’accès est disponible sur Github ou sur les dépôts NPM.

Pas d’évolution fonctionnelle majeure depuis la version 2.0 (amélioration du code source et de son analyse, correctifs de bugs).

Extensions Géoportail

Extension Géoportail pour OpenLayers

Une nouvelle version 2.1.0 de l’extension Géoportail pour OpenLayers est disponible sur Github ou sur les dépôts NPM.

En plus de l’intégration de la dernière version de la bibliothèque d’accès aux services Géoportail, et de l’amélioration du projet, les widgets existants ont été améliorés (remontées d’anomalies et ajout de fonctionnalités). Plus de détails ici.

Extension Géoportail pour Leaflet

Une nouvelle version 2.0.2 de l’extension Géoportail pour Leaflet est disponible sur Github ou sur les dépôts NPM.

La dernière version de la bibliothèque d’accès aux services a été intégrée, le projet a été amélioré, et quelques anomalies ont été corrigées (widget d’affichage des coordonnées de la souris).

Extension Géoportail pour iTowns

Une nouvelle version 2.1.1 de l’extension Géoportail pour iTowns est disponible sur Github ou sur les dépôts NPM.

Cette version propose notamment l’ajout simplifié de couches Géoportail avec iTowns : WMTS, WMS et MNT pour l’affichage du relief.

SDK Géoportail (ou “Kit de Développement”)

Les Kits de développement 2D et 3D (ou SDK 2D et 3D) sont désormais disponibles en version 2.0.1, sur Github ou sur les dépôts NPM : version 2D et version 3D.

Le projet a été migré sur Webpack et les sources on été migrées en ES6 modules.

Remarques importantes :
* certains noms de fonctions et de paramètres ont été modifiés (notamment la méthode getLib() et l’option library)
* les noms des bundles ont été modifiés (“GpOl” devient “GpSDK2D”, et “GpOlItowns” devient “GpSDK3D”)
* les chemins pour trouver la documentation et les binaires ont été modifiés
* les modules NPM sont désormais disponibles sur “@ignf-geoportal” (ex. “@ignf-geoportal/sdk-2d” ou “@ignf-geoportal/sdk-3d”)

Pour plus de détails, voir ici.

Pour en savoir plus sur les évolutions concernant ES6 et Webpack :
* ES6 (ou ECMAScript6) est un standard JavaScript (changements importants avec le standard précédent), avec notamment la notion de modules. L’adaptation de notre API à ce nouveau standard devenait importante (il date déjà de 2015), permettait de suivre l’évolution des librairies utilisées (OpenLayers ou Leaflet notamment), et d’être compatible avec de nouveaux frameworks JavaScript émergents (AngularJS, EmberJS, …).
* Le changement de gestionnaire de tâches (Gulp vers Webpack) a permis de mieux gérer les modules ES6 et donc d’avancer dans le passage en ES6 de nos projets, tout en utilisant des outils plus modernes et mieux maintenus.

Liens utiles

Bibliothèque d’accès

Extensions Géoportail

SDK