Ajout d’un header ETag au téléchargement des annexes et documents personnels
\nL’ajout du header ETag dans les réponses permettra aux applications clientes de gérer plus proprement le cache. Les routes concernées sont :
\nAjout du bon MIME type sur les fichiers Géoparquet dans le descripteur d’archive
\nLes nouvelles archives contenant des fichiers Géoparquet auront maintenant le MIME type « application/vnd.apache.parquet » dans le descripteur d’archive (au lieu de « application/octet-stream » actuellement).
\nAugmentation du nombre de valeurs pour le filtre « city-code » pour Géocodage et ajout du filtre « city-code » pour l’autocomplétion
\nPour le Géocodage, le nombre de valeurs maximum du filtre « city-code » passe de 50 à 200 (pour tenir compte de certains EPCI composés de plus de 50 communes).
\nPour l’autocomplétion, le filtre « city-code » est ajouté avec un maximum de valeurs maximum de 200.
\nAugmentation du rate limiting pour l’itinéraire
\nLa limite d’usage par IP du calcul itinéraire passe de 5 à 10 requêtes par seconde.
\n", "date_published": "2026-05-06T00:00:00Z" }, { "id": "https://cartes.gouv.fr/aide/fr/guides-utilisateur/utiliser-les-services-de-la-geoplateforme/changements-evolutions/changements-sur-le-telechargement/", "url": "https://cartes.gouv.fr/aide/fr/guides-utilisateur/utiliser-les-services-de-la-geoplateforme/changements-evolutions/changements-sur-le-telechargement/", "title": "Changements sur le Téléchargement", "content_html": "Ajout d’agrégat d’informations dans la description d’une ressource de téléchargement
\nDans un GET resource, dans la description de la ressource, est ajouté un agrégat des zones, formats et SRS ainsi que les dates min et max de l’édition (comme cela est fait pour chaque ressource dans le GetCapabilities)
\nAjout des paramètres de tri des entrées d’une ressource pour le téléchargement
\nActuellement, la liste des sous-ressources d’une ressource donnée est triée par ordre alphabétique.
\nIl sera maintenant possible de trier les sous-ressources avec le paramètre sortEntriesBy qui pourra prendre ces valeurs :
\nIl sera possible de trier de façon croissante et décroissante avec le paramètre « sortEntriesOrder » qui prendra les valeurs :
\nAjout du bon content type pour les fichiers Géoparquet téléchargés
\nLorsque l’on télécharge un fichier Géoparquet, le content type sera « application/vnd.apache.parquet » (au lieu de « application/octet-stream » actuellement)
\n", "date_published": "2026-04-29T00:00:00Z" }, { "id": "https://cartes.gouv.fr/aide/fr/guides-utilisateur/utiliser-les-services-de-la-geoplateforme/changements-evolutions/changement-sur-le-geocodage/", "url": "https://cartes.gouv.fr/aide/fr/guides-utilisateur/utiliser-les-services-de-la-geoplateforme/changements-evolutions/changement-sur-le-geocodage/", "title": "Changement sur le Géocodage", "content_html": "Ajout de nouveaux paramètres de filtrage au géocodage
\nPlusieurs paramètres sont ajoutés au Géocodage :
\nAjout du support des valeurs multiples pour certains paramètres de filtrage du géocodage
\nAjout du support des valeurs multiples sur certains paramètres de filtrage avec des limites pour éviter les abus. Voici la liste des paramètres concernés :
\nChangement des courriels automatiques envoyés par le Keycloak
\nOptimisation du service pg_tileserv
\nJusqu’à présent, le PostgreSQL proxy faisait des requêtes sur le PostgreSQL source sans filtrage géométrique. Ce qui faisait une lecture longue et gourmande qui pouvait fortement ralentir le service. Cela va être corrigé pour accélérer le service.
\nMontée de version ROK4 (WMTS et WMS Raster)
\nChangements d’informations dans le GetCap CSW.
\n", "date_published": "2026-03-11T00:00:00Z" }, { "id": "https://cartes.gouv.fr/aide/fr/guides-utilisateur/utiliser-les-services-de-la-geoplateforme/changements-evolutions/changements-sur-les-services-vecteur/", "url": "https://cartes.gouv.fr/aide/fr/guides-utilisateur/utiliser-les-services-de-la-geoplateforme/changements-evolutions/changements-sur-les-services-vecteur/", "title": "Changements sur les services Vecteur", "content_html": "Lorsque l’on souhaite livrer une donnée vecteur, le check-vector va contrôler le nom des tables de la donnée (pour qu’elle puisse être comprise par Geoserver). Les tables devront respecter ces règles :
\nChangements d’informations dans le GetCapabilities CSW.
\nModification de l’interface de compte Keycloak :
\nModification des pages de login et création de compte pour le Keycloak.
\nUtilisation du terme adresse électronique quand on parle de l’adresse et de courriel quand on parle du contenu du message.
\nModification des informations dans les GetCap extraction et TMS.
\nAjout du paramètre « fields » pour la liste des documents personnels.
\nSur la route « GET /users/me/documents », ajout du paramètre de requête « fields » qui permettra de ne renvoyer que les champs d’un document souhaités parmi la liste suivante (à l’exception de « id » qui est retourné dans tous les cas) :
\nPar défaut (si « fields » est vide), on retourne les valeurs suivantes :
\nAjout du type de métadonnée StyleSheet dans la configuration pour les styles
\nCe style n’est utilisable que pour les configurations WMS Raster.
\nLimitation à 99 caractères du nom des organismes dans l’entrepôt.
\nSuite à cette montée de version, des perturbations pourront être observés sur le service jusqu’à la fin de la journée.
\nModifications des informations des le GetCap Géocodage.
\nModification des informations dans les GetCap WFS, WMS-V et « Téléchargement ».
\nModification de la description du champ « terr » dans le GetCap Géocodage.
\nPassage de :
\n\"une limitation de la zone de recherche de localisants. Les valeurs acceptées sont METROPOLE, DOMTOM, les codes département et les codes communes (INSEE).\"à :
\n\"une limitation de la zone de recherche de localisants. Les valeurs acceptées sont METROPOLE, DOMTOM, code(s) INSEE de département, code(s) postaux de commune\"WMTS, WMS, WFS : envoi d’une erreur si un paramètre présent X fois avec une valeur différente.
\nCette montée de version va améliorer la robustesse du calcul des pyramides vecteurs. Les changements de comportement sont :
\nDocument : Faire une erreur dès que la taille de fichier limite est atteinte
\nUne erreur 409 est renvoyée dès que le fichier téléversé est trop grand.
\nDépréciation du paramètre « available » des offres.
\nCe paramètre ne fonctionnait pas correctement et est donc supprimé le temps que son comportement soit retravaillé (en amont, toutes les offres en « available=false » ont été converties en « available=true » pour permettre la suppression du paramètre).
\nAjout du format « application/atom+xml » pour les routes d’activités.
\nLes routes concernées sont :
\nAjout d’un service de validation de données qui permet de vérifier si la donnée est conforme à un modèle de validation. Le Swagger du service sera disponible après la livraison : https://data.geopf.fr/validation/swagger-ui/index.html
\nLes exécutions, qu’elles soient de vérification ou de traitement, sont les actions sur l’entrepôt qui peuvent prendre du temps et dont la fin est attendue pour passer à la suite du workflow. Pour éviter à une personne de devoir consulter régulièrement un portail, ou un outil de devoir régulièrement interroger l’API, un système de callback est mis en place.
\nCe callback est appelé à la fin de l’exécution, en précisant le statut (SUCCESS, ABORTED, FAILURE).
\nIl peut être défini au niveau de l’exécution, dans le nouveau champ « callback » :
\nPlusieurs types de callback ont été identifiés :
\nUn envoi de mail
\n{\n \"callback\": {\n \"type\": \"email\",\n \"to\": [\"email1@ign.fr\", \"email2@ign.fr\"],\n \"entity_url\": \"https://cartes.gouv.fr/entrepot//donnees//details?datasheetName=CarHab-Jura\"\n }\n}Un appel à une API
\n{\n \"callback\": {\n \"type\": \"api\",\n \"method\": \"POST\", // PUT et PATCH aussi acceptés, on veut juste avoir un body\n \"url\": \"https://api.chez.moi/sous/route\",\n \"query_params\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"headers\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n }\n }\n}Informations envoyées, dans le body :
\n{\n \"type\": \"PROCESSING\", // ou \"CHECK\"\n \"id\": \"{id}\",\n \"status\": \"{status}\", // SUCCESS, FAILURE ou ABORTED\n \"execution_url\": \"{endpoint api entrepôt}/datastores/{id}/{checks|processings}/executions/{id}\",\n \"log_url\": \"{endpoint api entrepôt}/datastores/{id}/{checks|processings}/executions/{id}\"\n}Des routes permettant de récupérer le flux d’évènements de 3 entités d’un entrepôt ont été ajoutées. Les entités concernées sont les données stockées, livraisons et configurations :
\nCes requêtes peuvent prendre comme paramètres :
\nExemple :
\n\n/datastores/{datastore}/stored_data/activity{\n \"id\": \"string\",\n \"title\": \"string\",\n \"subtitle\": \"string\",\n \"updated\": \"2025-08-08T08:40:54.056Z\",\n \"links\": [\n {\n \"href\": \"string\",\n \"rel\": \"self\",\n \"type\": \"string\",\n \"title\": \"string\"\n }\n ],\n \"rights\": \"string\",\n \"author\": {\n \"name\": \"string\",\n \"email\": \"string\"\n },\n \"entries\": [\n {\n \"id\": \"string\",\n \"title\": \"string\",\n \"subtitle\": \"string\",\n \"updated\": \"2025-08-08T08:40:54.057Z\",\n \"links\": [\n {\n \"href\": \"string\",\n \"rel\": \"self\",\n \"type\": \"string\",\n \"title\": \"string\"\n }\n ],\n \"content\": \"string\",\n \"categories\": [\n {\n \"term\": \"string\",\n \"label\": \"string\"\n }\n ],\n \"polygon\": {\n \"west\": 0,\n \"south\": 0,\n \"east\": 0,\n \"north\": 0\n }\n }\n ]\n}Des routes permettant de récupérer le flux d’évènements d’une communauté ont été ajoutées :
\nCes requêtes peuvent prendre comme paramètres :
\nExemple :
\n\n/communities/{community}/users/activity{\n \"id\": \"string\",\n \"title\": \"string\",\n \"subtitle\": \"string\",\n \"updated\": \"2025-08-08T09:03:54.104Z\",\n \"links\": [\n {\n \"href\": \"string\",\n \"rel\": \"self\",\n \"type\": \"string\",\n \"title\": \"string\"\n }\n ],\n \"rights\": \"string\",\n \"author\": {\n \"name\": \"string\",\n \"email\": \"string\"\n },\n \"entries\": [\n {\n \"id\": \"string\",\n \"title\": \"string\",\n \"subtitle\": \"string\",\n \"updated\": \"2025-08-08T09:03:54.104Z\",\n \"links\": [\n {\n \"href\": \"string\",\n \"rel\": \"self\",\n \"type\": \"string\",\n \"title\": \"string\"\n }\n ],\n \"content\": \"string\",\n \"categories\": [\n {\n \"term\": \"string\",\n \"label\": \"string\"\n }\n ],\n \"polygon\": {\n \"west\": 0,\n \"south\": 0,\n \"east\": 0,\n \"north\": 0\n }\n }\n ]\n}Dans la route de listage des utilisateurs d’une communauté (GET /communities/{community}/users), des dates « creation » et « update » sont ajoutés pour chaque utilisateur.
\nLe champ creation correspond à la date d’ajout de l’utilisateur à la communauté. Le champ « update » correspond à la dernière modification des droits de l’utilisateur sur la communauté.
\nLors de la livraison, une date fixe de création et de modification est ajoutée à chaque utilisateur : 1er janvier 2025.
\nLes champs « creation » et « update » sont actualisés lors d’un appel « PUT /communities/{community}/users/{user} » pour l’ajout d’un utilisateur.
\nLe champ « update » est actualisé lors de l’appel « PUT /communities/{community}/users/{user} » pour une modification de droits d’un utilisateur.
\nAjout de la notion de « publicité » d’un évènement pour déterminer si ceux-ci doivent être publics dans la nouvelle route présentée ci-dessous.
\nCette notion est représentée par le champ « public_activity » ajouté aux données stockées et offres. Par défaut et pour l’existant, sa valeur est à false.
\nLa valeur de ce champ peut être modifiée grâce à ses routes :
\n/datastores/{datastore}/stored_data/{stored_data}\n{\n \"name\": \"string\",\n \"open\": true,\n \"description\": \"string\",\n \"edition\": {\n \"from\": \"2025-08-08\",\n \"to\": \"2025-08-08\"\n },\n \"extent\": {},\n \"extra\": {},\n \"public_activity\": true\n}Une route permet de récupérer le flux d’évènements publics d’une communauté : GET /communities/{technical_name}/activity
\nLes paramètres possibles de la requêtes sont :
\nSeuls la création et la modification des données stockées et des offerings qui ont un champ « public_activity » à « true » sont affichées dans le flux.
\n\n/communities/{technical_name}/activity{\n \"id\": \"string\",\n \"title\": \"string\",\n \"subtitle\": \"string\",\n \"updated\": \"2025-08-08T09:29:15.762Z\",\n \"links\": [\n {\n \"href\": \"string\",\n \"rel\": \"self\",\n \"type\": \"string\",\n \"title\": \"string\"\n }\n ],\n \"rights\": \"string\",\n \"author\": {\n \"name\": \"string\",\n \"email\": \"string\"\n },\n \"entries\": [\n {\n \"id\": \"string\",\n \"title\": \"string\",\n \"subtitle\": \"string\",\n \"updated\": \"2025-08-08T09:29:15.762Z\",\n \"links\": [\n {\n \"href\": \"string\",\n \"rel\": \"self\",\n \"type\": \"string\",\n \"title\": \"string\"\n }\n ],\n \"content\": \"string\",\n \"categories\": [\n {\n \"term\": \"string\",\n \"label\": \"string\"\n }\n ],\n \"polygon\": {\n \"west\": 0,\n \"south\": 0,\n \"east\": 0,\n \"north\": 0\n }\n }\n ]\n}La suppression d’une livraison au statut UNSTABLE est maintenant possible avec la route :
\n\n/datastores/{datastore}/uploads/{upload}Mise en place d’une API permettant de récupérer un fichier contenu dans une livraison.
\nLe paramètre à préciser dans la requête :
\n/datastores/{datastore}/uploads/{upload}/dataEn sortie, le fichier demandé est téléchargé.
\nPour la route API « PATCH /datastores/{datastore}/uploads/{upload} », il est maintenant possible de modifier le SRS de la livraison dans le request body de l’API.
\nAfin d’améliorer la maintenabilité du système, les fichiers préfixés par le double underscore « __ » sont ignorés lors des vérifications de la livraison et lors des traitements. En conséquence, par exemple, pour la génération d’une donnée stockée « ARCHIVE » depuis une livraison « ARCHIVE », les fichiers « ignorés » présents dans la livraison ne se retrouvent pas dans la donnée stockée.
\nAjout du TMS 2154_50cm_MNT et modification du TMS 2154_1M_MNT.
\nAjout du TMS 2154_50cm_MNT : l’origine est décalée pour que les valeurs des données LidarHD, valeurs sur le maillage, soit bien la valeur au centre du pixel dans les données de la pyramide (au niveau du bas).
\nChangement du TMS 2154_1M_MNT : l’origine est décalée pour que les valeurs des données RGEAlti, valeurs sur le maillage, soit bien la valeur au centre du pixel dans les données de la pyramide (au niveau du bas).
\nAfin d’harmoniser les livraisons avec les données stockées, la ligne de catalogage des livraisons est supprimée : GET /catalogs/uploads
\nAjout d’une API permettant à un utilisateur d’un datastore d’accorder la visibilité d’une de ses données stockées à une ou plusieurs communautés pour leur permettre d’utiliser la donnée en lecture.
\n\n/datastores/{datastore}/stored_data/{stored_data}/visibility[\n \"{id_community}\"\n][\n {\n \"creation\": \"2025-07-30T08:12:04.934Z\",\n \"update\": \"2025-07-30T08:12:04.934Z\",\n \"name\": \"string\",\n \"_id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n }\n]Il est ensuite possible de récupérer la liste des visibilités accordées à une de ses données stockées :
\n\n/datastores/{datastore}/stored_data/{stored_data}/visibility[\n {\n \"creation\": \"2025-07-30T08:12:04.934Z\",\n \"update\": \"2025-07-30T08:12:04.934Z\",\n \"name\": \"string\",\n \"_id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n }\n]Il est aussi possible de supprimer la visibilité d’une donnée stockée :
\n\n/datastores/{datastore}/stored_data/{stored_data}/visibility[\n \"{id_community}\"\n]Les titres des évènements sont améliorés pour être plus parlants pour les utilisateurs. Les évènements sont accessibles à ces URL :
\n\n/datastores/{datastore}/uploads/{upload}/events/datastores/{datastore}/stored_data/{stored_data}/events/datastores/{datastore}/configurations/{configuration}/eventsAjout d’un filtrage sur la recherche des clés utilisateur : GET /users/me/keys
\nLes champs sur lesquels il est possible de filtrer sont :
\nLes exécutions de traitement et de vérification possède un champ « creation » de type « date ». Ce champ est généraliser à toutes les entités :
\nDans le cas des exécutions de traitement, les champs suivant sont renommés pour l’occasion :
\nCe nouveau permet de connaitre facilement la date de dernière modification « importante » sur les entités. Le nouveau champ est appelé « update » et est ajouté à ces entités :
\nCe champ est mise à jour lors de ces évènements :
\nModification du système de tri dans les listes d’entités.
\nLe tri par « lastEvent » est remplacé par « last_event ». Exemple :
\n\n/datastores/{datastore}/configurations?sort=last_event,desc[\n {\n \"name\": \"BDORTHO en infrarouge fausses couleurs\",\n \"layer_name\": \"ORTHOIMAGERY.ORTHOPHOTOS.IRC\",\n \"type\": \"WMS-RASTER\",\n \"status\": \"PUBLISHED\",\n \"_id\": \"bc5c244f-1528-41d3-bad9-d6557cbefce5\"\n },\n {\n \"name\": \"BDORTHO en infrarouge fausses couleurs\",\n \"layer_name\": \"ORTHOIMAGERY.ORTHOPHOTOS.IRC\",\n \"type\": \"WMTS-TMS\",\n \"status\": \"PUBLISHED\",\n \"_id\": \"578fb2b4-3246-4900-9776-ad533cc0cf4e\"\n },\n {\n \"name\": \"Ortho_20_cm-wmsr\",\n \"layer_name\": \"HR.ORTHOIMAGERY.ORTHOPHOTOS\",\n \"type\": \"WMS-RASTER\",\n \"status\": \"PUBLISHED\",\n \"_id\": \"c4206604-6f96-47a5-bed5-32cf3b63c571\"\n }\n]De plus, ajout de la possibilité de trier par date de création (« creation ») et par date de mise à jour (« update ») pour les API suivantes :
\nEt, pour les API suivantes, ajout uniquement de la possibilité de trier par date de création (« creation ») :
\nListe les stockages disponibles pour le datastore. Les paramètres disponibles pour la route sont :
\n/datastores/{datastore}/storages{\n \"data\": [\n {\n \"use\": 0,\n \"quota\": 0,\n \"storage\": {\n \"creation\": \"2025-07-30T08:44:31.208Z\",\n \"update\": \"2025-07-30T08:44:31.208Z\",\n \"name\": \"string\",\n \"type\": \"POSTGRESQL\",\n \"labels\": [\n \"string\"\n ],\n \"_id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n }\n }\n ],\n \"uploads\": {\n \"use\": 0,\n \"quota\": 0,\n \"storage\": {\n \"creation\": \"2025-07-30T08:44:31.208Z\",\n \"update\": \"2025-07-30T08:44:31.208Z\",\n \"name\": \"string\",\n \"type\": \"POSTGRESQL\",\n \"labels\": [\n \"string\"\n ],\n \"_id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n }\n },\n \"annexes\": {\n \"use\": 0,\n \"quota\": 0,\n \"storage\": {\n \"creation\": \"2025-07-30T08:44:31.208Z\",\n \"update\": \"2025-07-30T08:44:31.208Z\",\n \"name\": \"string\",\n \"type\": \"POSTGRESQL\",\n \"labels\": [\n \"string\"\n ],\n \"_id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n }\n }\n}Une harmonisation est réalisée en supprimant la visibilité associée aux entités et en ajoutant une notion de publicité.
\nPour les livraisons et les données stockées, le champs « visibility » est remplacé par « open ».
\nAinsi, les livraisons et données stockées en « visibility=PUBLIC » deviennent « open=true » et celles en « visibility=REFERENCED » ou « visibility=PRIVATE » deviennent « open=false ».
\nLes livraisons et données stockées en « open=true » pourront donc être utilisé dans les traitements d’autres datastores.
\nCette modification impacte la création de la livraison et il faut bien remplacé le champ « visibility » par « open » pour que la création fonctionne.
\nAjout d’une API permettant à un utilisateur de connaitre les données stockées qui lui sont visibles.
\nLes paramètres de filtrage sont identiques à ceux de « GET /datastores/{datastore}/stored_data », sauf « owned » et « shared ».
\n\n/users/me/stored_data[\n {\n \"creation\": \"2025-07-30T09:29:22.332Z\",\n \"update\": \"2025-07-30T09:29:22.332Z\",\n \"name\": \"string\",\n \"type\": \"ROK4-PYRAMID-RASTER\",\n \"open\": true,\n \"srs\": \"string\",\n \"description\": \"string\",\n \"status\": \"CREATED\",\n \"contact\": \"string\",\n \"bbox\": {\n \"west\": 0,\n \"south\": 0,\n \"east\": 0,\n \"north\": 0\n },\n \"size\": 0,\n \"last_event\": {\n \"title\": \"string\",\n \"text\": \"string\",\n \"date\": \"2025-07-30T09:29:22.332Z\",\n \"initiator\": {\n \"creation\": \"2025-07-30T09:29:22.332Z\",\n \"update\": \"2025-07-30T09:29:22.332Z\",\n \"last_name\": \"string\",\n \"first_name\": \"string\",\n \"_id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n }\n },\n \"tags\": {\n \"additionalProp1\": \"string\",\n \"additionalProp2\": \"string\",\n \"additionalProp3\": \"string\"\n },\n \"edition\": {\n \"from\": \"2025-07-30\",\n \"to\": \"2025-07-30\"\n },\n \"_id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n }\n]De plus, une route supplémentaire permet de récupérer les informations d’une donnée stockée visisible de l’utilisateur :
\n\n/users/me/stored_data/{stored_data}[\n {\n \"creation\": \"2025-07-30T09:29:22.332Z\",\n \"update\": \"2025-07-30T09:29:22.332Z\",\n \"name\": \"string\",\n \"type\": \"ROK4-PYRAMID-RASTER\",\n \"open\": true,\n \"srs\": \"string\",\n \"description\": \"string\",\n \"status\": \"CREATED\",\n \"contact\": \"string\",\n \"bbox\": {\n \"west\": 0,\n \"south\": 0,\n \"east\": 0,\n \"north\": 0\n },\n \"size\": 0,\n \"last_event\": {\n \"title\": \"string\",\n \"text\": \"string\",\n \"date\": \"2025-07-30T09:29:22.332Z\",\n \"initiator\": {\n \"creation\": \"2025-07-30T09:29:22.332Z\",\n \"update\": \"2025-07-30T09:29:22.332Z\",\n \"last_name\": \"string\",\n \"first_name\": \"string\",\n \"_id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n }\n },\n \"tags\": {\n \"additionalProp1\": \"string\",\n \"additionalProp2\": \"string\",\n \"additionalProp3\": \"string\"\n },\n \"edition\": {\n \"from\": \"2025-07-30\",\n \"to\": \"2025-07-30\"\n },\n \"_id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n }\n]Pour l’API, « GET /datastores/{datastore}/processings », le champ d’énumération « fields » a été ajouté pour préciser les champs souhaités dans la réponse. Les valeurs disponibles sont :
\nPar défaut, la réponse contient les champs « name » et « description ».
\n", "date_published": "2025-07-24T00:00:00Z" }, { "id": "https://cartes.gouv.fr/aide/fr/guides-utilisateur/utiliser-les-services-de-la-geoplateforme/changements-evolutions/liste-des-points-d-acces-d-un-entrepot/", "url": "https://cartes.gouv.fr/aide/fr/guides-utilisateur/utiliser-les-services-de-la-geoplateforme/changements-evolutions/liste-des-points-d-acces-d-un-entrepot/", "title": "Liste des points d’accès d’un entrepôt", "content_html": "Il est possible de consulter les points d’accès disponibles pour un entrepôt avec la nouvelle route d’API « GET /datastores/{datastore}/endpoints », avec des filtrages sur les noms, types et quotas.
\n\n/datastores/{datastore}/endpoints| Paramètres de requête |
|---|
| name = `%25téléchargement%25` |
| type = `DOWNLOAD` |
| open = `true` |
| use_ratio = `50 pour avoir tous les points d’accès dont le quota est consommé à plus de 50%` |
[\n {\n \"use\": 8,\n \"quota\": 10,\n \"endpoint\": {\n \"name\": \"Service de téléchargement partiel\",\n \"technical_name\": \"gpf-download-chunk\",\n \"type\": \"DOWNLOAD\",\n \"urls\": [\n {\n \"type\": \"DOWNLOAD\",\n \"url\": \"https://data.geopf.fr/chunk/telechargement\"\n }\n ],\n \"force_metadata\": false,\n \"force_attribution\": false,\n \"search_publish\": true,\n \"_id\": \"304515ec-502a-4d1b-9353-326cbbec10f9\",\n \"open\": true,\n \"metadata_fi\": \"gpf-download-chunk\"\n }\n }\n]Le joker est le caractère « % ». Attention de bien mettre « %25 » pour qu’il soit correctement encodé dans les requêtes. Il remplace zéro à plusieurs caractères. Le filtre est insensible à la casse.
\n/datastores/{datastore}/checks| Paramètres de requête |
|---|
| name = `%25string%25` |
/datastores/{datastore}/configurations| Paramètres de requête |
|---|
| name = `%25string%25` |
| layer_name = `%25string%25` |
/datastores/{datastore}/offerings| Paramètres de requête |
|---|
| layer_name = `%25string%25` |
/datastores/{datastore}/annexes| Paramètres de requête |
|---|
| mime_type = `%25string%25` |
/users/me/documents| Paramètres de requête |
|---|
| mime_type = `%25string%25` |
/users/me/permissions| Paramètres de requête |
|---|
| license = `%25string%25` |
| only_oauth = `true` |
| layer_name = `%25string%25 : ne retourne que les permissions qui contiennent au moins une couche correspondant à cette chaîne` |
/users/me/keys| Paramètres de requête |
|---|
| type = `BASIC` |
| user_agent = `%25string%25` |
| referer = `%25string%25` |
| whitelist = `%25string%25` |
| blacklist = `%25string%25` |
| name = `%25string%25` |
/statics/tms| Paramètres de requête |
|---|
| type = `%25string%25 : filtre sur l’identifiant du TMS` |
| srs = `%25string%25` |
| resolution = `0.1 : ne retourne que les TMS incluant la résolution donnée entre le plus haut niveau et le plus bas` |
Pour avoir un champ « extra » personnalisé sur le service de recherche de couche, il suffit d’ajouter ces informations au niveau de la configuration
\nAvec la valeur « extra » suivante sur la configuration :
\n\n{\n ...\n \"extra\": {\n \"_search\": {\n \"toto\": \"titi\"\n },\n \"interne\": \"secret\"\n },\n ...\n}On retrouvera la valeur suivante sur le service de recherche :
\n\n{\n ...\n \"extra\": {\n \"toto\": \"titi\"\n },\n ...\n} Seule la sous-partie « _search » est publiée pour pouvoir utiliser le champ « extra » de la configuration pour des informations internes.
\n", "date_published": "2025-03-25T00:00:00Z" }, { "id": "https://cartes.gouv.fr/aide/fr/guides-utilisateur/utiliser-les-services-de-la-geoplateforme/changements-evolutions/derivation-vecteur/", "url": "https://cartes.gouv.fr/aide/fr/guides-utilisateur/utiliser-les-services-de-la-geoplateforme/changements-evolutions/derivation-vecteur/", "title": "Dérivation vecteur", "content_html": "Un nouveau traitement permet de modifier le contenu et même la structure d’une donnée stockée de type VECTOR-DB via des templates SQL. Un tutoriel décrit la démarche ici.
\n", "date_published": "2025-03-25T00:00:00Z" }, { "id": "https://cartes.gouv.fr/aide/fr/guides-utilisateur/utiliser-les-services-de-la-geoplateforme/changements-evolutions/notion-d-organisme/", "url": "https://cartes.gouv.fr/aide/fr/guides-utilisateur/utiliser-les-services-de-la-geoplateforme/changements-evolutions/notion-d-organisme/", "title": "Notion d’organisme", "content_html": "L’objectif est de faciliter le travail des personnes gérant plusieurs communautés, en permettant une lecture des entités des datastores via un point d’entrée unique. Cela permet également de définir des quotas de livraison globaux. Pour pouvoir accéder à ce contenu via l’organisme, il faut être un membre officiel de celui-ci. Être un membre d’une des communautés ne donne pas automatiquement d’accès aux API Organisme.
\nPour savoir si votre communauté est rattachée à un organisme, faites la requête suivante.
\n\n/communities/{community}{\n \"name\": \"Ma communauté\",\n \"technical_name\": \"community\",\n \"organization\": {\n \"name\": \"Mon organisme\",\n \"_id\": \"{organization}\"\n },\n \"datastore\": {\n \"active\": true,\n \"_id\": \"{datastore}\"\n },\n \"supervisor\": {\n \"last_name\": \"Lopper\",\n \"first_name\": \"Dave\",\n \"_id\": \"{user}\"\n },\n \"_id\": \"{community}\",\n \"public\": false\n}Pour plus d’informations sur l’utilisation des organismes, lire le tutoriel ici.
\n", "date_published": "2025-02-15T00:00:00Z" }, { "id": "https://cartes.gouv.fr/aide/fr/guides-utilisateur/utiliser-les-services-de-la-geoplateforme/changements-evolutions/mise-en-coherence-de-la-notion-de-publicite-des-offres/", "url": "https://cartes.gouv.fr/aide/fr/guides-utilisateur/utiliser-les-services-de-la-geoplateforme/changements-evolutions/mise-en-coherence-de-la-notion-de-publicite-des-offres/", "title": "Mise en cohérence de la notion de publicité des offres", "content_html": "Les entités suivantes sont concernées :
\nExemple d’utilisation pour des données stockées
\n\n/datatores/{datastore}/stored_data| Paramètres de requête |
|---|
| fields = `last_event,bbox,tags` |
[\n {\n \"bbox\": {\n \"west\": 4.716841851,\n \"south\": 45.597425194,\n \"east\": 6.17889785,\n \"north\": 46.527234038\n },\n \"last_event\": {\n \"title\": \"Création\",\n \"date\": \"2024-01-23T11:30:52.703181\",\n \"initiator\": {\n \"last_name\": \"Lopper\",\n \"first_name\": \"Dave\",\n \"_id\": \"{user}\"\n }\n },\n \"tags\": {},\n \"_id\": \"{stored data 1}\"\n },\n {\n \"bbox\": {\n \"west\": -5.332540084,\n \"south\": 41.2061106614,\n \"east\": 9.854320085,\n \"north\": 51.2032464945\n },\n \"last_event\": {\n \"title\": \"Génération\",\n \"date\": \"2024-09-16T08:05:46.68324\",\n \"initiator\": {\n \"last_name\": \"Lopper\",\n \"first_name\": \"Dave\",\n \"_id\": \"{user}\"\n }\n },\n \"tags\": {},\n \"_id\": \"{stored data 2}\"\n }\n]Les entités suivantes sont concernées :
\nIl peut être ajouté et mis à jour via la route « PATCH/datastores/{datastore}/{entity}/{id} ». Ce champ n’est pas interprété par l’entrepôt, c’est-à-dire qu’il n’est pas possible de filtrer sur sa valeur dans les routes de liste des entités. Il permet en revanche à une application de stocker des informations structurées propres à son fonctionnement sans avoir besoin de stockage persistant de son côté.
\nExemple d’utilisation pour une livraison :
\n\n/datastores/{datastore}/uploads/{upload}{\n \"extra\": {\n \"test\": \"toto\",\n \"titi\": [{\"tutu\": \"tata\"}]\n }\n}{\n \"name\": \"SCAN1000 - Corse\",\n \"description\": \"Données SCAN1000 sur la Corse\",\n \"type\": \"RASTER\",\n \"status\": \"OPEN\",\n \"srs\": \"EPSG:2154\",\n \"contact\": \"contact@ign.fr\",\n \"size\": 0,\n \"last_event\": {\n \"title\": \"Création\",\n \"date\": \"2023-05-22T08:07:13.812601878\",\n \"initiator\": {\n \"_id\": \"{user}\"\n }\n },\n \"extra\": {\n \"test\": \"toto\",\n \"titi\": [{\"tutu\": \"tata\"}]\n },\n \"_id\": \"{upload}\",\n \"type_infos\": {}\n}Une offre n’a plus d’attribut « visibility », mais un champ « open ».
\nLes règles sont les suivantes :
\nAfin d’améliorer les performances du téléversement de données, des changements sur l’infrastructure ont été faits impliquant une modification de l’interface de téléversement.
\nCette modification est actuellement déployée sur l’environnement de qualification. Elle sera déployée le 20 février sur l’environnement de production.
\nLes téléversements en dehors des données dans une livraison (métadonnées, annexes, statiques, fichiers MD5 dans une livraison) restent inchangés.
\n/datastores/{datastore}/uploads/{upload}/data| Paramètres de requête |
|---|
| file = `image.tif` |
| path = `data` |
L’information du chemin où écrire le fichier dans la livraison (path) devient un paramètre de requête et doit préciser le nom du fichier. Cela permet de changer de nom de fichier par rapport à celui en local.
\n\n/datastores/{datastore}/uploads/{upload}/data?path=data/image.tif| Paramètres de requête |
|---|
| file = `image.tif` |