Skip to content

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

GeoAlgeria is a solo-built, open project with one goal: to become the first and most comprehensive portal for all of Algeria's data. Verifiable, current, and free to use. It comes in two parts: an interactive atlas you explore in the browser, and the datasets behind it, published as npm packages you install instead of scrape.

The atlas

The GeoAlgeria atlas at geoalgeria.com

geoalgeria.com puts 28+ datasets and 80,000+ records on one interactive map, redrawn for the 69 wilayas.

  • Cross-sector atlas: every sector on a single map, from post offices to mosques to hospitals, with a per-wilaya density view.
  • Live wildfire map: NASA FIRMS satellite hotspots alongside official Civil Protection bulletins, updated through the fire season (launched 23 July 2026).
  • 3,951 per-wilaya pages: one page for every wilaya and sector, built to be searchable.
  • Layer stacking: switch sectors on and off and read them together on the same map.
  • Command-K search: jump to any wilaya or commune straight from the keyboard.
  • Arabic, French, and English: the entire interface, fully right-to-left in Arabic.
  • Provenance on every record: each point shows where it came from and when it last changed. See the sources and changelog.

The live wildfire map at geoalgeria.com/fires

The data

Most Algeria datasets online still list 48 wilayas. Algeria has had 69 since April 2026. GeoAlgeria is kept current, with real Algérie Poste postal codes, geographic coordinates, bilingual names, and post offices & ATMs, shipped as JSON, CSV, GeoJSON, SQL, and TypeScript. One npm install, MIT-licensed, and CI-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 556 districts, as first-class entities
Communes 1,541 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 3,096 Djezzy + Mobilis + Ooredoo 5G sites. @geoalgeria/telecom
Civil airports 36 ANAC + OurAirports: names, ICAO + IATA codes, contacts, coordinates. @geoalgeria/aviation
Nonstop routes 123 Air Algérie's international network as directional legs, each with an operator, an evidence tier and a source. @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 establishments 2,334 maisons de jeunes, complexes sportifs de proximité, salles polyvalentes, auberges, cultural & science centers & more across 58 wilayas (Ministry of Youth and Sports). @geoalgeria/jeunesse
Sports facilities 5,141 stadiums, pools, proximity fields, athletics tracks, courts & more (27 types) across 58 wilayas (Ministry of Youth and Sports). @geoalgeria/sports
Higher education 177 universities, grandes écoles, ENS, centres + 19 private & 48 other-ministry institutions across 51 wilayas, with official websites (MESRS). @geoalgeria/enseignement-superieur
Tourism 4,348 1,602 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
Mosques 20,759 Wikidata + OpenStreetMap composite, Arabic & French names, denomination, all 69 wilayas. @geoalgeria/mosquees
Djezzy boutiques 128 geocoded retail stores with category, hours & commune/wilaya linkage (djezzy.dz). @geoalgeria/djezzy
Health establishments 695 EPH · EPSP · EHS · CHU from the Ministry of Health, bilingual, 600 geocoded via OSM + Wikidata. @geoalgeria/sante
Clinics & care facilities 1,894 Polycliniques, salles de soins, centres de santé, maternités & private clinics from OpenStreetMap, classified by type, bilingual, 66 wilayas. The community tier beside the sante registry, never summed with it. @geoalgeria/cliniques
Civil protection units 880 DGPC fire & rescue units nationwide, Arabic-named, address/phone/fax, status tier, all geocoded, official-primary (dgpc.dz), post-2026-reform wilaya linkage. @geoalgeria/protection-civile
Cultural places 1,083 Protected sites, museums, theatres, libraries + cultural establishments from the Ministry of Culture, bilingual, all geocoded, 66 wilayas. @geoalgeria/culture
Agriculture institutions 196 Services directorates (DSA), forest conservations, research/training institutes, chambers of agriculture, public offices & groups from the Ministry of Agriculture, bilingual, geocoded, 58 wilayas. @geoalgeria/agriculture
Schools 11,855 Primaires, CEM, lycées & préscolaires classified by cycle from OpenStreetMap, bilingual, all 69 wilayas. @geoalgeria/ecoles
Intercity bus stations 74 SOGRAL gares routières across 52 wilayas, names, addresses, surface areas, coordinates. @geoalgeria/gares-routieres
Rail & urban transit 692 train, tram, metro, aerial-tramway & gondola nodes (SNTF / SETRAM / SEMA), Wikidata + OSM composite, bilingual, 50 wilayas. @geoalgeria/ferroviaire
Urban bus lines 50 ETUSA (Alger), termini, stop counts, communes & stations served. @geoalgeria/buses
Pharmacies 3,797 officines geocoded from OpenStreetMap, bilingual where named, wilaya/commune-linked. @geoalgeria/pharmacies
Pharma manufacturers 171 approved medicine & medical-device makers from the Ministry of Pharmaceutical Industry register, geocoded. @geoalgeria/industrie-pharmaceutique
Ooredoo stores 572 Espaces Ooredoo, City Shops & Espaces Services with real coordinates, wilaya/commune-linked (ooredoo.dz). @geoalgeria/ooredoo

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 GeoAlgeria?

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
npm + TypeScript types
GeoJSON / SQL exports
CI-validated on 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,541 commune features, modeled correctly through both reforms.
  • Research, open data & civic projects: clean, structured, sourced, and versioned reference data instead of PDFs.
  • Any project using Algerian data: one install, types included.

Packages

