GeoJSON, które przechodzi: błędy geometrii, które odbijają oświadczenie

Są dwa zupełnie różne powody, dla których oświadczenie o należytej staranności może nie przejść. Jeden: coś z gruntem lub łańcuchem dostaw się nie zgadza. Drugi: plik był zniekształcony. Drugi jest znacznie częstszy, całkowicie zapobiegalny i zwykle wychodzi w najgorszym momencie — gdy przesyłka już jedzie.

Warto rozdzielić dwa źródła obowiązku, zanim pójdziemy dalej. Samo rozporządzenie żąda geolokalizacji z wystarczającą liczbą punktów, by opisać obwód, i niewiele więcej. Konkretne ograniczenia techniczne poniżej pochodzą z unijnego Systemu Informacyjnego, który waliduje geometrię przed przyjęciem. Pierwsze to prawo; drugie to system, który odrzuci Was we wtorek po południu. Oba mają znaczenie, a ich mieszanie utrudnia rozpoznanie, co jest negocjowalne.

Format, krótko

Geometrię podaje się jako GeoJSON, w geograficznym układzie współrzędnych WGS-84 — EPSG:4326 — jako stopnie dziesiętne. To ten sam układ odniesienia, który produkuje GPS w telefonie, co jest wygodne, i to też źródło pojedynczo najgroźniejszego błędu w całym ćwiczeniu.

{
  "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]
    ]]
  }
}

Pierścień, który się nie zamyka

To zdecydowanie najczęstsze odrzucenie. Pierścień poligonu musi być zamknięty: jego ostatnia współrzędna musi być identyczna z pierwszą, cyfra po cyfrze. Nie w obrębie metra. Nie wizualnie zbieżna. Identyczna.

Dzieje się tak przez sposób obchodzenia granic. Ktoś obchodzi działkę pieszo, wraca w pobliże startu i zatrzymuje się. Wynik pięknie rysuje się na mapie — szczelina ma centymetry i jest niewidoczna przy rozsądnym zbliżeniu — i natychmiast nie przechodzi sprawdzenia topologii, bo otwarty pierścień nie opisuje zamkniętego obszaru.

Poprawka jest trywialna, gdy wiecie: dopiszcie pierwszą współrzędną jeszcze raz jako ostatnią. Trudność to odkrycie, że trzeba poprawić, trzy miesiące po tym, jak osoba, która obchodziła granicę, odeszła.

Samoprzecięcie

Obrys, który przecina sam siebie — ósemka albo obchodzenie, które zawróciło — nie ma dobrze zdefiniowanego wnętrza. Nie da się policzyć powierzchni, więc nie da się przetestować progu czterech hektarów ani przeciąć z warstwą utraty lasu, by odpowiedzieć na pytanie, dla którego całe ćwiczenie istnieje.

Zwykle pochodzą z śledzenia GPS, a nie z celowego mapowania: urządzenie nagrywa ciągle, gdy ktoś przecina własną ścieżkę wokół przeszkody. Uproszczenie śladu przed zapisem usuwa większość z nich.

Precyzja utracona w transporcie

Sześć cyfr po przecinku to deklarowane minimum. Cztery miejsca to mniej więcej jedenaście metrów w terenie, dość, by punkt graniczny wpadł w sąsiednią parcelę.

Zespoły terenowe rzadko to powodują. Arkusze tak. Kolumna sformatowana do dwóch miejsc pokazuje wartości zaokrąglone i — zależnie od ścieżki eksportu — może zapisać zaokrąglone wartości. Współrzędne zebrane dokładnie na działce przychodzą obcięte na drugim końcu i nic w procesie tego nie ogłasza.

Inne powtarzające się usterki

• Otwory wewnętrzne, by wyłączyć dom lub ciek z działki. Podział parcele jest czystszą odpowiedzią.
• Układ współrzędnych odwzorowany — metry zamiast stopni — wyeksportowany bez reprojekcji. Wartości w setkach tysięcy są znakiem rozpoznawczym.
• Multipoligony używane do spięcia niezwiązanych działek w jeden obiekt, co niszczy relację per działka, od której zależy oświadczenie.
• Powielone kolejne wierzchołki, nieszkodliwe z wyglądu i porażka w niektórych walidatorach.
• Współrzędne dokładnie w zerze, wskazujące Zatokę Gwinejską i zwykle oznaczające brakującą wartość zapisaną jako liczba.

Dwa z nich zasługują na uwagę. Multipoligony kuszą, gdy rolnik uprawia trzy rozproszone pola, bo spięcie ich w jeden obiekt utrzymuje plik w porządku. Niszczy też relację per działka, od której zależy oświadczenie, i sprawia, że test czterech hektarów traci sens — trzy osobne dwuhektarowe parcele to nie jedna sześciohektarowa. Trzymajcie je jako osobne działki.

Współrzędne dokładnie w zerze warte są osobnego sprawdzenia, bo wyglądają jak dane, a nie jak nieobecność. Brakująca wartość zapisana jako liczba zero daje punkt w Zatoce Gwinejskiej — dlatego ten odcinek oceanu jest niezwykle obficie zaopatrzony w farmy kakaowe w słabo walidowanych zbiorach.

Poprawne strukturalnie to nie to samo co prawdziwe

Wszystko powyżej jest strukturalne, a sprawdzenia strukturalne da się tanio zautomatyzować. Warto trzeźwo wiedzieć, czego nie mówią.

Zamknięty, niesamoprzecinający się poligon z ośmioma miejscami po przecinku, narysowany wokół działki, z której towar nigdy nie pochodził, przechodzi każdą z tych bramek. Podobnie poligon narysowany hojnie wokół całej wsi, by zaoszczędzić czas, albo skopiowany z sąsiedniego gospodarstwa, bo dostawca nie miał własnego.

To są porażki, które mają znaczenie, bo przeżywają walidację i trafiają do pliku, który musielibyście bronić. Porównanie geometrii ze zobrazowaniem — czy ten kształt odpowiada polu, czy pokrycie gruntu pasuje do deklarowanego towaru, czy nachodzi na trzy działki innych dostawców — to inne ćwiczenie niż walidacja pliku i to ono decyduje, czy Wasze dowody są cokolwiek warte.

Walidujcie tam, gdzie jest jeszcze tanio

1. 1

   Przy zbieraniu

   Pierścień, który się nie zamyka, to trzydziestosekundowa poprawka, gdy ktoś stoi w polu, i bliski niemożliwości do naprawy w listopadzie z innego kontynentu.

2. 2

   Przy ingestii

   Odrzucajcie zniekształconą geometrię na granicy systemu, zamiast ją przechowywać. Złe dane, które wejdą, zwykle zostaną użyte.

3. 3

   Wobec zobrazowania, przed zgłoszeniem

   Sprawdzenie, którego żaden walidator formatu nie wykonuje, i jedyne, które mówi, czy działka jest prawdziwa.

4. 4

   Jako stały raport, nie jednorazówka

   Baza dostawców zmienia się co sezon. Plik, który walidował się rok temu, opisuje łańcuch, którego możecie już nie mieć.

Nic z tego nie jest intelektualnie trudne. To ćwiczenie jakości danych w skali, której większość łańcuchów nigdy nie podejmowała, a organizacje, które grudzień uznają za zarządzalny, to te, które odepchnęły te sprawdzenia aż do punktu zbierania.

Opublikowano 6 sierpnia 2026 · Zaktualizowano 12 sierpnia 2026 · Ostatni przegląd 12 sierpnia 2026 wobec źródeł wymienionych powyżej.