is-in-iran 0.1.0

Simple utility to check whether a (lat, lon) point lies inside Iran.

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

pip install is-in-iran

🎯 Usage

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:

pip install -e .

Resources

• GeoJSON Source