Metadata-Version: 2.4
Name: dz-geodata
Version: 0.1.0
Summary: Algeria's 69 wilayas, daïras and communes as GeoJSON/TopoJSON with Arabic/French/English names, ONS codes and lookup helpers.
Keywords: algeria,algerie,wilaya,commune,daira,geojson,topojson,boundaries,administrative boundaries,openstreetmap
Author: Abdeldjalil Chougui
License-Expression: MIT AND ODbL-1.0
License-File: DATA-LICENSE.md
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: Arabic
Classifier: Natural Language :: French
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: GIS
Requires-Python: >=3.10
Project-URL: Homepage, https://github.com/AbdeldjalilChougui/dz-geodata
Project-URL: Repository, https://github.com/AbdeldjalilChougui/dz-geodata
Project-URL: Issues, https://github.com/AbdeldjalilChougui/dz-geodata/issues
Project-URL: Data license, https://opendatacommons.org/licenses/odbl/1-0/
Description-Content-Type: text/markdown

# dz-geodata (Python)

Algeria's wilayas, daïras and communes with Arabic, French and English names,
ONS codes and simplified boundaries, plus lookup helpers. There are no
dependencies.

## Install

```sh
pip install dz-geodata
```

```python
import dz_geodata as dz

dz.wilaya(16)["name_ar"]            # 'الجزائر'
dz.commune("1601")["name_fr"]
dz.communes(wilaya_code=31)         # communes of Oran
dz.search("bejaia")[0]              # accent/diacritic-insensitive, ar/fr/en
dz.locate(3.0588, 36.7538)          # {'commune': ..., 'daira': ..., 'wilaya': ...}
dz.geojson("communes")              # full FeatureCollection (dict)
dz.data_path("algeria.topojson")    # path to the bundled file
```

Data © OpenStreetMap contributors, ODbL 1.0. Code MIT. See the
[project README](https://github.com/abdeldjalil-chougui/dz-geodata) for
provenance and limitations.
