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.
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.
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 geoalgeriaconst 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| 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).
| 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 |
- 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.
| 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 →
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_codeis a zero-padded string ("16"); commune linkage iscommune_code+commune; coordinates arelat/lng(both numbers, or bothnull).- External ids live under
refs(osm,wikidata, …). geo_precisionis strictlyexact | approximate | null,nullexactly when there is no coordinate, with the geocoding method ingeo_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.
<!-- 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/.
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.
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.
Semantic versioning per package, automated with Changesets. See RELEASING.md and each package's CHANGELOG.md.
GeoAlgeria is free and MIT. If it saves you time, sponsor its maintenance, it funds keeping the data current and expanding the coverage.
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.
Made by Yasser's Studio · geoalgeria.com · LinkedIn · X · hello@yasser.studio


