O TRACES aceita a geolocalização das parcelas como GeoJSON, mas não qualquer GeoJSON: a Comissão publica um perfil específico, e os ficheiros que dele se desviam são rejeitados ou, pior, aceites com dados silenciosamente estropiados. Este guia é a referência de trabalho desse perfil: estrutura, regras de geometria, as quatro propriedades que o sistema lê, e os erros que a própria documentação oficial lista como os mais comuns.
A forma básica
Uma FeatureCollection que contém uma Feature por parcela, cada uma com uma geometry e properties, segundo a especificação GeoJSON padrão (RFC 7946). As coordenadas são graus decimais WGS84 (EPSG:4326) na ordem [longitude, latitude]. Nenhum outro sistema de coordenadas é aceite; os ficheiros em projeções nacionais têm de ser reprojetados, não reetiquetados.
{
"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] }
}
]
}Tipos de geometria: o que entra, o que fica de fora
- Aceites:
Point,MultiPoint,Polygon,MultiPolygon. - Rejeitados:
LineStringeMultiLineString: um trajeto de GPS não é uma parcela enquanto não o fechar num polígono. - Polígonos: pelo menos quatro posições, anel fechado (a primeira posição igual à última), sem auto-interseções, e sem buracos: os anéis interiores não são processados, pelo que uma parcela com uma zona de exclusão tem de ser dividida em duas formas sem buracos.
- Pontos: as coordenadas têm de ser um único par plano. Um par aninhado (
[[lon, lat]]) carrega sem erro e depois não representa coordenada nenhuma, uma das falhas silenciosas documentadas do perfil.
Seis casas decimais, impostas por truncatura
O regulamento exige pelo menos seis casas decimais (cerca de 11 cm), e o sistema normaliza cada coordenada para exatamente seis: os dígitos a menos são preenchidos, os a mais são cortados. A armadilha esconde-se na truncatura: dois vértices que diferem apenas na sétima casa decimal colapsam em duplicados após o arredondamento, o que torna o anel inválido. Pré-arredonde as suas coordenadas a seis casas decimais e elimine os vértices consecutivos duplicados antes do carregamento, para validar o ficheiro que o TRACES vai efetivamente ver. O enquadramento legal está no guia dos requisitos de geolocalização.
As quatro propriedades que importam
| Propriedade | Tipo | Comportamento |
|---|---|---|
ProducerName | cadeia | Nome do produtor, facultativo. |
ProducerCountry | cadeia | Código ISO 3166-1 alfa-2 ("BR", "CI"). Códigos inválidos são um erro de ficheiro. |
ProductionPlace | cadeia | Nome do local, facultativo; recomendado. |
Area | número | Hectares, lido apenas em geometrias Point. Omitido: assume por defeito 4 ha. Passado como cadeia ("2.5" entre aspas): interpretado como zero, em silêncio. |
Os nomes das propriedades distinguem maiúsculas de minúsculas: producercountry não é ProducerCountry e é ignorado. Tudo o que estiver fora desta lista também é ignorado, inofensivamente, o que é genuinamente útil: mantenha os seus próprios identificadores de parcela e datas de produção como propriedades adicionais, e um único ficheiro serve o TRACES, o rastreio por satélite e o seu rasto de prova ao mesmo tempo. Para os polígonos, a área é calculada a partir da própria geometria; um valor de Area num polígono é ignorado.
Limites de tamanho e como caber dentro deles
A carga total de geolocalização por DDS está limitada a 25 MB, o que parece enorme até uma remessa de borracha trazer cinquenta mil parcelas. A orientação oficial para o excesso, por ordem: retire os vértices redundantes (dois pontos definem uma linha de vedação reta, não um a cada cinco metros), declare as parcelas com menos de 4 hectares como pontos em vez de polígonos, e, se ainda assim exceder, divida a remessa por várias declarações e remeta para elas a partir de uma final. A serialização compacta (sem formatação legível) ganha mais uma margem; os espaços em branco contam.
A lista de erros, condensada
- Polígonos auto-intersetados ou em forma de oito: não processados.
- Anéis não fechados, "polígonos" colineares de área zero, vértices consecutivos duplicados: erros de ficheiro.
- Ordem de coordenadas trocada: rejeitada apenas quando fora do intervalo; caso contrário, a sua exploração vai discretamente parar ao hemisfério errado. O sistema não confere as coordenadas face a
ProducerCountry; faça você próprio essa verificação. Areaem formato de cadeia, coordenadas Point aninhadas: aceites e depois silenciosamente erradas, a pior categoria.- Caixa errada nas propriedades, códigos de país inválidos, ficheiros acima de 25 MB: erros no carregamento.
Cada um destes é verificável por máquina antes da submissão, que é exatamente o que o validador da plotvera faz no carregamento: analisa, normaliza, repara o que é reparável em segurança e reporta o que não é. De onde vem a própria geometria é abordado no guia dos polígonos e no manual de recolha junto de pequenos produtores; o que acontece depois de o ficheiro estar limpo é o percurso de apresentação no TRACES.
