documentation

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.

La méthode GetCapabilities permet de lister les ressources du service.

Elle est accessible via l'URL suivante :

https://telechargement.geopf.fr/capabilities?

Afin de permettre une recherche plus précise, elle dispose des filtres optionnels suivants :

https://telechargement.geopf.fr/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://telechargement.geopf.fr/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

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://telechargement.geopf.fr/resource/{resourceName}

Exemple de requête :

https://telechargement.geopf.fr/resource/IGNF_ADMIN_EXPRESS_COG

Afin de permettre une recherche plus précise, elle dispose des filtres optionnels suivants :

https://telechargement.geopf.fr/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://telechargement.geopf.fr/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

La méthode Download permet de télécharger un fichier.

Elle est accessible via l'URL suivante :

https://telechargement.geopf.fr/download/{resourceName}/{fileName}

Exemple de requête :

https://telechargement.geopf.fr/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