Com’è fatto il file
Il sistema d’informazione dell’EUDR (TRACES) accetta solo GeoJSON, il formato della norma RFC 7946. La forma abituale è una FeatureCollection con una Feature per appezzamento: ogni Feature contiene una geometria e, se vuoi, delle proprietà con il produttore, il paese, il nome dell’appezzamento e la superficie. Le stesse regole valgono per l’importazione a schermo e per l’API.
Geometrie valide: Point, MultiPoint, Polygon e MultiPolygon. LineString e MultiLineString non descrivono un appezzamento e TRACES le rifiuta. Per scegliere tra punto e poligono, la regola dei 4 ettari e il caso dei bovini sono nella guida geolocalizzazione: punto o poligono. Qui parliamo del file.
Puoi scaricare un file di esempio con due aziende di caffè fittizie nello Huila (Colombia): una di 1,8 ha come punto e una di circa 6,7 ha come poligono. Aprilo in geojson.io o in QGIS e usalo come modello.
Coordinate: WGS84, prima la longitudine e sei decimali
Il GeoJSON ammette un solo sistema di riferimento: WGS84 (EPSG:4326), in gradi decimali. Se il fornitore invia coordinate UTM, in gradi, minuti e secondi o in un sistema nazionale, vanno convertite prima. TRACES non lo fa al posto tuo.
Ogni posizione si scrive [longitudine, latitudine], in quest’ordine. È l’opposto di come si dicono a voce e di come le mostra Google Maps, ed è l’errore più comune: l’azienda dell’esempio, con l’ordine invertito, finisce in Antartide. Una latitudine fuori da -90 a 90 o una longitudine fuori da -180 a 180 viene rifiutata.
Il regolamento chiede almeno sei decimali (art. 2, punto 28). TRACES tronca a sei prima di salvare, quindi inviarne di più non serve e, in casi estremi, due vertici diversi diventano lo stesso e il poligono non è più valido. Sei decimali esatti è la scelta giusta. Attenzione a Excel: arrotonda senza avvisare.
Quali proprietà legge TRACES?
TRACES legge quattro proprietà facoltative in ogni Feature e ignora tutte le altre. I nomi distinguono maiuscole e minuscole: productionplace non vale come ProductionPlace.
| Proprietà | Obbligatoria? | Esempio | Che cos’è |
|---|---|---|---|
| ProducerName | No | María Ejemplo Rojas | Nome del produttore |
| ProducerCountry | Sì nel file con più produttori (tipo II) | CO | Paese di produzione, codice ISO a due lettere |
| ProductionPlace | No, ma consigliata | Finca La Esperanza | Nome dell’appezzamento o del luogo |
| Area | No; si usa per i punti | 1.8 | Superficie in ettari |
- Area è un numero: scrivi 1.8, non "1.8". Tra virgolette TRACES non lo riconosce come numero e la superficie resta a 0.
- Se un punto non ha Area, TRACES gli assegna 4 ha. Un punto con più di 4 ha dà errore, salvo per i bovini. Il minimo è 0,0001 ha.
- Un codice paese inesistente fa rifiutare il file.
- Esistono due varianti con la stessa struttura. Tipo I: un solo produttore, per l’API e per l’importazione a livello di produttore. Tipo II: più produttori raggruppati per ProducerName e ProducerCountry, per l’importazione a schermo a livello di materia prima.
Poligoni che TRACES accetta
La maggior parte dei rifiuti dipende dalla geometria. Un poligono valido rispetta tutto questo:
- È chiuso: l’ultima coppia di coordinate è uguale alla prima.
- Ha almeno quattro posizioni, contando quella di chiusura, e non sono tutte allineate.
- I lati non si incrociano (niente forme a otto) e non si ripiegano verso l’interno.
- Non ha buchi. Se l’appezzamento circonda un’enclave, per esempio un boschetto non coltivato, dividilo in due poligoni a mezzaluna.
- Nessun vertice coincide con un altro dopo il troncamento a sei decimali.
Più appezzamenti separati dello stesso produttore possono andare come poligoni singoli o in un MultiPolygon. Quello che non va bene è sostituire un poligono di oltre 4 ha con un punto per aggirare un errore.
Limiti di dimensione
La geolocalizzazione di una DDS, sommando tutti i file, non può superare 25 MB. Inoltre una materia prima ammette fino a 1.000 produttori e una DDS fino a 10.000. Sono limiti del sistema che la Commissione pubblica nelle sue regole di validazione e che può modificare.
Se li superi, la Commissione consiglia due cose: usare solo due punti per un tratto rettilineo, invece di un vertice ogni 5 o 10 metri come generano i GPS in modalità traccia, e usare un punto invece di un poligono per gli appezzamenti sotto i 4 ha. Se semplifichi in QGIS, controlla poi che la superficie sia cambiata di poco.
Come controllare e correggere il file
Prima di caricarlo, aprilo in geojson.io: in pochi secondi vedi se gli appezzamenti cadono dove devono o se qualcuno è finito in mare. È il controllo più rapido per le coordinate invertite. Per correggere, QGIS è gratuito:
- Riproietta vettore (Reproject Layer) in EPSG:4326 se l’originale è in UTM o in un altro sistema.
- Controlla validità (Check Validity) per trovare le autointersezioni e Correggi geometrie (Fix Geometries) per sistemarle. Verifica il risultato: a volte divide un poligono in due.
- All’esportazione: formato GeoJSON, SR EPSG:4326, precisione delle coordinate 6 e opzione RFC7946 attiva.
- Rinomina i campi in ProducerName, ProducerCountry, ProductionPlace e Area, con queste maiuscole, e salva Area come numero decimale.
- Un KML di Google Earth o uno shapefile si apre in QGIS e si esporta allo stesso modo. TRACES non accetta altri formati né file protetti da password.
Quando un fornitore o un importatore carica un GeoJSON in Sourevo, vengono controllati il sistema di riferimento, l’intervallo delle coordinate, la chiusura dei poligoni, la regola dei 4 ha e la validità di ogni geometria (con PostGIS) prima che l’appezzamento possa entrare in una DDS. Si leggono ProducerName, ProducerCountry, ProductionPlace e Area, e un poligono identico a uno già caricato viene saltato.
Con gli appezzamenti in ordine, il passo successivo è verificarli via satellite e presentare la DDS.
Domande frequenti
- Posso caricare un KML, uno shapefile o un foglio di calcolo con le coordinate?
- Non direttamente: TRACES accetta solo GeoJSON. Convertilo prima con QGIS o un altro strumento e controlla che sia in WGS84 con sei decimali.
- Cosa succede se un punto non ha la proprietà Area?
- TRACES gli assegna 4 ha per impostazione predefinita. Se l’appezzamento è più piccolo, indica la superficie reale. Se supera i 4 ha e non si tratta di bovini, serve un poligono.
- È un problema dare più di sei decimali?
- Non dà errore, ma è inutile: TRACES tronca a sei. Nei poligoni molto dettagliati può unire vertici e rendere non valida una geometria che era corretta.
- Un file per produttore o uno con tutti?
- Per l’API e per l’importazione a livello di produttore, un file per produttore (tipo I). A schermo puoi importare a livello di materia prima un file con più produttori (tipo II), con ProducerName e ProducerCountry in ogni Feature.
- Come dichiaro un appezzamento con un buco all’interno?
- TRACES non accetta poligoni con buchi. Dividi l’appezzamento in due poligoni che girano intorno al buco, uno per lato.