Package npm What
packages/dataset geoalgeria Wilayas, dairas, communes + structured 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 + OurAirports, names, ICAO + IATA codes, coordinates, plus the nonstop international route network
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 establishments from the Ministry of Youth and Sports (2,334 across 58 wilayas)
packages/sports @geoalgeria/sports Sports facilities from the Ministry of Youth and Sports, 5,141 across 58 wilayas, 27 types, with capacity, PMR access & coordinates
packages/enseignement-superieur @geoalgeria/enseignement-superieur Higher-education network from MESRS, universities, grandes écoles, ENS, centres + private & other-ministry institutions (177), 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
packages/djezzy @geoalgeria/djezzy Djezzy boutiques, 128 geocoded retail stores from djezzy.dz, with category, hours & commune/wilaya linkage
packages/mosquees @geoalgeria/mosquees Mosques of Algeria, 20,759 geocoded, a Wikidata + OpenStreetMap composite with Arabic & French names, denomination & commune/wilaya linkage
packages/sante @geoalgeria/sante Public health establishments, 695 from the Ministry of Health (EPH, EPSP, EHS, CHU), bilingual, geocoded via OSM + Wikidata with commune/wilaya linkage
packages/cliniques @geoalgeria/cliniques Clinics & proximity-care facilities, 1,894 geocoded from OpenStreetMap across 66 wilayas, classified by type (polyclinique/salle de soins/centre de santé/maternité/clinique), bilingual, with sector, speciality, phone & hours where tagged; the OSM community tier of the health sector, and every OSM element sante references is excluded from it
packages/culture @geoalgeria/culture Cultural atlas, 1,083 places from the Ministry of Culture (protected sites, museums, theatres, libraries, cultural establishments), bilingual, fully geocoded with commune/wilaya linkage
packages/agriculture @geoalgeria/agriculture Agriculture-sector institutions, 196 from the Ministry of Agriculture across 7 networks (DSA, forest conservations, research/training institutes, chambers of agriculture, public offices & groups), bilingual, geocoded with commune/wilaya linkage
packages/ecoles @geoalgeria/ecoles Schools, 11,855 schools & kindergartens from OpenStreetMap, classified by cycle (primaire/moyen/secondaire/préscolaire), bilingual, all 69 wilayas, with commune/wilaya linkage
packages/gares-routieres @geoalgeria/gares-routieres Intercity bus stations, 74 SOGRAL gares routières across 52 wilayas, geocoded with surfaces & commune/wilaya linkage
packages/ferroviaire @geoalgeria/ferroviaire Rail & urban transit, 692 train/tram/metro/aerial/gondola nodes (SNTF/SETRAM/SEMA), Wikidata + OSM composite, bilingual FR/AR
packages/buses @geoalgeria/buses Urban bus networks, 50 ETUSA (Alger) lines with termini, stop counts, communes & stations served (line-level v1)
packages/industrie-pharmaceutique @geoalgeria/industrie-pharmaceutique Pharmaceutical manufacturers, 171 approved medicine (PP) & medical-device (DM) makers from the Ministry of Pharmaceutical Industry register, bilingual, geocoded to commune/wilaya centroid
packages/pharmacies @geoalgeria/pharmacies Pharmacies (officines), 3,797 geocoded across 67 wilayas from OpenStreetMap, bilingual where named, with phone/hours/dispensing where tagged & commune/wilaya linkage
packages/protection-civile @geoalgeria/protection-civile Civil protection (fire & rescue) units, 880 DGPC units nationwide, Arabic-named, with address/phone/fax & a status tier, all geocoded, official-primary (dgpc.dz); wilaya re-derived against the 69 post-2026-reform boundaries
packages/ooredoo @geoalgeria/ooredoo Ooredoo stores, 572 EO / City Shop / Espace Services with real coordinates & commune/wilaya linkage (ooredoo.dz); completes the telecom retail trio
packages/transport @geoalgeria/transport Umbrella, installs aviation + ferroviaire + gares-routieres + buses in one step
packages/pharma @geoalgeria/pharma Umbrella, installs industrie-pharmaceutique + pharmacies in one step

Browse all packages → · API docs & field reference →

Data contract

Since v2.0.0, every sector package shares one canonical record contract, defined by the internal @geoalgeria/schema package, a dev dependency used by each generator, never published to npm.

Every record follows the same shape:

  • wilaya_code is a zero-padded string ("16"); commune linkage is commune_code + commune; coordinates are lat / lng (both numbers, or both null).
  • External ids live under refs (osm, wikidata, …).
  • geo_precision is strictly exact | approximate | null, null exactly when there is no coordinate, with the geocoding method in geo_method.

Machine-readable artifacts ride alongside: a root index.json catalog, a schema.org/Dataset descriptor (dataset-metadata.json) in each package, and the 69 wilaya boundary polygons in the core package at data/geojson/wilaya-boundaries.geojson (display-grade).

One package predates the contract, the core geoalgeria dataset (administrative divisions, not GeoRecords; marked schema_version: null in the catalog).

Migrating a package? See packages/schema/MIGRATING.md.

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 open reference source, continuously updated, 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. What is planned and what is still open is in ROADMAP.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

Open geographic data for Algeria: 28 npm packages, 77,000+ records, plus the interactive trilingual atlas at geoalgeria.com. Wilayas, communes, post offices, banks, health, mosques, transit & more. JSON, CSV, GeoJSON, SQL, TypeScript.

Topics

Resources

Contributing

Security policy

Stars

16 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages