The list of all Algerian provinces and cities according to the official division in different formats: csv, xlsx, php, json, etc.

Overview

algeria-cities

This repository contains the list of all the administrative provinces and cities in Algeria.

The data is up-to-date according to the official source of the Algerian Interior Ministry, including the 10 new Wilayas.

Languages

The list is available in:

  • Arabic language
  • ASCII, French language
  • Both

Data

There are:

  • 58 Wilayas (Provinces)
  • 546 Dairas (Administrations)
  • 1541 Communes (City, Municipality)
  • 3940 Post Codes

Format

The list is available in different formats:

  • CSV
  • JSON
  • SQL
  • PHP
  • XLSX aka. Microsoft Excel
  • Dart

Each format contains 3 versions of the data: in ASCII characters, in Arabic characters, and in both.

Each folder is structured as the following

%format%/%file_name%       -- contains data in both Arabic and ASCII characters
%format%/ar/%file_name%    -- contains data only in Arabic characters
%format%/ascii/%file_name% -- contains data only in ASCII (French) characters

Contribution

To contribute with a specific format to the repository, please open a pull request.

Desired formats:

  • Java array
  • Swift array

Desired data:

  • Latitude and Longitude of each city
Comments
  • Return data instead of storing it inside variables

    Return data instead of storing it inside variables

    changed the array holding the data. instead of storing it into a variable, now it is returned. i also corrected a mistake in JSON files. you can't use PHP-like comments inside a JSON file. besides, the JSON files needed a beautify to be usable a bit more.

    How to use ?

    include the file like this:

    $communes = include('communes.php');
    

    Why assigning data when including and not in the original file ?

    simply because it enhances code readability.

    List of changed files:

    5 files see : Files changed

    opened by celyes 3
  • Traduction en Arabe

    Traduction en Arabe

    Merci pour ces informations très utiles et pratiques. Mais en tant qu'arabe ne devrait-il pas avoir les noms en arabe? Je sais que c'est beaucoup de travail; mais comme c'est déjà fait en latin, l'arabe devrait être faisable aussi

    opened by hiddeneyes02 3
  • Non Correspondance (nom commune <-> wilaya)

    Non Correspondance (nom commune <-> wilaya)

    On sait bien que chaque nom de wilaya est un nom de comune (Sauf Alger et Alger Centre) Alors la requetes

    doit retourner Alger seulement
    Mais quand on l'exécute comme ça, elle retoune aussi M'sila et Tamanrasset car

    • La wilaya est écrite "Tamanrasset" et la commune "Tamanghasset"
    • La wilaya est écrite "M'sila" et la commune "Msila"

    C'est deux (02) cas doit être unifiés (selon la nomonclature officielle)

    opened by selmo47 3
  • Update wilayate

    Update wilayate

    Time to update the provinces :-)

    تقرر خلال إجتماع مجلس الوزراء اليوم الثلاثاء ترقية 10 ولايات منتدبة بالجنوب الكبير إلى ولايات جديدة و يتعلق الأمر بكل من ولايات: برج باجي مختار ، جانت ، عين صالح ، المنيعة ، عين قزام ،المغير ، تقرت ، بني عباس، تيميمون، اولاد جلال.

    الصفحة 13 إلى 16 من الجريدة الرسمية https://www.joradp.dz/FTP/jo-arabe/2019/A2019078.pdf

    opened by aminalgeria 2
  • Code postaux incorrects

    Code postaux incorrects

    bonjour, merci pour les effors frère, mais presque toutes les codes sont incorrects meme au niveau de wilaya d'alger :/ en effet je trouve que tu as pris les codes ONS et non pas postal.

    opened by AbdelhamidLarachi 2
  • Are commune_code right postal/zip codes?

    Are commune_code right postal/zip codes?

    Does municipality (commune) codes (commune_code) corresponding to real postal/zip codes? If the "commune" codes which are in the repository are just identifiers for technical purposes, in this case it is better to rename the name of the column "commune_code" in "commune_id" to avoid confusion between technical identifier and commune code (zip code) .

    Example 1 : for El Biar, the "commune" code (postal code / zip code) that can be found on the post office site is: 16003. And on the data of this repository we find 580.

    Example 2 : For the "commune" Béjaia which is located in the Wilaya of Béjaia (the wilaya and the municipality have the same name. Ok.), The postal code is really 06000. But on this deposit, I find 187 as code_commune.

    opened by BeliliFahem 1
  • 48 wilayas with their lat and lng

    48 wilayas with their lat and lng

    this file contain wilayas with their lat and lng picked from an official website, and respecting same names included in this folder

    the source of lat and lng of each wilaya : https://simplemaps.com/data/dz-cities

    opened by BennaceurHichem 1
  • Correspendance de noms entre communes et wilaya

    Correspendance de noms entre communes et wilaya

    répendant à l'issue #2 Dans communes (csv, excell, json, mysql, php) Correction de "Tamanghasset" vers "Tamanrasset" Correction de "Msila" vers "Msila"

    opened by selmo47 1
  • v3.x: Upgrade wilayas list and add post codes

    v3.x: Upgrade wilayas list and add post codes

    In this PR:

    1. Add 10 missing communes as described in #16
    2. Add 10 new Wilayas as described in https://www.aps.dz/regions/118329-les-10-nouvelles-wilayas-un-renfort-pour-le-developpement-socioeconomique
    3. Add all the post codes extracted from the official Post website https://www.poste.dz
    opened by othmanus 0
  • Wilaya 32 - El Bayadh: Missing Cities

    Wilaya 32 - El Bayadh: Missing Cities

    Background

    I'm working on two major upgrades to the repository:

    1. Add postal codes for all the cities and villages of Algeria
    2. Update the list of Wilayas to 58

    The expected result is to have:

    1. 3961 Postal Codes as per the latest update (January 2021)
    2. 1541 Cities (unchanged) as per the latest update (Mars 2021)

    Issue

    It got into my attention that I am missing 6 cities from the Wilaya 32 (El Bayadh). I got the list of the all the cities from the official website of the Interior Ministry of Algeria. When I double checked multiple sources, unfortunately, the official source is missing those 6 cities:

    • Lbiodh Sidi Cheikh
    • Ain El Orak
    • Boussemghoun
    • Sidi Ameur
    • Sidi Slimane
    • Tousmouline

    In addition, the Dairas assigned to some cities from the Wilaya 32 - El Bayadh were wrong.

    Resolution

    Follow the same structure from the source ONIL: https://onil.dz/wp-content/uploads/2017/10/32EL-BAYADH.pdf

    opened by othmanus 0
  • Algeria Cities v2.0

    Algeria Cities v2.0

    This PR contains the list of all the administrative provinces and cities in Algeria.

    Languages

    The list is available in two languages:

    • Arabic
    • French

    Data

    Each file contains the following data:

    • Wilaya
      • code: is the wilaya ID, between 1 and 48
      • name: in latin characters in French language
      • name_ar: in Arabic characters in Arabic language
    • Daira
      • code: is the official administrative code for the daira, prefixed by the wilaya's code
      • name: in latin characters in French language
      • name_ar: in Arabic characters in Arabic language
    • Commune
      • code: is the official administrative code for the city. IMPORTANT: this is NOT the postal code.
      • name: in latin characters in French language
      • name_ar: in Arabic characters in Arabic language

    Format

    The list is available in different formats:

    • CSV comma separated
    • JSON
    • MySQL schema
    • PHP
    • XML
    • XLSX aka. Microsoft Excel

    Contribution

    To contribute with a specific format to the repository, please open a pull request.

    Desired formats:

    • Java array
    • Flutter array
    • Swift array

    Desired data:

    • List of the postal codes per city: each city can have one or many post offices, and each post office has a postal code.
    • Latitude and Longitude of each city
    opened by dhramtani 0
  • I need to use this in a blood donation app, am I permitted to

    I need to use this in a blood donation app, am I permitted to

    Hello, I could not find another way to contact you in order to ask for permission to use this in my Flutter Blood donation app, can I ? thanks in advance.

    opened by noureddine1 2
  • Fix escape single quote bug

    Fix escape single quote bug

    When executing the SQL query(s), there will be a problem with the municipality or regions (commune_name_ascii, daira_name_ascii) whose name contains a quotation mark, but now this problem is solved, also the Arabic name of Ain Defla is fixed.

    opened by haceneouserir 0
  • Single quotes in sql files are not escaped

    Single quotes in sql files are not escaped

    Single quotes are not escaped in sql files, which results in errors when running the scripts.

    For example: 'Hassi R'mel ' should be 'Hassi R''mel'

    Tested on Postgres and oracle.

    opened by abdelhakim94 6
