The `Plot` object¶

Plot is a Pydantic v2 model. Constructing one triggers a lookup against the selected country's cadastre and fills in the geometry and attributes.

Construction¶

Plot(
    country,          # required: "PL"|"FR"|"ES"|"NL"|"CH"|"EE"|"CY"|"LT"|"LV"|"PT"|"SI"|"IT"|"DE"|"NO"|"DK"|"BE"
    plot_id=None,     # cadastral id / reference / designation
    address=None,     # free-form address (geocoded)
    x=None, y=None,   # lon/lat coordinates (EPSG:4326)
    srid=4326,        # output geometry CRS
)

Rules:

country is required — there is no default.
Provide one of: plot_id, address, or both x and y.
Input coordinates are always lon/lat (EPSG:4326) for every country.
srid is the output geometry CRS — 4326 by default, set it for another.

Common fields¶

Field	Type	Description
`country`	`str`	Country code, echoed back
`plot_id`	`str`	Cadastral identifier for the country
`address`	`str \\| None`	The input address, if one was given
`x`, `y`	`float \\| None`	Input coordinates
`srid`	`int`	Output geometry CRS (default 4326)
`geojson`	`dict`	Parcel geometry as GeoJSON
`datasource`	`str`	Human-readable origin of the data

Computed properties¶

Property	Type	Description
`area`	`float`	Geodesic area in m² (WGS84 ellipsoid)
`centroid`	`(float, float)`	Centroid of the geometry
`bbox`	`(float, float, float, float)`	Bounding box `(minx, miny, maxx, maxy)`

Country attributes¶

The remaining attributes depend on country and come from the matching class in plot_finder.countries:

Country	Attributes
`Poland`	`voivodeship`, `county`, `commune`, `region`, `parcel`
`France`	`department`, `insee`, `commune`, `section`, `numero`
`Spain`	`province`, `municipality`
`Netherlands`	`municipality`, `section`, `parcel_number`
`Switzerland`	`canton`, `municipality`, `egrid`, `parcel_number`
`Estonia`	`county`, `municipality`, `settlement`
`Cyprus`	`district_code`, `sheet`, `plan`, `parcel_number`
`Lithuania`	`cadastral_zone`, `municipality_code`, `purpose`
`Latvia`	`territory_code`, `group_code`, `parcel_number`
`Portugal`	`municipality`, `parish`, `district_code`
`Slovenia`	`ko_code`, `ko_name`, `municipality`, `parcel_number`
`Italy`	`comune_code`, `foglio`, `particella`
`Germany`	`land`, `gemarkung`, `flur`, `parcel_number`
`Norway`	`municipality`, `municipality_code`, `gnr`, `bnr`
`Denmark`	`municipality`, `ejerlav`, `matrikelnr`
`Belgium`	`nis_code`, `section`, `parcel_number`

They are exposed flat on the plot and included in model_dump():

p = Plot(country="PL", x=639231, y=486743)
p.voivodeship          # 'mazowieckie'
p.model_dump().keys()  # common fields + country attributes + computed props

Serialization¶

p.model_dump()        # dict
p.model_dump_json()    # JSON string

Both include the common fields (geojson included), the country attributes and the computed area / centroid / bbox.

Exceptions¶

Exception	Raised by
`PlotNotFoundError`	any country — no parcel for the query
`AddressNotFoundError`	address geocoding returned nothing
`ULDKError`	Poland (ULDK / GUGiK)
`IGNError`	France (IGN apicarto)
`CatastroError`	Spain (Dirección General del Catastro)
`KadasterError`	Netherlands (PDOK Kadaster)
`GeoAdminError`	Switzerland (geo.admin.ch)
`MaaametError`	Estonia (Maa-amet)
`DLSError`	Cyprus (Department of Lands and Surveys)
`RCError`	Lithuania (Registrų centras / geoportal.lt)
`VZDError`	Latvia (Valsts zemes dienests)
`DGTError`	Portugal (DGT SNIC)
`GURSError`	Slovenia (GURS / e-prostor)
`AdEError`	Italy (Agenzia delle Entrate)
`ALKISError`	Germany (state ALKIS services)
`KartverketError`	Norway (Kartverket / Matrikkelen)
`DAWAError`	Denmark (DAWA / SDFI)
`CadGISError`	Belgium (FPS Finance CadGIS)

The Plot object¶