Service bêta Géoplateforme de téléchargement
- Présentation
- Lister les ressources (GetCapabilities)
- Lister les fichiers (GetResource)
- Télécharger un fichier (Download)
Table des matières
Titre
Présentation
Le Service de téléchargement de la Géoplateforme permet de découvrir et télécharger des fichiers.
Il est conforme au standard Atom RFC 4287.
Ce service s'appuie sur une API disposant de 3 méthodes :
- GetCapabilites pour lister les ressources disponibles
- GetResource pour lister les fichiers téléchargeables de la ressource interrogée
- Download pour télécharger un fichier
Cette version bêta implique que les URL listées dans cette rubrique ne sont pas définitives et susceptibles d'évolutions. A date, la prochaine modification de ces URL est prévue en juin 2023. Les caractéristiques d'évolution seront communiquées dès que possible.
Titre
Lister les ressources (GetCapabilities)
La méthode GetCapabilities permet de lister les ressources du service.
Elle est accessible via l'URL suivante :
https://data.geopf.fr/beta/telechargement/capabilities
Afin de permettre une recherche plus précise, elle dispose des filtres optionnels suivants :
https://data.geopf.fr/beta/telechargement/capabilities?polygon=...&updatedFrom=...&updatedTo=...&editionDateFrom=...&editionDateTo=...&lang=...&crs=...&thematic=...&zone=...&format=...
Les champs du filtre, tous optionnels, doivent respecter le formalisme suivant :
- polygon : x1,y1;x2,y2;… (en projection EPSG:4326)
- updatedFrom : YYYY-MM-DD
- updatedTo : YYYY-MM-DD
- editionDateFrom : YYYY-MM-DD
- editionDateTo : YYYY-MM-DD
- lang : FR ou EN
- crs : au format epsg
- thematic : au format de la thématique INSPIRE recherchée
- zone : FRA (pour France entière) ou D075 (pour Paris)...
- format : SHP (pour Shapefile)...
Exemple de requête filtrée :
https://data.geopf.fr/beta/telechargement/capabilities?polygon=2.22,48.82;2.22,48.90;2.47,48.90;2.47,48.82;2.22,48.82&updatedFrom=2020-01-06&updatedTo=2023-03-28&editionDateFrom=2020-01-06&editionDateTo=2023-03-28&lang=FR&crs=EPSG:4326&thematic=I_AdministrativeUnits&zone=FRA&format=SHP
Titre
Lister les fichiers (GetResource)
La méthode GetResource permet de lister les fichiers téléchargeables de la ressource interrogée.
Elle est accessible via l'URL suivante :
https://data.geopf.fr/beta/telechargement/resource/{resourceName}
Exemple de requête :
https://data.geopf.fr/beta/telechargement/resource/IGNF_ADMIN_EXPRESS_COG
Afin de permettre une recherche plus précise, elle dispose des filtres optionnels suivants :
https://data.geopf.fr/beta/telechargement/resource/{resourceName}?polygon=...&editionDateFrom=...&editionDateTo=...&lang=...&crs=...&zone=...&format=...
Les champs du filtre, tous optionnels, doivent respecter le formalisme suivant :
- polygon : x1,y1;x2,y2;… (en projection EPSG:4326)
- editionDateFrom : YYYY-MM-DD
- editionDateTo : YYYY-MM-DD
- lang : FR ou EN
- crs : au format epsg
- zone : FRA (pour France entière) ou D075 (pour Paris)...
- format : SHP (pour Shapefile)...
Exemple de requête filtrée :
https://data.geopf.fr/beta/telechargement/resource/IGNF_ADMIN_EXPRESS_COG?polygon=2.22,48.82;2.22,48.90;2.47,48.90;2.47,48.82;2.22,48.82&editionDateFrom=2020-01-06&editionDateTo=2023-03-28&lang=FR&crs=EPSG:4326&zone=FRA&format=SHP
Titre
Télécharger un fichier (Download)
La méthode Download permet de télécharger un fichier.
Elle est accessible via l'URL suivante :
https://data.geopf.fr/beta/telechargement/download/{resourceName}/{fileName}
Exemple de requête :
https://data.geopf.fr/beta/telechargement/download/IGNF_ADMIN_EXPRESS_COG/ADMINEXPRESS-COG_SHP_WGS84G_PACK_2022-04-15$ADMIN-EXPRESS-COG_3-1__SHP__FRA_WM_2022-04-15/file/ADMIN-EXPRESS-COG_3-1__SHP__FRA_WM_2022-04-15.7z