Releases(v3.0.0)
  • v3.0.0(Apr 5, 2021)

    Release Notes

    This release is breaking backwards compatibility.

    In this release:

    1. Add 10 missing cities in Wilaya 32 - El Bayadh (see issue #16)
    2. Add 10 new Wilayas according to https://www.aps.dz/regions/118329-les-10-nouvelles-wilayas-un-renfort-pour-le-developpement-socioeconomique
    3. Add 3940 Post Codes according to the official source https://www.poste.dz

    Documentation

    This repository contains the list of all the administrative provinces and cities in Algeria.

    The data is up-to-date according to the official source of the Algerian Interior Ministry, including the 10 new Wilayas.

    Languages

    The list is available in:

    • Arabic language
    • ASCII, French language
    • Both

    Data

    There are:

    • 58 Wilayas (Provinces)
    • 546 Dairas (Administrations)
    • 1541 Communes (City, Municipality)
    • 3940 Post Codes

    Format

    The list is available in different formats:

    • CSV
    • JSON
    • SQL
    • PHP
    • XLSX aka. Microsoft Excel
    • Dart

    Each format contains 3 versions of the data: in ASCII characters, in Arabic characters, and in both.

    Each folder is structured as the following

    %format%/%file_name%       -- contains data in both Arabic and ASCII characters
    %format%/ar/%file_name%    -- contains data only in Arabic characters
    %format%/ascii/%file_name% -- contains data only in ASCII (French) characters
    

    Contribution

    To contribute with a specific format to the repository, please open a pull request.

    Desired formats:

    • Java array
    • Swift array

    Desired data:

    • Latitude and Longitude of each city
    Source code(tar.gz)
    Source code(zip)
  • v2.1.0(Nov 27, 2020)

  • v2.0.0(Sep 26, 2020)

    Release Notes

    This version contains the list of all the administrative provinces and cities in Algeria.

    The data is up-to-date according to the official source of the Algerian state.

    Languages

    The list is available in two languages:

    • Arabic
    • French

    Data

    Each file contains the following data:

    • Wilaya
      • code: is the wilaya ID, between 1 and 48
      • name: in latin characters in French language
      • name_ar: in Arabic characters in Arabic language
    • Daira
      • code: is the official administrative code for the daira, prefixed by the wilaya's code
      • name: in latin characters in French language
      • name_ar: in Arabic characters in Arabic language
    • Commune
      • code: is the official administrative code for the city. IMPORTANT: this is NOT the postal code.
      • name: in latin characters in French language
      • name_ar: in Arabic characters in Arabic language

    Format

    The list is available in different formats:

    • CSV comma separated
    • JSON
    • MySQL schema
    • PHP
    • XML
    • XLSX aka. Microsoft Excel
    Source code(tar.gz)
    Source code(zip)
  • v1.0.0(Sep 26, 2020)

    Initial version of all the cities (with their provinces) of Algeria based on an unofficial database.

    It contains different formats such as JSON, XLSX, SQL, etc.

    Source code(tar.gz)
    Source code(zip)
Owner
Ramtani Othmane
Ramtani Othmane
Easily add all the 58 Algerian Wilayas and its Dairas to your cool Laravel project (Migrations, Seeders and Models).

Laravel-Algereography Laravel-Algereography allows you to add Migrations, Seeders and Models of Algerian Wilayas and Dairas to your existing or new co

Hocine Saad 48 Nov 25, 2022
This is a simple laravel API that returns provinces, districts, sectors, villages and cells found in Rwanda.

About - Rwanda This is a simple laravel API that returns provinces, districts, sectors, villages and cells found in Rwanda. Rwanda is organized in fou

Prince_Np 4 Jul 20, 2022
A simple Laravel Package to sort Countries, States and Cities

Laravel Location ▲ Introduction ?? This Package offers a simple way to get Countries, Cities and States that you may need for your Application, most e

Michael Okoh 197 Jan 1, 2023
oman cities package for laravel app

Seed oman governorates and cities This repo can be used to scaffold Oman Governorates and cities. Installation You can install the package via compose

Gheith Alrawahi 4 Jul 26, 2022
Effortlessly streamline tables and records printing in PDF/XLSX in your FilamentPHP application.

Filament Printables: a package to generate reports and form printables for your app. This is a work in progress thing Installation You can install the

fastOFI Corp 6 Jun 15, 2023
Laravel package to generate and to validate a UUID according to the RFC 4122 standard. Only support for version 1, 3, 4 and 5 UUID are built-in.

Laravel Uuid Laravel package to generate and to validate a universally unique identifier (UUID) according to the RFC 4122 standard. Support for versio

Christoph Kempen 1.7k Dec 28, 2022
Locust are malware that can delete all folders, files, etc. on the system; I

Locust are malware that can delete all folders, files, etc. on the system; It was originally designed for web systems.

Md. Ridwanul Islam Muntakim 21 Dec 9, 2022
Collection of classes you can use to standardize data formats in your Laravel application.

Laravel Formatters This package is a collection of classes you can use to standardize data formats in your Laravel application. It uses the Service Co

Michael Rubel 88 Dec 23, 2022
Laravel 5 package for reading and writing CSV files.

CSV Laravel 5 package for reading and writing CSV files. Warning The package has been updated to PHP 7. If you can't update to PHP 7 use version 0.6.x

Maciej Wilgucki 48 Nov 29, 2022
Laravel Larex lets you translate your whole Laravel application from a single CSV file.

Laravel Larex Translate Laravel Apps from a CSV File Laravel Larex lets you translate your whole Laravel application from a single CSV file. You can i

Luca Patera 68 Dec 12, 2022
Laravel Nova's Queued Export As CSV Action

Laravel Nova's Queued Export As CSV Action Installation To install through composer, run the following command from terminal: composer require "nova-k

null 9 Dec 15, 2022
A series of methods that let you manipulate colors. Just incase you ever need different shades of one color on the fly.

PHPColors A series of methods that let you manipulate colors. Just incase you ever need different shades of one color on the fly. Requirements PHPColo

Arlo Carreon 423 Dec 20, 2022
A simple Content Moderation System for Laravel 5.* that allows you to Approve or Reject resources like posts, comments, users, etc.

Laravel Moderation A simple Moderation System for Laravel 5.* that allows you to Approve or Reject resources like posts, comments, users, etc. Keep yo

Alex Kyriakidis 509 Dec 30, 2022
A simple Laravel package for generating download links with options such as expire time, IP restrictions, etc.

Generate download links in your Laravel applications This package allows you to generate download links for files. Once installed you can do stuff lik

Arman Ahmadi 12 Nov 24, 2022
Removes whitelisted unnecessary files (like tests/docs etc.) from vendor directory

Composer vendor cleanup This is a simple script for the Composer to remove unnecessary files (documentation/examples/tests etc.) from included vendor

Chris 2 Nov 14, 2022
Slim Jam is a demo application to provide examples for composer package, PHPSpreadsheet, Shopify API etc. usages.

SLIM JAM Slim Jam is a demo application to provide examples for composer package, PHPSpreadsheet, Shopify API etc. usages. This project aims to take a

Uğur ARICI 2 Jan 9, 2022
This is a courier api endpoints library for interacting such as e-courier, dhl, pathao etc

This is a courier api endpoints library for interacting such as e-courier, dhl, pathao etc Installation Step 1: composer require xenon/multicourier S

Ariful Islam 19 Sep 8, 2022
This package allows you to render livewire components like a blade component, giving it attributes, slots etc

X-livewire This package allows you to render livewire components like a blade component, giving it attributes, slots etc. Assuming you wanted to creat

null 7 Nov 15, 2022
The official ibanapi.com PHP Package.

?? IBAN API validation using ibanapi.com for PHP The official node package for validating IBAN using the ibanapi.com public API for PHP This module of

null 7 Jul 11, 2022