Skip to content

yasserstudio/geoalgeria

Repository files navigation

English | Français | العربية

GeoAlgeria

by
Yasser's Studio

The open dataset for Algeria — install it, don't scrape it.

CI npm npm downloads jsDelivr hits GitHub stars License: MIT

Every Algeria dataset on the internet still lists 48 wilayas. Algeria has had 69 since April 2026. GeoAlgeria is the one that's current — with real Algérie Poste postal codes, GPS coordinates, bilingual names, and post offices & ATMs — shipped as JSON, CSV, GeoJSON, SQL, and TypeScript. One npm install, MIT, validated on every commit.

npm install geoalgeria
const dz = require("geoalgeria");

dz.wilayas;                       // all 69 wilayas
dz.getCommunesByWilaya(16);       // 57 communes in Algiers
dz.findByPostalCode("16000");     // → commune, daira, wilaya
dz.getPostOfficesByCommune(1731); // real Algérie Poste offices

What's inside

Count
Wilayas 69 provinces (2019 + 2026 reforms)
Dairas 555 districts, as first-class entities
Communes 1,528 bilingual FR/AR, postal codes, coordinates
Post offices 3,908 real Algérie Poste codes, coordinates
ATMs 2,026 Algérie Poste GAB network
Employment agencies 331 ANEM: 58 AWEM + 273 ALEM — @geoalgeria/emploi
Mobilis network 12,345 165 agencies + 12,180 points of sale — @geoalgeria/mobilis
5G coverage 1,681 Djezzy + Mobilis + Ooredoo 5G sites — @geoalgeria/telecom
Civil airports 33 ANAC: names, ICAO codes, contacts, coordinates — @geoalgeria/aviation
Banks & branches 1,704 all 21 licensed banks + 8 institutions; branches with RIB/SWIFT codes, ownership, coordinates — @geoalgeria/banques
Delivery carriers 411 16-carrier registry + 411 geocoded stop-desks across 61 wilayas (Yalidine, Guepex, Anderson, Noest, Maystro) — @geoalgeria/livraison
Youth & sports institutions 2,076 maisons de jeunes, sports complexes, hostels, cultural centers & more across 50 wilayas (Ministère de la Jeunesse) — @geoalgeria/jeunesse
Higher education 110 58 universities + 35 grandes écoles + 12 ENS + 5 centres across 51 wilayas, with official websites (MESRS) — @geoalgeria/enseignement-superieur
Tourism 4,348 995 hotels, 1,248 attractions, 1,184 historic sites, 282 thermal springs (ASAL), 32 national parks — @geoalgeria/tourisme
Vocational training 1,932 856 CFPA + 182 INSFP + 723 private accredited + 58 DFEPs + more across 58 wilayas (MFEP / takwin.dz) — @geoalgeria/formation-professionnelle

Formats: JSON · CSV · GeoJSON · SQL · TypeScript. The npm package ships JSON to stay light; CSV/GeoJSON/SQL ride in every GitHub Release.

Current to Law n° 26-06 (new territorial organization), Journal Officiel n° 25 of 5 April 2026 — plus the 2019 reform (Law 19-12).

Why not the others?

geoalgeria leblad algeria-cities
All 69 wilayas (2026 reform) ❌ (58)
Dairas as first-class entities
Real Algérie Poste postal codes ~
Coordinates per commune
Post offices & ATMs
E-commerce ready (flat)
npm + TypeScript types
GeoJSON / SQL exports
CI-validated every commit
Last updated 2026 2021 2023

See the full comparison →

Who it's for

  • E-commerce / COD — wilaya → daira → commune address cascades, postal-code validation, and shipping-zone config that matches what carriers actually use.
  • Maps & GIS — drop-in GeoJSON with 1,528 commune features, modeled correctly through both reforms.
  • Civic, research & data — clean, structured, sourced, and versioned reference data instead of PDFs.
  • Anything that touches Algeria — one install, types included.

Packages

