Livraison des données archives
Dernière modification le
Livrer les données #
La livraison est une entité qui permet de déposer un ensemble de fichiers de données au sein de l'entrepôt. Une livraison et son contenu seront toujours utilisés comme un tout.
La livraison n'a qu'un rôle temporaire, le temps que les données soient transformées et stockées dans leur format pérenne sur la plateforme. Les fichiers déposés ne sont pas ceux utilisés par les services de diffusion.
Déclarer la livraison #
https://data.geopf.fr/api/datastores/{datastore}/uploads{
"description": "Données mondiales : pays et éco-régions",
"name": "Données mondiales",
"type": "VECTOR",
"srs": "EPSG:4326"
}{
"name": "Données mondiales",
"description": "Données mondiales : pays et éco-régions",
"type": "VECTOR",
"status": "OPEN",
"srs": "EPSG:4326",
"contact": "contact@ign.fr",
"size": 0,
"last_event": {
"title": "Création",
"date": "2023-05-10T14:42:29.004734134",
"initiator": {
"last_name": "Lopper",
"first_name": "Dave",
"_id": "{user}"
}
},
"_id": "{upload}"
}Téléverser un fichier #
Les formats de fichier vecteur gérés sont :
- Geopackage
- GeoJSON
- Shapefile
- CSV :
- si la géométrie est dans un colonne, cette dernière doit avoir comme nom
json,geom,the_geom,wkbouwkt - si la donnée est ponctuelle et que les coordonnées sont dans deux colonnes, elles doivent avoir comme nom :
lon,x,longitudelat,y,latitude
- si la géométrie est dans un colonne, cette dernière doit avoir comme nom
- SQL. Les instructions autorisées sont les suivantes, sans préciser de nom de schéma :
- CREATE TABLE
- CREATE VIEW
- CREATE INDEX
- CREATE SEQUENCE
- ALTER TABLE
- ALTER SEQUENCE
📄 <monde.gpkg>
https://data.geopf.fr/api/datastores/{datastore}/uploads/{upload}/data?path=data/monde.gpkg| Corps de requête Multipart |
|---|
| file = `<monde.gpkg>` |
Contrôler le contenu #
Afin de vérifier que tous les fichiers ont bien été déposés et leur éventuelle arborescence :
https://data.geopf.fr/api/datastores/{datastore}/uploads/{upload}/tree[
{
"type": "DIRECTORY",
"name": "data",
"size": 11153408,
"children": [
{
"type": "FILE",
"name": "monde.gpkg",
"size": 11153408
}
]
}
]Terminer la livraison #
Terminer la livraison va consister à retirer les droits en écriture sur les données déposées afin qu'elles puissent être traitées sans conflit. Des vérifications vont s'exécuter, lire les données livrées et détecter d'éventuels problèmes qui auraient mis en échec les traitements à suivre.
Fermeture #
https://data.geopf.fr/api/datastores/{datastore}/uploads/{upload}/closeConsultation des vérifications sur ma livraison #
Plusieurs vérifications peuvent tourner sur une même livraison, celles ci ne faisant que lire les données déposées.
https://data.geopf.fr/api/datastores/{datastore}/uploads/{upload}/checks{
"asked": [
{
"check": {
"name": "Vérification vecteur",
"_id": "66ed8a1b-93d9-4fe9-a413-ab93d31b2964"
},
"_id": "{execution}"
},
{
"check": {
"name": "Vérification standard",
"_id": "ecb00ba0-eb42-427e-8418-f5d8a30e84ec"
},
"_id": "{execution}"
}
],
"in_progress": [],
"passed": [],
"failed": []
}Lorsque toutes les vérifications seront passées, la livraison passera en statut CLOSED et la réponse à l'appel précédent sera :
https://data.geopf.fr/api/datastores/{datastore}/uploads/{upload}/checks{
"asked": [],
"in_progress": [],
"passed": [
{
"check": {
"name": "Vérification vecteur",
"_id": "66ed8a1b-93d9-4fe9-a413-ab93d31b2964"
},
"_id": "{execution}"
},
{
"check": {
"name": "Vérification standard",
"_id": "ecb00ba0-eb42-427e-8418-f5d8a30e84ec"
},
"_id": "{execution}"
}
],
"failed": []
}