Metadata-Version: 2.4
Name: plot-finder
Version: 1.3.0
Summary: Find land parcels in Poland, France, Spain and the Netherlands by id, address or coordinates
Author: Ernest Ilchenko
License-Expression: MIT
Project-URL: Homepage, https://github.com/ernestilchenko/plot-finder
Project-URL: Documentation, https://ernestilchenko.github.io/plot-finder/
Keywords: cadastre,parcel,plot,geodesy,poland,france,spain,netherlands,uldk,ign,catastro,kadaster
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic>=2.0
Requires-Dist: httpx>=0.24
Requires-Dist: shapely>=2.0
Requires-Dist: pyproj>=3.6
Dynamic: license-file

# plot-finder

![Python](https://img.shields.io/badge/Python-3.10+-3776AB?logo=python&logoColor=white)
![License](https://img.shields.io/badge/License-MIT-green)
![Pydantic](https://img.shields.io/badge/Pydantic-v2-E92063?logo=pydantic&logoColor=white)

> Python library to find land parcels in **Poland**, **France**, **Spain** and the **Netherlands** by id, address or coordinates.

One `Plot` class. `country` is required and selects the cadastre; the
country-specific attributes come from a matching class in `plot_finder.countries`.

## Installation

```bash
pip install plot-finder
```

## Poland 🇵🇱

```python
from plot_finder import Plot

plot = Plot(country="PL", plot_id="141201_1.0001.6509")
plot = Plot(country="PL", x=639231, y=486743)                  # EPSG:2180
plot = Plot(country="PL", address="Warszawa, Marszalkowska 1")

print(plot.voivodeship, plot.commune, plot.area)
```

Attributes: `voivodeship`, `county`, `commune`, `region`, `parcel`

## France 🇫🇷

```python
from plot_finder import Plot

plot = Plot(country="FR", plot_id="33063000KE0078")
plot = Plot(country="FR", x=-0.5792, y=44.8378)                # lon/lat, EPSG:4326
plot = Plot(country="FR", address="30 Rue Sainte-Catherine, Bordeaux")

print(plot.department, plot.commune, plot.area)
```

Attributes: `department`, `insee`, `commune`, `section`, `numero`

## Spain 🇪🇸

```python
from plot_finder import Plot

plot = Plot(country="ES", plot_id="0749407VK4704H")       # cadastral reference
plot = Plot(country="ES", x=-3.6999, y=40.4211)           # lon/lat, EPSG:4326
plot = Plot(country="ES", address="Calle de Alcalá 1, Madrid")

print(plot.province, plot.municipality, plot.area)
```

Attributes: `province`, `municipality`

## Netherlands 🇳🇱

```python
from plot_finder import Plot

plot = Plot(country="NL", plot_id="AKM01 K 3785")     # cadastral designation
plot = Plot(country="NL", x=4.6255, y=52.1987)        # lon/lat, EPSG:4326
plot = Plot(country="NL", address="Dam 1, Amsterdam")

print(plot.municipality, plot.section, plot.area)
```

Attributes: `municipality`, `section`, `parcel_number`

## Documentation

Full docs: [ernestilchenko.github.io/plot-finder](https://ernestilchenko.github.io/plot-finder/)

## License

MIT
