Parcels
Search for cadastral parcel boundaries and manage results.
▶Endpoints
| Method | Path | Description |
|---|---|---|
| POST | /cadastral/parcels/search | Submit a parcel search (JSON or file upload) |
| GET | /cadastral/parcels/results/:id | Retrieve paginated results with filtering |
| POST | /cadastral/parcels/results/:id/ingest | Ingest results into your supply chain |
▶Search workflow
- Submit point coordinates — each point is routed to the appropriate national cadastral service
- The system checks the spatial cache for existing parcel matches
- Uncached points are looked up via external APIs (counted against your rate limit)
- Results are stored and available for review, filtering, and ingestion
▶Geometry support
The search accepts any GeoJSON geometry type:
| Geometry | Handling |
|---|---|
| Point | Used directly as the lookup coordinate |
| MultiPoint | Split into individual points, each looked up separately |
| Polygon, LineString, etc. | Centroid computed and used as the lookup coordinate |
▶Ingestion
After reviewing search results, you can ingest successful parcels into your supply chain as plots or sheds. This feeds the parcel polygons through the standard ingestion pipeline (normalisation, validation, optional deforestation/emissions metrics).