diff --git a/DRAFT_CHANGELOG.md b/DRAFT_CHANGELOG.md index 34e38051..6c1b671a 100644 --- a/DRAFT_CHANGELOG.md +++ b/DRAFT_CHANGELOG.md @@ -3,6 +3,7 @@ + # Extension Geoportail OpenLayers, version __VERSION__ **__DATE__** @@ -10,130 +11,16 @@ ## Summary -Retrait total de l'utilisation du service d'autoconfiguration et utilisation de fichiers de configuration json générés quotidiennement à partir des getCapabilities des services du Geoportail. - -L'ensemble des services de calcul appelés via la bibliothèque d'accès sont désormais appelés avec la clé "calcul" par défaut dans la bibliothèque d'accès. Le paramètre "apiKey" n'est donc plus nécessaire pour appeler les services de géocodage, d'itinéraire, d'isochrone, d'altimétrie et d'autocomplétion, que ce soit directement depuis la bibli -othèque d'accès ou via les widgets des extensions Géoportail. - -L'autoconfiguration n'est plus appelée par les API. Pour la remplacer, nous générons quotidiennement, à partir des getCapabilities des services WMS et WMTS, des fichiers de configuration en JSON appelables par les API JavaScript Géoportail. Il y a un fichier par clé générique. L'avantage de ce nouveau processus (en plus de s'adapter au futur arrêt du service d'autoconfiguration) est que les fichiers de configuration JSON sont directement au format attendu par les API : il n'y a plus besoin de les parser pour en extraire les informations utiles puis pour les introduire dans une structure adéquate. -Par exemple, en renseignant "cartes" au paramètre apiKey, c'est le fichier cartesConfig.json qui sera chargé et directement utilisé par les API. - -A noter que le multiKeys est toujours géré, c'est à dire qu'il est possible de renseigner plusieurs clés dans le paramètre apiKey. - -Il est également possible de générer son propre fichier de configuration à partir d'une ou plusieurs clés. L'utilitaire est temporairement disponible ici : https://geoportal-configuration.onrender.com. Le paramètre permettant ensuite de charger sa configuration personnelle à partir du fichier local généré s'appelle désormais **customConfigFile**, auquel on associera le chemin vers le fichier de configuration json à charger. - ## Changelog * [Added] * [Changed] - - mise à jour de la bibliothèque d'accès aux services Geoportail en version 3.3.0 (#364) - - **BC** : paramètre "customConfigFile" pour appeler un fichier de configuration local (#364) - -##### Avant : - -```html - -``` - -OU - -```javascript -Gp.Services.getConfig({ - serverUrl : "chemin/vers/mon/autoconf/AutoConf.js", - timeOut : 20000, - onSuccess : createMap -}); -``` - -##### Maintenant : - -```html - -``` - -OU - -```javascript -Gp.Services.getConfig({ - customConfigFile: "chemin/vers/ma/config/customConfig.json", - timeOut: 20000, - onSuccess: createMap -}); - * [Deprecated] * [Removed] - - **BC** : les originators ne sont plus renvoyés dans la configuration. Il faut les ajouter manuellement aux couches. - -```javascript - var gpOrtho = new ol.layer.Tile({ - source: new ol.source.GeoportalWMTS({ - layer: "ORTHOIMAGERY.ORTHOPHOTOS", - olParams: { - attributions: [{ - name: "Nom raccourci originator", - constraints: [{ - minScaleDenominator: 20000, - maxScaleDenominator: 1000000, - bbox: { - left: -10, - top: 50, - right: 10, - bottom: 40 - } - }, - { - bbox: { - left: 120, - top: 50, - right: 150, - bottom: 35 - } - } - ] - }, - { - url: "http://www.url-vers-le-site-du-producteur.fr", - constraints: [{ - minScaleDenominator: 20000, - maxScaleDenominator: 400000 - }] - }, - { - logo: "https://lien-vers-le-logo.png" - }, - { - attribution: "Titre complet originator", - constraints: [{ - minScaleDenominator: 100000, - maxScaleDenominator: 800000 - }] - }] - } - }) - }); -``` - - - **BC** : Les metadatas sont utilisées dans les API par le contrôle gestionnaire de couches (LayerSwitcher). Celui-ci va lire les metadatas des couches ajoutées à la carte et les afficher dans l'encart d'information dédié du LayerSwitcher. **Pour les couches WMTS uniquement**, désormais, pour que les metadatas apparaissent dans l'onglet "informations" du LayerSwitcher, il faudra les renseigner manuellement à la configuration de la couche Géoportail lors de son ajout à la carte. - - -```javascript -new ol.layer.Tile({ - source: new ol.source.GeoportalWMTS({ - layer: "ORTHOIMAGERY.ORTHOPHOTOS", - metadata: [ - { - format: "xml", - url: "lien/Vers/Une/MetaDonnee.xml" - } - ], - }) -}) -``` - * [Fixed] * [Security] @@ -141,6 +28,7 @@ new ol.layer.Tile({ --- + # Extension Geoportail Leaflet, version __VERSION__ **__DATE__** @@ -165,117 +53,26 @@ new ol.layer.Tile({ --- + # Extension Geoportail Itowns, version __VERSION__ + **__DATE__** > Release Extension Geoportail itowns ## Summary -Retrait total de l'utilisation du service d'autoconfiguration et utilisation de fichiers de configuration json générés quotidiennement à partir des getCapabilities des services du Geoportail. - -L'ensemble des services de calcul appelés via la bibliothèque d'accès sont désormais appelés avec la clé "calcul" par défaut dans la bibliothèque d'accès. Le paramètre "apiKey" n'est donc plus nécessaire pour appeler les services de géocodage, d'itinéraire, d'isochrone, d'altimétrie et d'autocomplétion, que ce soit directement depuis la bibliothèque d'accès ou via les widgets des extensions Géoportail. - -L'autoconfiguration n'est plus appelée par les API. Pour la remplacer, nous générons quotidiennement, à partir des getCapabilities des services WMS et WMTS, des fichiers de configuration en JSON appelables par les API JavaScript Géoportail. Il y a un fichier par clé générique. L'avantage de ce nouveau processus (en plus de s'adapter au futur arrêt du service d'autoconfiguration) est que les fichiers de configuration JSON sont directement au format attendu par les API : il n'y a plus besoin de les parser pour en extraire les informations utiles puis pour les introduire dans une structure adéquate. - -Par exemple, en renseignant "cartes" au paramètre apiKey, c'est le fichier cartesConfig.json qui sera chargé et directement utilisé par les API. - -A noter que le multiKeys est toujours géré, c'est à dire qu'il est possible de renseigner plusieurs clés dans le paramètre apiKey. - -Il est également possible de générer son propre fichier de configuration à partir d'une ou plusieurs clés. L'utilitaire est temporairement disponible ici : https://geoportal-configuration.onrender.com. Le paramètre permettant ensuite de charger sa configuration personnelle à partir du fichier local généré s'appelle désormais **customConfigFile**, auquel on associera le chemin vers le fichier de configuration json à charger. - ## Changelog * [Added] * [Changed] - - mise à jour de la bibliothèque d'accès aux services Geoportail en version 3.3.0 (#364) - - **BC** : paramètre "customConfigFile" pour appeler un fichier de configuration local (#364) -##### Avant : -```html - -``` -OU -```javascript -Gp.Services.getConfig({ - serverUrl : "chemin/vers/mon/autoconf/AutoConf.js", - timeOut : 20000, - onSuccess : createMap -}); -``` -##### Maintenant : -```html - -``` -OU -```javascript -Gp.Services.getConfig({ - customConfigFile: "chemin/vers/ma/config/customConfig.json", - timeOut: 20000, - onSuccess: createMap -}); -``` * [Deprecated] * [Removed] - - **BC** : les originators ne sont plus renvoyés dans la configuration. Il faut les ajouter manuellement aux couches. -```javascript -// Couche WMTS Geoportail -globeView.addLayer(new Gp.itownsExtended.layer.GeoportalWMTS({ - layer: "ORTHOIMAGERY.ORTHOPHOTOS", - itownsParams: { - source: { - attribution: [{ - "name": "Nom raccourci originator", - "url": "http://www.url-vers-le-site-du-producteur.fr", - "constraints": [{ - "crs": "EPSG:4326", - "bbox": { - "left": -180, - "right": 180, - "top": 90, - "bottom": -90 - }, - "minScaleDenominator": 2, - "maxScaleDenominator": 800000 - }] - }, - { - "name": "Nom raccourci originator 2", - "url": "http://www.url-vers-le-site-du-producteur2.fr", - "constraints": [{ - "crs": "EPSG:4326", - "bbox": { - "left": 1.5, - "right": 3, - "top": 49, - "bottom": 48 - }, - "minScaleDenominator": 10000, - "maxScaleDenominator": 450000 - }] - }] - } - } -})); -``` - - **BC** : Les metadatas sont utilisées dans les API par le contrôle gestionnaire de couches (LayerSwitcher). Celui-ci va lire les metadatas des couches ajoutées à la carte et les afficher dans l'encart d'information dédié du LayerSwitcher. **Pour les couches WMTS uniquement**, désormais, pour que les metadatas apparaissent dans l'onglet "informations" du LayerSwitcher, il faudra les renseigner manuellement à la configuration de la couche Géoportail lors de son ajout à la carte. -```javascript -// Couche WMTS Geoportail -globeView.addLayer(new Gp.itownsExtended.layer.GeoportalWMTS({ - layer: "ORTHOIMAGERY.ORTHOPHOTOS", - ssl: true, - metadata: [ - { - format: "xml", - url: "lien/Vers/Une/MetaDonnee.xml" - } - ] -})); -``` * [Fixed] * [Security] ---- +--- diff --git a/build/scripts/release/geoportal-extensions-itowns-2.3.11.tgz b/build/scripts/release/geoportal-extensions-itowns-2.3.11.tgz deleted file mode 100644 index ba96cfb9..00000000 Binary files a/build/scripts/release/geoportal-extensions-itowns-2.3.11.tgz and /dev/null differ diff --git a/build/scripts/release/geoportal-extensions-itowns-2.4.1.tgz b/build/scripts/release/geoportal-extensions-itowns-2.4.1.tgz new file mode 100644 index 00000000..e5aa6818 Binary files /dev/null and b/build/scripts/release/geoportal-extensions-itowns-2.4.1.tgz differ diff --git a/build/scripts/release/geoportal-extensions-leaflet-2.2.9.tgz b/build/scripts/release/geoportal-extensions-leaflet-2.2.9.tgz deleted file mode 100644 index fc2bbf5a..00000000 Binary files a/build/scripts/release/geoportal-extensions-leaflet-2.2.9.tgz and /dev/null differ diff --git a/build/scripts/release/geoportal-extensions-leaflet-2.3.1.tgz b/build/scripts/release/geoportal-extensions-leaflet-2.3.1.tgz new file mode 100644 index 00000000..6ea7f8a7 Binary files /dev/null and b/build/scripts/release/geoportal-extensions-leaflet-2.3.1.tgz differ diff --git a/build/scripts/release/geoportal-extensions-openlayers-3.2.21.tgz b/build/scripts/release/geoportal-extensions-openlayers-3.2.21.tgz deleted file mode 100644 index 70a11499..00000000 Binary files a/build/scripts/release/geoportal-extensions-openlayers-3.2.21.tgz and /dev/null differ diff --git a/build/scripts/release/geoportal-extensions-openlayers-3.2.22.tgz b/build/scripts/release/geoportal-extensions-openlayers-3.2.22.tgz deleted file mode 100644 index 1e091d63..00000000 Binary files a/build/scripts/release/geoportal-extensions-openlayers-3.2.22.tgz and /dev/null differ diff --git a/build/scripts/release/geoportal-extensions-openlayers-3.3.1.tgz b/build/scripts/release/geoportal-extensions-openlayers-3.3.1.tgz new file mode 100644 index 00000000..42d55700 Binary files /dev/null and b/build/scripts/release/geoportal-extensions-openlayers-3.3.1.tgz differ diff --git a/build/scripts/release/package-itowns.json b/build/scripts/release/package-itowns.json index 0599ebb1..2d23cc38 100644 --- a/build/scripts/release/package-itowns.json +++ b/build/scripts/release/package-itowns.json @@ -1,45 +1,45 @@ { - "license" : "CECILL-B", + "author" : "IGNF", + "name" : "geoportal-extensions-itowns", + "date" : "07/06/2023", + "scripts" : {}, + "homepage" : "https://geoservices.ign.fr/documentation/utilisation_web/extension-itowns.html", + "bundleDependencies" : [], + "devDependencies" : {}, "dependencies" : { - "xmldom" : "^0.1.27", - "proj4" : "2.7.5", "node-fetch" : "^2.6.1", - "sortablejs" : "1.14.0", - "geoportal-access-lib" : "3.3.0", "three" : "0.137.5", - "itowns" : "2.38.2", - "loglevel" : "1.6.7" + "sortablejs" : "1.14.0", + "geoportal-access-lib" : "3.3.1", + "xmldom" : "^0.1.27", + "loglevel" : "1.6.7", + "proj4" : "2.7.5", + "itowns" : "2.38.2" }, - "main" : "dist/GpPluginItowns-src.js", - "homepage" : "https://geoservices.ign.fr/documentation/utilisation_web/extension-itowns.html", - "bundleDependencies" : [], - "author" : "IGNF", "keywords" : [ "geoportail", "plugin", "javascript", "Itowns" ], - "types" : "src/Itowns/index.d.ts", - "directories" : {}, - "devDependencies" : {}, - "peerDependencies" : {}, - "repository" : { - "type" : "git", - "url" : "https://github.com/IGNF/geoportal-extensions.git" - }, - "bugs" : {}, - "version" : "2.3.11", - "name" : "geoportal-extensions-itowns", - "scripts" : {}, - "module" : "src/Itowns/index.js", - "description" : "French Geoportal Extensions for iTowns", - "date" : "01/06/2023", + "main" : "dist/GpPluginItowns-src.js", "files" : [ "dist/", "src/", "LICENCE.md", "README.md", "package.json" - ] + ], + "bugs" : {}, + "license" : "CECILL-B", + "version" : "2.4.1", + "directories" : {}, + "types" : "src/Itowns/index.d.ts", + "repository" : { + "url" : "https://github.com/IGNF/geoportal-extensions.git", + "type" : "git" + }, + "peerDependencies" : {}, + "module" : "src/Itowns/index.js", + "description" : "French Geoportal Extensions for iTowns" } diff --git a/build/scripts/release/package-leaflet.json b/build/scripts/release/package-leaflet.json index 9e5da1bd..e41891d9 100644 --- a/build/scripts/release/package-leaflet.json +++ b/build/scripts/release/package-leaflet.json @@ -1,21 +1,10 @@ { + "name" : "geoportal-extensions-leaflet", "repository" : { - "type" : "git", - "url" : "https://github.com/IGNF/geoportal-extensions.git" + "url" : "https://github.com/IGNF/geoportal-extensions.git", + "type" : "git" }, - "name" : "geoportal-extensions-leaflet", - "version" : "2.2.9", - "keywords" : [ - "geoportail", - "plugin", - "javascript", - "leaflet", - "publish" - ], - "main" : "dist/GpPluginLeaflet-src.js", - "peerDependencies" : {}, - "types" : "src/Leaflet/index.d.ts", - "bundleDependencies" : [], + "description" : "French Geoportal Extension for Leaflet", "files" : [ "dist/", "src/", @@ -24,23 +13,34 @@ "package.json" ], "directories" : {}, - "bugs" : {}, - "date" : "01/06/2023", - "homepage" : "https://geoservices.ign.fr/documentation/utilisation_web/extension-leaflet.html", - "module" : "src/Leaflet/index.js", + "scripts" : {}, "dependencies" : { - "leaflet-draw" : "1.0.4", + "sortablejs" : "1.8.4", "loglevel" : "1.6.6", + "proj4leaflet" : "1.0.2", + "leaflet-draw" : "1.0.4", "xmldom" : "^0.1.27", + "node-fetch" : "^2.6.1", "leaflet" : "1.7.1", "proj4" : "2.7.5", - "node-fetch" : "^2.6.1", - "sortablejs" : "1.8.4", - "geoportal-access-lib" : "3.3.0", - "proj4leaflet" : "1.0.2" + "geoportal-access-lib" : "3.3.1" }, - "description" : "French Geoportal Extension for Leaflet", - "devDependencies" : {}, + "bugs" : {}, "license" : "CECILL-B", - "scripts" : {} + "peerDependencies" : {}, + "module" : "src/Leaflet/index.js", + "version" : "2.3.1", + "keywords" : [ + "geoportail", + "plugin", + "javascript", + "leaflet", + "publish" + ], + "devDependencies" : {}, + "bundleDependencies" : [], + "main" : "dist/GpPluginLeaflet-src.js", + "types" : "src/Leaflet/index.d.ts", + "date" : "07/06/2023", + "homepage" : "https://geoservices.ign.fr/documentation/utilisation_web/extension-leaflet.html" } diff --git a/build/scripts/release/package-openlayers.json b/build/scripts/release/package-openlayers.json index ee63d31b..25aded18 100644 --- a/build/scripts/release/package-openlayers.json +++ b/build/scripts/release/package-openlayers.json @@ -1,35 +1,20 @@ { - "date" : "01/06/2023", + "scripts" : {}, + "bugs" : {}, + "version" : "3.3.1", + "devDependencies" : {}, + "license" : "CECILL-B", "keywords" : [ "geoportail", "plugin", "javascript", "OpenLayers" ], - "version" : "3.2.22", - "module" : "src/OpenLayers/index.js", - "devDependencies" : {}, - "types" : "src/OpenLayers/index.d.ts", "name" : "geoportal-extensions-openlayers", - "directories" : {}, "repository" : { - "url" : "https://github.com/IGNF/geoportal-extensions.git", - "type" : "git" + "type" : "git", + "url" : "https://github.com/IGNF/geoportal-extensions.git" }, - "scripts" : {}, - "license" : "CECILL-B", - "dependencies" : { - "proj4" : "2.7.5", - "node-fetch" : "^2.6.1", - "sortablejs" : "1.14.0", - "@mapbox/mapbox-gl-style-spec" : "13.20.1", - "xmldom" : "^0.1.27", - "loglevel" : "1.6.6", - "eventbusjs" : "0.2.0", - "ol" : "6.9.0", - "geoportal-access-lib" : "3.3.0" - }, - "peerDependencies" : {}, "files" : [ "dist/", "src/", @@ -37,5 +22,20 @@ "README.md", "package.json" ], - "bugs" : {} + "directories" : {}, + "types" : "src/OpenLayers/index.d.ts", + "peerDependencies" : {}, + "module" : "src/OpenLayers/index.js", + "date" : "07/06/2023", + "dependencies" : { + "@mapbox/mapbox-gl-style-spec" : "13.20.1", + "xmldom" : "^0.1.27", + "loglevel" : "1.6.6", + "eventbusjs" : "0.2.0", + "geoportal-access-lib" : "3.3.1", + "sortablejs" : "1.14.0", + "node-fetch" : "^2.6.1", + "ol" : "6.9.0", + "proj4" : "2.7.5" + } } diff --git a/doc/CHANGELOG-itowns.md b/doc/CHANGELOG-itowns.md index 2168ac57..8306da84 100644 --- a/doc/CHANGELOG-itowns.md +++ b/doc/CHANGELOG-itowns.md @@ -85,6 +85,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - [Extension Geoportail Itowns, version 2.3.11](#extension-geoportail-itowns-version-2311) * [Summary](#summary-25) * [Changelog](#changelog-24) +- [Extension Geoportail Itowns, version 2.4.0](#extension-geoportail-itowns-version-240) + * [Summary](#summary-26) + * [Changelog](#changelog-25) + * [Avant :](#avant-) + * [Maintenant :](#maintenant-) @@ -710,3 +715,117 @@ Requete du service alti via les widgets de mousePosition et de profil alti * [Security] --- +# Extension Geoportail Itowns, version 2.4.0 +**07/06/2023** +> Release Extension Geoportail itowns + +## Summary + +Retrait total de l'utilisation du service d'autoconfiguration et utilisation de fichiers de configuration json générés quotidiennement à partir des getCapabilities des services du Geoportail. + +L'ensemble des services de calcul appelés via la bibliothèque d'accès sont désormais appelés avec la clé "calcul" par défaut dans la bibliothèque d'accès. Le paramètre "apiKey" n'est donc plus nécessaire pour appeler les services de géocodage, d'itinéraire, d'isochrone, d'altimétrie et d'autocomplétion, que ce soit directement depuis la bibliothèque d'accès ou via les widgets des extensions Géoportail. + +L'autoconfiguration n'est plus appelée par les API. Pour la remplacer, nous générons quotidiennement, à partir des getCapabilities des services WMS et WMTS, des fichiers de configuration en JSON appelables par les API JavaScript Géoportail. Il y a un fichier par clé générique. L'avantage de ce nouveau processus (en plus de s'adapter au futur arrêt du service d'autoconfiguration) est que les fichiers de configuration JSON sont directement au format attendu par les API : il n'y a plus besoin de les parser pour en extraire les informations utiles puis pour les introduire dans une structure adéquate. + +Par exemple, en renseignant "cartes" au paramètre apiKey, c'est le fichier cartesConfig.json qui sera chargé et directement utilisé par les API. + +A noter que le multiKeys est toujours géré, c'est à dire qu'il est possible de renseigner plusieurs clés dans le paramètre apiKey. + +Il est également possible de générer son propre fichier de configuration à partir d'une ou plusieurs clés. L'utilitaire est temporairement disponible ici : https://geoportal-configuration.onrender.com. Le paramètre permettant ensuite de charger sa configuration personnelle à partir du fichier local généré s'appelle désormais **customConfigFile**, auquel on associera le chemin vers le fichier de configuration json à charger. + +## Changelog + +* [Added] + +* [Changed] + - mise à jour de la bibliothèque d'accès aux services Geoportail en version 3.3.0 (#364) + - **BC** : paramètre "customConfigFile" pour appeler un fichier de configuration local (#364) +##### Avant : +```html + +``` +OU +```javascript +Gp.Services.getConfig({ + serverUrl : "chemin/vers/mon/autoconf/AutoConf.js", + timeOut : 20000, + onSuccess : createMap +}); +``` +##### Maintenant : +```html + +``` +OU +```javascript +Gp.Services.getConfig({ + customConfigFile: "chemin/vers/ma/config/customConfig.json", + timeOut: 20000, + onSuccess: createMap +}); +``` + +* [Deprecated] + +* [Removed] + - **BC** : les originators ne sont plus renvoyés dans la configuration. Il faut les ajouter manuellement aux couches. +```javascript +// Couche WMTS Geoportail +globeView.addLayer(new Gp.itownsExtended.layer.GeoportalWMTS({ + layer: "ORTHOIMAGERY.ORTHOPHOTOS", + itownsParams: { + source: { + attribution: [{ + "name": "Nom raccourci originator", + "url": "http://www.url-vers-le-site-du-producteur.fr", + "constraints": [{ + "crs": "EPSG:4326", + "bbox": { + "left": -180, + "right": 180, + "top": 90, + "bottom": -90 + }, + "minScaleDenominator": 2, + "maxScaleDenominator": 800000 + }] + }, + { + "name": "Nom raccourci originator 2", + "url": "http://www.url-vers-le-site-du-producteur2.fr", + "constraints": [{ + "crs": "EPSG:4326", + "bbox": { + "left": 1.5, + "right": 3, + "top": 49, + "bottom": 48 + }, + "minScaleDenominator": 10000, + "maxScaleDenominator": 450000 + }] + }] + } + } +})); +``` + - **BC** : Les metadatas sont utilisées dans les API par le contrôle gestionnaire de couches (LayerSwitcher). Celui-ci va lire les metadatas des couches ajoutées à la carte et les afficher dans l'encart d'information dédié du LayerSwitcher. **Pour les couches WMTS uniquement**, désormais, pour que les metadatas apparaissent dans l'onglet "informations" du LayerSwitcher, il faudra les renseigner manuellement à la configuration de la couche Géoportail lors de son ajout à la carte. +```javascript +// Couche WMTS Geoportail +globeView.addLayer(new Gp.itownsExtended.layer.GeoportalWMTS({ + layer: "ORTHOIMAGERY.ORTHOPHOTOS", + ssl: true, + metadata: [ + { + format: "xml", + url: "lien/Vers/Une/MetaDonnee.xml" + } + ] +})); +``` + +* [Fixed] + +* [Security] + +--- diff --git a/doc/CHANGELOG-leaflet.md b/doc/CHANGELOG-leaflet.md index f0873a82..2bf57996 100644 --- a/doc/CHANGELOG-leaflet.md +++ b/doc/CHANGELOG-leaflet.md @@ -87,6 +87,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - [Extension Geoportail Leaflet, version 2.2.9](#extension-geoportail-leaflet-version-229) * [Summary](#summary-25) * [Changelog](#changelog-22) +- [Extension Geoportail Leaflet, version 2.3.0](#extension-geoportail-leaflet-version-230) + * [Summary](#summary-26) + * [Changelog](#changelog-23) @@ -787,3 +790,118 @@ Ajout d'écouteurs sur les contrôles de Géocodage direct et inverse * [Security] --- + +# Extension Geoportail Leaflet, version 2.3.0 + +**07/06/2023** +> Release Extension Geoportail leaflet + +## Summary +Retrait total de l'utilisation du service d'autoconfiguration et utilisation de fichiers de configuration json générés quotidiennement à partir des getCapabilities des services du Geoportail. + +L'ensemble des services de calcul appelés via la bibliothèque d'accès sont désormais appelés avec la clé "calcul" par défaut dans la bibliothèque d'accès. Le paramètre "apiKey" n'est donc plus nécessaire pour appeler les services de géocodage, d'itinéraire, d'isochrone, d'altimétrie et d'autocomplétion, que ce soit directement depuis la bibli +othèque d'accès ou via les widgets des extensions Géoportail. + +L'autoconfiguration n'est plus appelée par les API. Pour la remplacer, nous générons quotidiennement, à partir des getCapabilities des services WMS et WMTS, des fichiers de configuration en JSON appelables par les API JavaScript Géoportail. Il y a un fichier par clé générique. L'avantage de ce nouveau processus (en plus de s'adapter au futur arrêt du service d'autoconfiguration) est que les fichiers de configuration JSON sont directement au format attendu par les API : il n'y a plus besoin de les parser pour en extraire les informations utiles puis pour les introduire dans une structure adéquate. + +Par exemple, en renseignant "cartes" au paramètre apiKey, c'est le fichier cartesConfig.json qui sera chargé et directement utilisé par les API. +A noter que le multiKeys est toujours géré, c'est à dire qu'il est possible de renseigner plusieurs clés dans le paramètre apiKey. +Il est également possible de générer son propre fichier de configuration à partir d'une ou plusieurs clés. L'utilitaire est temporairement disponible ici : https://geoportal-configuration.onrender.com. Le paramètre permettant ensuite de charger sa configuration personnelle à partir du fichier local généré s'appelle désormais **customConfigFile**, auquel on associera le chemin vers le fichier de configuration json à charger. + +## Changelog + +* [Changed] + - mise à jour de la bibliothèque d'accès aux services Geoportail en version 3.3.0 (#364) + - **BC** : paramètre "customConfigFile" pour appeler un fichier de configuration local (#364) +##### Avant : +```html + +``` +OU +```javascript +Gp.Services.getConfig({ + serverUrl : "chemin/vers/mon/autoconf/AutoConf.js", + timeOut : 20000, + onSuccess : createMap +}); +``` +##### Maintenant : +```html + +``` +OU +```javascript +Gp.Services.getConfig({ + customConfigFile: "chemin/vers/ma/config/customConfig.json", + timeOut: 20000, + onSuccess: createMap +}); +``` + +* [Removed] + - **BC** : les originators ne sont plus renvoyés dans la configuration. Il faut les ajouter manuellement aux couches. +```javascript +var layer = L.geoportalLayer.WMTS({ + layer: "ORTHOIMAGERY.ORTHOPHOTOS" + }, + { + originators: [{ + name: "Nom raccourci originator", + constraints: [{ + minScaleDenominator: 20000, + maxScaleDenominator: 1000000, + bbox: { + left: -10, + top: 50, + right: 10, + bottom: 40 + } + }, + { + bbox: { + left: 120, + top: 50, + right: 150, + bottom: 35 + } + } + ] + }, + { + url: "http://www.url-vers-le-site-du-producteur.fr", + constraints: [{ + minScaleDenominator: 20000, + maxScaleDenominator: 40000 + }] + }, + { + logo: "https://lien-vers-le-logo.png" + }, + { + attribution: "Titre complet originator", + constraints: [{ + minScaleDenominator: 100000, + maxScaleDenominator: 800000 + }] + }] + }); +``` + + - **BC** : Les metadatas sont utilisées dans les API par le contrôle gestionnaire de couches (LayerSwitcher). Celui-ci va lire les metadatas des couches ajoutées à la carte et les afficher dans l'encart d'information dédié du LayerSwitcher. **Pour les couches WMTS uniquement**, désormais, pour que les metadatas apparaissent dans l'onglet "informations" du LayerSwitcher, il faudra les renseigner manuellement à la configuration de la couche Géoportail lors de son ajout à la carte. +```javascript +var maCoucheGeoportail = L.geoportalLayer.WMTS({ + layer: "GEOGRAPHICALGRIDSYSTEMS.PLANIGNV2" +}, { + metadata: [ + { + format: "xml", + url: "lien/Vers/Une/MetaDonnee.xml" + } + ] +}); +``` +* [Fixed] + +* [Security] + +--- diff --git a/doc/CHANGELOG-openlayers.md b/doc/CHANGELOG-openlayers.md index 30b2c8f8..3ee8841e 100644 --- a/doc/CHANGELOG-openlayers.md +++ b/doc/CHANGELOG-openlayers.md @@ -151,6 +151,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - [Extension Geoportail OpenLayers, version 3.2.22](#extension-geoportail-openlayers-version-3222) * [Summary](#summary-45) * [Changelog](#changelog-42) +- [Extension Geoportail OpenLayers, version 3.3.0](#extension-geoportail-openlayers-version-330) + * [Summary](#summary-46) + * [Changelog](#changelog-43) + * [Avant :](#avant-) + * [Maintenant :](#maintenant-) @@ -1658,3 +1663,139 @@ Amélioration du traitement pour les couches vecteur tuilé (documentation, lég * [Security] --- +# Extension Geoportail OpenLayers, version 3.3.0 + +**07/06/2023** +> Release Extension Geoportail openlayers + +## Summary + +Retrait total de l'utilisation du service d'autoconfiguration et utilisation de fichiers de configuration json générés quotidiennement à partir des getCapabilities des services du Geoportail. + +L'ensemble des services de calcul appelés via la bibliothèque d'accès sont désormais appelés avec la clé "calcul" par défaut dans la bibliothèque d'accès. Le paramètre "apiKey" n'est donc plus nécessaire pour appeler les services de géocodage, d'itinéraire, d'isochrone, d'altimétrie et d'autocomplétion, que ce soit directement depuis la bibli +othèque d'accès ou via les widgets des extensions Géoportail. + +L'autoconfiguration n'est plus appelée par les API. Pour la remplacer, nous générons quotidiennement, à partir des getCapabilities des services WMS et WMTS, des fichiers de configuration en JSON appelables par les API JavaScript Géoportail. Il y a un fichier par clé générique. L'avantage de ce nouveau processus (en plus de s'adapter au futur arrêt du service d'autoconfiguration) est que les fichiers de configuration JSON sont directement au format attendu par les API : il n'y a plus besoin de les parser pour en extraire les informations utiles puis pour les introduire dans une structure adéquate. +Par exemple, en renseignant "cartes" au paramètre apiKey, c'est le fichier cartesConfig.json qui sera chargé et directement utilisé par les API. + +A noter que le multiKeys est toujours géré, c'est à dire qu'il est possible de renseigner plusieurs clés dans le paramètre apiKey. + +Il est également possible de générer son propre fichier de configuration à partir d'une ou plusieurs clés. L'utilitaire est temporairement disponible ici : https://geoportal-configuration.onrender.com. Le paramètre permettant ensuite de charger sa configuration personnelle à partir du fichier local généré s'appelle désormais **customConfigFile**, auquel on associera le chemin vers le fichier de configuration json à charger. + +## Changelog + +* [Added] + +* [Changed] + + - mise à jour de la bibliothèque d'accès aux services Geoportail en version 3.3.0 (#364) + - **BC** : paramètre "customConfigFile" pour appeler un fichier de configuration local (#364) + +##### Avant : + +```html + +``` + +OU + +```javascript +Gp.Services.getConfig({ + serverUrl : "chemin/vers/mon/autoconf/AutoConf.js", + timeOut : 20000, + onSuccess : createMap +}); +``` + +##### Maintenant : + +```html + +``` + +OU + +```javascript +Gp.Services.getConfig({ + customConfigFile: "chemin/vers/ma/config/customConfig.json", + timeOut: 20000, + onSuccess: createMap +}); + +* [Deprecated] + +* [Removed] + + - **BC** : les originators ne sont plus renvoyés dans la configuration. Il faut les ajouter manuellement aux couches. + +```javascript + var gpOrtho = new ol.layer.Tile({ + source: new ol.source.GeoportalWMTS({ + layer: "ORTHOIMAGERY.ORTHOPHOTOS", + olParams: { + attributions: [{ + name: "Nom raccourci originator", + constraints: [{ + minScaleDenominator: 20000, + maxScaleDenominator: 1000000, + bbox: { + left: -10, + top: 50, + right: 10, + bottom: 40 + } + }, + { + bbox: { + left: 120, + top: 50, + right: 150, + bottom: 35 + } + } + ] + }, + { + url: "http://www.url-vers-le-site-du-producteur.fr", + constraints: [{ + minScaleDenominator: 20000, + maxScaleDenominator: 400000 + }] + }, + { + logo: "https://lien-vers-le-logo.png" + }, + { + attribution: "Titre complet originator", + constraints: [{ + minScaleDenominator: 100000, + maxScaleDenominator: 800000 + }] + }] + } + }) + }); +``` + + - **BC** : Les metadatas sont utilisées dans les API par le contrôle gestionnaire de couches (LayerSwitcher). Celui-ci va lire les metadatas des couches ajoutées à la carte et les afficher dans l'encart d'information dédié du LayerSwitcher. **Pour les couches WMTS uniquement**, désormais, pour que les metadatas apparaissent dans l'onglet "informations" du LayerSwitcher, il faudra les renseigner manuellement à la configuration de la couche Géoportail lors de son ajout à la carte. + + +```javascript +new ol.layer.Tile({ + source: new ol.source.GeoportalWMTS({ + layer: "ORTHOIMAGERY.ORTHOPHOTOS", + metadata: [ + { + format: "xml", + url: "lien/Vers/Une/MetaDonnee.xml" + } + ], + }) +}) +``` + +* [Fixed] + +* [Security] + +--- diff --git a/jsdoc.1682087793192.conf.tmp b/jsdoc.1682087793192.conf.tmp deleted file mode 100644 index 188bbc96..00000000 --- a/jsdoc.1682087793192.conf.tmp +++ /dev/null @@ -1 +0,0 @@ -{"tags":{"allowUnknownTags":true},"plugins":["plugins/markdown"],"source":{"include":["./src/OpenLayers","./src/Common","./build/jsdoc/README-openlayers.md"]},"templates":{"cleverLinks":false,"applicationName":"Geoportal Extension for OpenLayers","monospaceLinks":false,"dateFormat":"ddd MMM Do YYYY","outputSourceFiles":true,"outputSourcePath":true,"systemName":"Geoportal Extension for OpenLayers","footer":"API Reference","copyright":"Geoportail - Copyright (c) IGN, released under the CECILL-B license","navType":"inline","theme":"darkly","linenums":true,"collapseSymbols":true,"inverseNav":true,"highlightTutorialCode":false,"syntaxTheme":"default"},"markdown":{"parser":"gfm","hardwrap":true},"opts":{"template":"./build/jsdoc/jaguarjs-jsdoc","encoding":"utf8","destination":"./jsdoc/openlayers","recurse":true,"lenient":true,"verbose":true}} \ No newline at end of file