Il formato GeoJSON dell’EUDR, spiegato

TRACES accetta la geolocalizzazione degli appezzamenti come GeoJSON, ma non un GeoJSON qualsiasi: la Commissione pubblica un profilo specifico, e i file che se ne discostano vengono respinti o, peggio, accettati con dati silenziosamente alterati. Questa guida è il riferimento pratico per quel profilo: struttura, regole di geometria, le quattro proprietà che il sistema legge e gli errori che la stessa documentazione ufficiale elenca come i più comuni.

La struttura di base

Una FeatureCollection che contiene un Feature per appezzamento, ciascuno con una geometry e properties, secondo la specifica GeoJSON standard (RFC 7946). Le coordinate sono in gradi decimali WGS84 (EPSG:4326) nell'ordine [longitude, latitude]. Nessun altro sistema di coordinate è accettato; i file in proiezioni nazionali devono essere riproiettati, non rietichettati.

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "ProducerName": "Kouassi Cooperative",
        "ProducerCountry": "CI",
        "ProductionPlace": "Plot Adzope A-12",
        "Area": 2.5
      },
      "geometry": { "type": "Point", "coordinates": [-3.863245, 6.107891] }
    }
  ]
}

Tipi di geometria: cosa è ammesso e cosa no

• Accettati: Point, MultiPoint, Polygon, MultiPolygon.
• Respinti: LineString e MultiLineString: una traccia GPS non è un appezzamento finché non la si chiude in un poligono.
• Poligoni: almeno quattro posizioni, anello chiuso (la prima posizione uguale all'ultima), nessuna auto-intersezione, e nessun buco: gli anelli interni non vengono elaborati, quindi un appezzamento con una zona di esclusione deve essere suddiviso in due forme prive di buchi.
• Punti: le coordinate devono essere una singola coppia piatta. Una coppia annidata ([[lon, lat]]) viene caricata senza errori e poi non rappresenta alcuna coordinata, uno dei silenziosi fallimenti documentati del profilo.

Sei cifre decimali, imposte per troncamento

Il regolamento richiede almeno sei cifre decimali (circa 11 cm), e il sistema normalizza ogni coordinata a esattamente sei: le cifre in meno vengono completate, quelle in più vengono tagliate. La trappola si nasconde nel troncamento: due vertici che differiscono solo nella settima cifra decimale collassano in duplicati dopo l'arrotondamento, il che rende l'anello non valido. Arrotondi preventivamente le sue coordinate a sei cifre decimali ed elimini i vertici consecutivi duplicati prima del caricamento, così da validare il file che TRACES vedrà effettivamente. Il contesto giuridico si trova nella guida ai requisiti di geolocalizzazione.

Le quattro proprietà che contano

I nomi delle proprietà distinguono maiuscole e minuscole: producercountry non è ProducerCountry e viene ignorato. Anche tutto ciò che è al di fuori di questo elenco viene ignorato, in modo innocuo, il che è davvero utile: mantenga i propri identificativi di appezzamento e le date di produzione come proprietà aggiuntive, e un unico file serve al contempo TRACES, lo screening satellitare e la sua traccia probatoria. Per i poligoni l'area è calcolata dalla geometria stessa; un valore Area su un poligono viene ignorato.

Limiti di dimensione e come rientrarvi

Il carico utile di geolocalizzazione totale per ciascuna DDS è limitato a 25 MB, il che sembra enorme finché una spedizione di gomma non porta cinquantamila appezzamenti. La guida ufficiale in caso di superamento, in ordine: rimuova i vertici ridondanti (due punti definiscono una linea di recinzione retta, non uno ogni cinque metri), dichiari gli appezzamenti sotto i 4 ettari come punti anziché come poligoni, e se ancora eccessivo, suddivida la spedizione su più dichiarazioni e le referenzi da una finale. Una serializzazione compatta (senza formattazione leggibile) procura un ulteriore margine; gli spazi bianchi contano.

L'elenco degli errori, condensato

• Poligoni auto-intersecanti o a forma di otto: non elaborati.
• Anelli non chiusi, "poligoni" collineari di area nulla, vertici consecutivi duplicati: errori di file.
• Ordine delle coordinate invertito: respinto solo quando fuori intervallo; altrimenti la sua azienda finisce silenziosamente nell'emisfero sbagliato. Il sistema non verifica le coordinate rispetto a ProducerCountry; esegua lei stesso quel controllo.
• Campo Area di tipo stringa, coordinate Point annidate: accettati e poi silenziosamente errati, la classe peggiore.
• Maiuscole/minuscole errate nelle proprietà, codici paese non validi, file oltre i 25 MB: errori al caricamento.

Ognuno di questi è verificabile automaticamente prima della presentazione, ed è esattamente ciò che fa il validatore di plotvera al momento del caricamento: analizza, normalizza, ripara ciò che è riparabile in sicurezza e segnala ciò che non lo è. Da dove proviene la geometria stessa è trattato nella guida ai poligoni e nel manuale di raccolta per i piccoli agricoltori; ciò che accade dopo che il file è pulito è la procedura di presentazione in TRACES.