Vos données Truleaf Fields — formats et changement
Exportez toutes vos données à tout moment, gratuitement, dans des formats ouverts.
Version du registre 1.0.0 · en vigueur depuis le 31 oct. 2026
Qui peut exporter
Les propriétaires et administrateurs d’un espace de travail peuvent tout exporter. Les éditeurs exportent enregistrements, parcelles et séries de données.
Les exports sont gratuits avec chaque formule, y compris la formule gratuite, et après la fin d’une formule.
Pour télécharger vos propres données personnelles, ouvrez les paramètres de votre compte.
Comment exporter
- Export complet : ouvrez votre espace de travail, allez dans Exports et choisissez Tout exporter. Nous vous envoyons un e-mail quand les fichiers sont prêts. Ils restent disponibles 30 jours et vous pouvez les générer à nouveau à tout moment.
- Enregistrements, parcelles et séries de données : utilisez Exporter sur l’écran qui les affiche, ou ouvrez Exports et choisissez Nouvel export.
L’export complet
Un seul fichier zip, ou plusieurs parties de 200 Mo maximum, avec les photos dans des parties à part. Le manifeste liste chaque fichier avec ses lignes, sa taille, sa somme de contrôle et son schéma.
Le README est dans la langue choisie et en anglais.
Les mêmes données donnent les mêmes fichiers, vous pouvez donc comparer les sommes de contrôle entre deux exports.
L’export complet contient des données personnelles (noms, e-mails, numéros fiscaux et d’immatriculation, historique des conversations). Conservez-le en lieu sûr.
Guide
| Dossier | Fichier | Contenu | Format | Schéma |
|---|---|---|---|---|
| Racine | README.md | Ce que contient l’export, dans votre langue et en anglais | Markdown (texte) | |
| Racine | manifest.json | Chaque fichier avec ses lignes, sa taille, sa somme de contrôle et son schéma | JSON (données) | schéma |
| Racine | schemas/<name>.schema.json | Le schéma JSON de chaque fichier de l’export | Schéma JSON | |
| Racine | schemas/siex-mapping.json | Correspondance des colonnes avec la mise en page Anexo V du SIEX | JSON (données) | schéma |
Espace de travailorg/
| Dossier | Fichier | Contenu | Format | Schéma |
|---|---|---|---|---|
| org/ | org.json | Nom, type, formule et fermes de l’espace de travail | JSON (données) | schéma |
| org/ | members.csv | Membres et leurs rôles | CSV (tableur) | schéma |
| org/ | invitations.csv | Invitations ouvertes et passées | CSV (tableur) | schéma |
| org/ | advisor_links.csv | Liens avec les conseillers et leurs clients | CSV (tableur) | schéma |
| org/ | consents.csv | Consentements donnés dans l’espace de travail | CSV (tableur) | schéma |
| org/ | settings.json | Paramètres de l’espace de travail | JSON (données) | schéma |
Fermes et parcellesgeo/
| Dossier | Fichier | Contenu | Format | Schéma |
|---|---|---|---|---|
| geo/ | farms.geojson | Contours et détails des fermes | GeoJSON (SIG) | schéma |
| geo/ | parcels.geojson | Contours des parcelles avec culture, surface et étiquettes | GeoJSON (SIG) | schéma |
| geo/ | parcel_exclusions.geojson | Zones exclues des parcelles | GeoJSON (SIG) | schéma |
| geo/ | parcel_sigpac_links.csv | Liens entre parcelles et îlots SIGPAC | CSV (tableur) | schéma |
| geo/ | zones.geojson | Chaque zone de modulation, issue des données satellite | GeoJSON (SIG) | schéma |
Enregistrementsrecords/
| Dossier | Fichier | Contenu | Format | Schéma |
|---|---|---|---|---|
| records/ | seasons.csv | Cycles culturaux par parcelle | CSV (tableur) | schéma |
| records/ | seasons.ndjson | Cycles culturaux par parcelle | NDJSON (lignes JSON) | schéma |
| records/ | irrigation_systems.csv | Chaque système d’irrigation | CSV (tableur) | schéma |
| records/ | irrigation_systems.ndjson | Chaque système d’irrigation | NDJSON (lignes JSON) | schéma |
| records/ | tags.csv | Étiquettes et parcelles associées | CSV (tableur) | schéma |
| records/ | tags.ndjson | Étiquettes et parcelles associées | NDJSON (lignes JSON) | schéma |
| records/ | treatments.csv | Traitements | CSV (tableur) | schéma |
| records/ | treatments.ndjson | Traitements | NDJSON (lignes JSON) | schéma |
| records/ | treatment_products.csv | Produits utilisés dans les traitements | CSV (tableur) | schéma |
| records/ | treatment_products.ndjson | Produits utilisés dans les traitements | NDJSON (lignes JSON) | schéma |
| records/ | irrigation_events.csv | Enregistrements d’irrigation | CSV (tableur) | schéma |
| records/ | irrigation_events.ndjson | Enregistrements d’irrigation | NDJSON (lignes JSON) | schéma |
| records/ | observations.csv | Observations avec notes et photos | CSV (tableur) | schéma |
| records/ | observations.ndjson | Observations avec notes et photos | NDJSON (lignes JSON) | schéma |
| records/ | tasks.csv | Tâches | CSV (tableur) | schéma |
| records/ | tasks.ndjson | Tâches | NDJSON (lignes JSON) | schéma |
| records/ | operators.csv | Applicateurs | CSV (tableur) | schéma |
| records/ | operators.ndjson | Applicateurs | NDJSON (lignes JSON) | schéma |
| records/ | equipment.csv | Matériel d’application | CSV (tableur) | schéma |
| records/ | equipment.ndjson | Matériel d’application | NDJSON (lignes JSON) | schéma |
| records/ | cuaderno_es.xlsx | Carnet de plaine dans la mise en page des colonnes Anexo V (fermes en Espagne) | Classeur Excel (XLSX) |
Satellitesatellite/
| Dossier | Fichier | Contenu | Format | Schéma |
|---|---|---|---|---|
| satellite/ | observations.csv | Images satellite utilisées, avec leur couverture nuageuse | CSV (tableur) | schéma |
| satellite/ | index_stats.csv | Statistiques d’indice par parcelle et par image | CSV (tableur) | schéma |
| satellite/ | series_daily.csv | Séries quotidiennes d’indice par parcelle | CSV (tableur) | schéma |
| satellite/ | phenology.csv | Stades de croissance estimés par cycle cultural | CSV (tableur) | |
| satellite/ | parcel_state.csv | État actuel de chaque parcelle | CSV (tableur) | schéma |
Météo et eauweather/
| Dossier | Fichier | Contenu | Format | Schéma |
|---|---|---|---|---|
| weather/ | parcel_water_daily.csv | Bilan hydrique quotidien par parcelle (ET₀, ETc, pluie) | CSV (tableur) | schéma |
| weather/ | parcel_weather_link.csv | Source météo de chaque parcelle | CSV (tableur) | schéma |
| weather/ | spray_profiles.json | Réglages de la fenêtre de traitement | JSON (données) | schéma |
| weather/ | daily.csv | Valeurs météo quotidiennes utilisées, avec leur source | CSV (tableur) | schéma |
Capteurssensors/
| Dossier | Fichier | Contenu | Format | Schéma |
|---|---|---|---|---|
| sensors/ | connections.csv | Connexions de capteurs, sans identifiants | CSV (tableur) | |
| sensors/ | devices.csv | Appareils | CSV (tableur) | |
| sensors/ | sensors.csv | Capteurs de chaque appareil | CSV (tableur) | |
| sensors/ | readings_<yyyy-mm>_<nnnn>.csv.gz | Mesures brutes par mois | CSV compressé (gzip) | |
| sensors/ | readings_hourly_<yyyy>.csv.gz | Mesures horaires par année | CSV compressé (gzip) | |
| sensors/ | readings_daily.csv | Mesures quotidiennes | CSV (tableur) |
Alertesalerts/
| Dossier | Fichier | Contenu | Format | Schéma |
|---|---|---|---|---|
| alerts/ | rules.json | Règles d’alerte | JSON (données) | schéma |
| alerts/ | alerts.csv | Alertes | CSV (tableur) | schéma |
| alerts/ | alert_transitions.csv | Changements de statut des alertes | CSV (tableur) | schéma |
| alerts/ | alert_feedback.csv | Avis sur les alertes | CSV (tableur) | schéma |
Visitesvisits/
| Dossier | Fichier | Contenu | Format | Schéma |
|---|---|---|---|---|
| visits/ | visits.csv | Visites des conseillers | CSV (tableur) | |
| visits/ | visit_reports.ndjson | Rapports de visite | NDJSON (lignes JSON) |
Assistant Kwáu AIkwau/
| Dossier | Fichier | Contenu | Format | Schéma |
|---|---|---|---|---|
| kwau/ | conversations.ndjson | Conversations de l’espace de travail avec Kwáu AI, auteurs pseudonymisés | NDJSON (lignes JSON) | schéma |
Activitéaudit/
| Dossier | Fichier | Contenu | Format | Schéma |
|---|---|---|---|---|
| audit/ | activity.csv | Journal d’activité | CSV (tableur) | schéma |
Photos et fichiersmedia/
| Dossier | Fichier | Contenu | Format | Schéma |
|---|---|---|---|---|
| media/ | index.csv | Liste des photos et fichiers | CSV (tableur) | schéma |
| media/ | <media_id>.<ext> | Photos et fichiers tels qu’envoyés | Fichier d’origine |
Exports d’une sélection
| Export | Formats | Conventions | Remarques |
|---|---|---|---|
| Cuaderno (format Anexo V) | Excel (XLSX), CSV (tableur) |
|
|
| Tous les enregistrements | CSV (tableur), Excel (XLSX) |
| |
| Contours des parcelles | GeoJSON (SIG), Shapefile (zip), KML pour Google Earth, CSV (tableur) | ||
| Zone de modulation | GeoJSON (SIG), Shapefile (zip) |
| |
| Séries d’indices satellite | CSV (tableur) | ||
| Séries météo | CSV (tableur) |
| |
| Mesures des capteurs | CSV (tableur) |
Formats et normes
| Format | Norme |
|---|---|
| GeoJSON (SIG) | GeoJSON, RFC 7946 (EPSG:4326) |
| Shapefile (zip) | ESRI Shapefile (ESRI Shapefile Technical Description, July 1998), zip with .prj WGS 84 and .cpg UTF-8 |
| KML pour Google Earth | OGC KML 2.2 (OGC 07-147r2) |
| CSV (tableur) | CSV, RFC 4180 (UTF-8) |
| NDJSON (lignes JSON) | NDJSON (newline-delimited JSON, one RFC 8259 value per line) |
| Classeur Excel (XLSX) | Office Open XML SpreadsheetML, ECMA-376 |
| Schéma JSON | JSON Schema 2020-12 |
| Archive zip | ZIP (PKWARE .ZIP File Format Specification, APPNOTE) |
- Unités du SI ; surfaces en hectares.
- Heures en UTC (ISO 8601) ; les colonnes local_date donnent la date de la ferme.
- Les identifiants sont des UUID ; ceux des utilisateurs, des chaînes de 24 caractères.
- Correspondance des colonnes avec l’Anexo V du SIEX v3.11
Prévus : GeoPackage, fiboa GeoParquet, Shapefile de préconisation et ISOXML v1.5.
Non inclus
| Quoi | Pourquoi | Inclus à la place |
|---|---|---|
| Images satellite brutes | Elles peuvent être reproduites à partir des données publiques Copernicus. | Statistiques d’indice, identifiants d’image et version de traitement. |
| Couches cartographiques rendues | Palettes de couleurs des fournisseurs ; elles peuvent être reproduites à partir des statistiques. | Statistiques et séries d’indice. |
| Données météo brutes | Conditions des fournisseurs météo. | Les valeurs quotidiennes utilisées, avec leur source. |
| Logique d’alerte et des modèles | Secrets d’affaires (règlement sur les données, art. 2, point 38). | Les réponses de Kwáu AI avec leurs citations, et chaque alerte. |
| Données hors espace de travail | Elles appartiennent à un autre espace de travail. | La liste des liens avec les conseillers (org/advisor_links.csv). |
| Identifiants d’intégration | Gardés secrets par mesure de sécurité. | Détails de connexion sans secrets. |
| Catalogues de tiers | Sous licence de tiers (EPPO, MAPA, SIEX, SIGPAC). | Les codes et libellés utilisés dans vos enregistrements. |
| Envois de chaque notification | Journaux système sur des personnes précises. | Les alertes et leurs changements de statut. |
| Historique d’état des parcelles | Non conservé. | L’état actuel de chaque parcelle (satellite/parcel_state.csv). |
| Conversations Kwáu portefeuille | Elles mêlent les données de plusieurs espaces de travail client. | Leur auteur les reçoit dans un export de données personnelles. |
| Auteurs de conversation Kwáu AI | Les conversations sont privées pour leur auteur. | Un pseudonyme par auteur (authorRef). |
Changement de fournisseur et départ
- Préavis : commencez maintenant ou à une date jusqu’à 2 mois plus tard.
- Transition : 30 jours de service complet pendant le changement. Vous pouvez la prolonger une fois.
- Récupération : au moins 30 jours après la transition, en lecture seule, pour télécharger vos données.
- Effacement : nous effaçons toutes les données de l’espace de travail et envoyons une confirmation par e-mail à chaque propriétaire.
Aucun frais de changement ni de transfert de données.
Seuls les propriétaires d’un espace de travail peuvent lancer un changement ou un départ, et ils peuvent l’annuler jusqu’à la fin de la transition.
L’accès des conseillers à l’espace de travail prend fin à la fin de la transition.
API d’export
L’API d’export est décrite dans un document OpenAPI. Créez un export, vérifiez son statut, puis demandez un lien de téléchargement valable 15 minutes.
Utilisez le jeton d’accès d’une session connectée (valable 15 minutes, renouvelé par l’application web). Les clés d’API d’espace de travail pour les scripts sont prévues pour la v1.1.
Jusqu’à 10 exports par heure et 2 exports complets par jour et par espace de travail. Ces limites protègent le service, et les exports sont gratuits.
Versions et modifications
| Version | Date | Modifications |
|---|---|---|
| 1.0.0 | 31 oct. 2026 |
|
Les ajouts sont des versions mineures. Retirer une colonne demande une version majeure et 12 mois de chevauchement.
Contact
Questions sur les exports ou le changement de fournisseur : hello@truleaf.org.