semvec/pypi-packages huggingface dataset:
is-in-iran 0.1.0
Simple utility to check whether a (lat, lon) point lies inside Iran.
License: MIT
Requires Python: >=3.8
Keywords: geojson, iran, geospatial, point-in-polygon

# is-in-iran

A lightweight Python library that checks whether a given geographic point  
(latitude, longitude) lies inside the borders of **Iran**.

It loads an official MultiPolygon GeoJSON of Iran and performs a  
point-in-polygon check using **Shapely**.

---

## 🚀 Installation

```bash
pip install is-in-iran
```

## 🎯 Usage

```python
from is_in_iran import is_in_iran


print(is_in_iran(35.6892, 51.3890))  # → True  (Tehran)
print(is_in_iran(40.4168, -3.7038))  # → False (Madrid)
```

• Input format: (latitude, longitude)
• CRS: WGS84 (standard GPS coordinates)
• Points exactly on the border also return True.

## Development Setup

1. Create and activate a virtual environment.
2. Install the package in editable mode:

```python
pip install -e .
```

## Resources

- [GeoJSON Source](https://github.com/datasets/geo-countries)