GeoJSON que passa: os erros de geometria que devolvem uma declaração

Há duas razões bastante diferentes para uma declaração de diligência devida falhar. Uma é que algo sobre a terra ou a cadeia de abastecimento não se sustenta. A outra é que um ficheiro estava malformado. A segunda é muito mais comum, inteiramente evitável, e tende a surgir no pior momento possível — quando uma consignação já se está a mover.

Convém separar duas fontes de obrigação antes de ir mais longe. O próprio regulamento pede geolocalização com pontos suficientes para descrever o perímetro e diz pouco mais. As restrições técnicas concretas abaixo vêm do sistema de informação da UE, que valida a geometria antes de a aceitar. A primeira é lei; a segunda é um sistema que o rejeitará numa terça-feira à tarde. Ambas importam, e confundi-las torna difícil saber o que é negociável.

O formato, em breve

A geometria é fornecida como GeoJSON, no sistema de coordenadas geográficas WGS-84 — EPSG:4326 — em graus decimais. É o mesmo sistema de referência que um GPS de telemóvel produz, o que é conveniente, e é também a fonte do único erro mais perigoso de todo o exercício.

{
  "type": "Feature",
  "properties": { "ProducerCountry": "CI", "ProductionPlace": "Plot 14" },
  "geometry": {
    "type": "Polygon",
    "coordinates": [[
      [-5.482913, 6.827145],
      [-5.480227, 6.827902],
      [-5.479815, 6.825338],
      [-5.482604, 6.824671],
      [-5.482913, 6.827145]
    ]]
  }
}

O anel que não fecha

Esta é a rejeição mais comum com larga margem. Um anel de polígono tem de estar fechado: a sua coordenada final tem de ser idêntica à primeira, dígito a dígito. Não a um metro. Não visualmente coincidente. Idêntica.

Acontece pela forma como se percorrem os limites. Alguém traça uma parcela a pé, chega de volta perto de onde começou, e para. O resultado desenha-se lindamente num mapa — o fosso é de centímetros e invisível a qualquer zoom sensato — e falha uma verificação topológica de imediato, porque um anel aberto não descreve uma área encerrada.

A correção é trivial quando se sabe: acrescente a primeira coordenada outra vez como última. A dificuldade é descobrir que precisa de correção, três meses depois de a pessoa que percorreu o limite ter seguido em frente.

Autointerseção

Um contorno que se cruza a si próprio — um oito, ou um percurso de limite que voltou sobre si — não tem interior bem definido. A sua área não pode ser calculada, portanto não pode ser testada contra o limiar de quatro hectares, e não pode ser intersectada com uma camada de perda florestal para responder à pergunta para a qual todo o exercício existe.

Estes vêm normalmente de rastreio GPS mais do que de mapeamento deliberado: um dispositivo a gravar continuamente enquanto alguém cruza o próprio caminho em torno de um obstáculo. Simplificar o rasto antes de o gravar remove a maior parte deles.

Precisão perdida em trânsito

Seis dígitos decimais é o mínimo declarado. Quatro casas decimais são cerca de onze metros no terreno, o que chega para pôr um ponto de limite dentro de uma parcela vizinha.

As equipas de campo raramente causam isto. As folhas de cálculo sim. Uma coluna formatada a duas casas decimais apresenta valores arredondados e — consoante o caminho de exportação — pode escrever os valores arredondados para fora. Coordenadas capturadas com precisão na parcela chegam truncadas no outro extremo, e nada no processo anuncia que aconteceu.

Outras falhas recorrentes

• Buracos interiores, usados para excluir uma casa ou um curso de água de uma parcela. Dividir a parcela é a resposta mais limpa.
• Um sistema de coordenadas projetado — metros em vez de graus — exportado sem reprojeção. Valores nas centenas de milhares são o sinal.
• Multipolígonos usados para agrupar parcelas não relacionadas numa só feição, o que destrói a relação por parcela de que a declaração depende.
• Vértices consecutivos duplicados, inofensivos na aparência e uma falha em alguns validadores.
• Coordenadas exatamente a zero, que apontam para o Golfo da Guiné e normalmente significam um valor em falta escrito como um número.

Dois desses merecem uma nota. Os multipolígonos são tentadores quando um agricultor trabalha três campos dispersos, porque agrupá-los numa só feição mantém o ficheiro arrumado. Também destrói a relação por parcela de que a declaração depende, e torna o teste das quatro hectares sem sentido — três parcelas separadas de dois hectares não são uma parcela de seis hectares. Mantenha-as como parcelas distintas.

As coordenadas exatamente a zero valem uma verificação específica, porque parecem dados mais do que ausência. Um valor em falta escrito como o número zero produz um ponto no Golfo da Guiné, que é por isso que aquele troço concreto de oceano está invulgarmente bem abastecido de explorações de cacau em conjuntos de dados mal validados.

Válido não é o mesmo que correto

Tudo o que está acima é estrutural, e as verificações estruturais são baratas de automatizar. Convém ser lúcido sobre o que não lhe dizem.

Um polígono fechado, sem autointerseção, com oito casas decimais de precisão, desenhado em torno de uma parcela de onde a matéria-prima nunca veio, passa todos estes portões. Também um polígono desenhado generosamente em torno de uma aldeia inteira para poupar tempo, ou um copiado de uma exploração vizinha porque o fornecedor não tinha a sua.

Essas são as falhas que importam, porque são as que sobrevivem à validação e chegam ao dossiê que teria de defender. Verificar a geometria contra imagens — esta forma corresponde a um campo, a sua cobertura do solo coincide com a matéria-prima reivindicada, sobrepõe-se a parcelas de três outros fornecedores — é um exercício diferente de validar um ficheiro, e é o que determina se as suas provas valem alguma coisa.

Valide onde ainda é barato

1. 1

   Na captura

   Um anel que não fecha é uma correção de trinta segundos enquanto alguém está de pé no campo, e perto de impossível de corrigir em novembro a partir de outro continente.

2. 2

   Na ingestão

   Rejeite geometria malformada no limite do seu sistema em vez de a armazenar. Dados maus que entram tendem a ser usados.

3. 3

   Contra imagens, antes da apresentação

   A verificação que nenhum validador de formato faz, e a única que fala sobre se a parcela é real.

4. 4

   Como um relatório permanente, não um exercício único

   As bases de fornecedores mudam todas as estações. Um ficheiro que validou no ano passado descreve uma cadeia de abastecimento que pode já não ter.

Nada disto é intelectualmente difícil. É um exercício de qualidade de dados à escala que a maior parte das cadeias de abastecimento nunca tentou, e as organizações que acharem dezembro gerível serão as que empurraram estas verificações até ao ponto de recolha.

Publicado 6 de agosto de 2026 · Atualizado 12 de agosto de 2026 · Última revisão 12 de agosto de 2026 face às fontes listadas acima.