Files
geointel/docs/18-ultra-prep/GEOMETRY_CONTRACTS.md
T
Jens faeb58ef6d
GeoIntel release gates / Compile, test, contracts and builds (push) Successful in 1m49s
GeoIntel release gates / Python and npm vulnerability policy (push) Successful in 21s
GeoIntel release gates / Production AI image, SBOM and container scan (push) Successful in 5m39s
GeoIntel release gates / Deploy exact gated revision to Unraid (push) Failing after 58m43s
Initial public release
2026-08-31 21:56:53 +02:00

943 B

Geometry Contracts

Internal Geometry Standard

  • Database geometries are stored in PostGIS.
  • Default storage CRS: EPSG:31370 for Belgian projected operations where appropriate, or EPSG:4326 for API interchange.
  • API GeoJSON is always EPSG:4326 unless explicitly stated.
  • Area calculations must use projected CRS, not raw WGS84 degrees.

Accepted Area Input

  • GeoJSON Polygon
  • GeoJSON MultiPolygon
  • drawn polygon from frontend
  • future: municipality selection

Validation Rules

  • polygon must be closed;
  • polygon must be valid;
  • polygon must have non-zero area;
  • self-intersections must be rejected or repaired explicitly;
  • extremely large areas must require confirmation or be rejected by configured max area.

Output Rules

  • include crs metadata if transformed;
  • include computed area in square meters;
  • include bounds;
  • include geometry validity status.

Common Trap

Never compute area or distance in degrees.