Package npm What
packages/dataset geoalgeria Wilayas, dairas, communes + mirrored postal data
packages/poste @geoalgeria/poste Standalone post offices & ATMs from Algérie Poste
packages/emploi @geoalgeria/emploi Standalone employment agencies (AWEM + ALEM) from ANEM
packages/mobilis @geoalgeria/mobilis Standalone Mobilis agencies & approved points of sale
packages/telecom @geoalgeria/telecom Cross-operator 5G coverage (Djezzy + Mobilis + Ooredoo)
packages/aviation @geoalgeria/aviation Civil airports from ANAC — names, ICAO codes, coordinates
packages/banques @geoalgeria/banques All 21 licensed banks + financial institutions & 1,704 branches (RIB, SWIFT, ownership, coordinates)
packages/livraison @geoalgeria/livraison Delivery carrier registry + 411 geocoded stop-desks & per-carrier coverage (Yalidine, Guepex, Anderson, Noest, Maystro)
packages/jeunesse @geoalgeria/jeunesse Youth & sports institutions from the Ministère de la Jeunesse (2,076 across 50 wilayas)
packages/enseignement-superieur @geoalgeria/enseignement-superieur Higher-education network from MESRS — universities, grandes écoles, ENS & centres (110), with official websites & coordinates
packages/tourisme @geoalgeria/tourisme Tourism infrastructure — 4,348 geocoded hotels, attractions, historic sites, thermal springs & parks from ASAL, OSM & Wikidata
packages/formation-professionnelle @geoalgeria/formation-professionnelle Vocational training — 1,932 CFPA, INSFP, IFEP, IEP, DFEPs & private centers from MFEP (takwin.dz), with capacity, boarding & coordinates

Use without npm

<!-- via jsDelivr CDN, no install -->
<script>
  fetch("https://cdn.jsdelivr.net/npm/geoalgeria/data/ecommerce/communes.json")
    .then((r) => r.json())
    .then((communes) => { /* build your dropdown */ });
</script>

Prefer files? Grab CSV / GeoJSON / SQL from the zipped bundle on any GitHub Release, or browse packages/dataset/data/.

Where this is going

GeoAlgeria isn't a one-off dump. The goal is to be the canonical, continuously-updated open source for Algeria's data — kept current through every administrative reform, and expanding to more kinds of Algeria data as sources become available. Administrative divisions and postal/banking are the start, not the end.

Watch or ⭐ the repo to follow along, and open a discussion to request a dataset.

Contributing

Corrections and additions are welcome — see CONTRIBUTING.md. Good first issues usually just need a source link or a missing commune coordinate. Found wrong data? Open an issue.

Versioning & releases

Semantic versioning per package, automated with Changesets. See RELEASING.md and each package's CHANGELOG.md.

Sponsor

GeoAlgeria is free and MIT. If it saves you time, sponsor its maintenance — it funds keeping the data current and expanding the coverage.

License & disclaimer

Code: MIT. Data: compiled from public official sources (the Journal Officiel, Algérie Poste, ANEM, ANAC, each operator's/institution's public site) and redistributed for reference.

GeoAlgeria is an independent project — not affiliated with or endorsed by any government body, regulator, operator, or institution it references; their names and marks belong to their respective owners. The data is provided "as is", without warranty — verify against the official source before relying on it, especially for financial, payment, KYC, or compliance use. Full terms: DISCLAIMER.


If GeoAlgeria saved you from copy-pasting wilayas out of a PDF, give it a ⭐ — it helps the next Algerian developer find clean data.

Yasser's Studio

Made by Yasser's Studio · geoalgeria.com · LinkedIn · X · hello@yasser.studio

About

The open dataset for Algeria — 12 npm packages, 30,000+ records, MIT licensed. Wilayas, communes, post offices, banks, airports, 5G, delivery, tourism & more. JSON, CSV, GeoJSON, TypeScript. Docs: geoalgeria.com/data

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

Packages

 
 
 

Contributors