PHPackages armezit/iran-geo-data - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. armezit/iran-geo-data ActiveLibrary[Utility & Helpers](/categories/utility) armezit/iran-geo-data ===================== v2.0.0(8mo ago)014GPL-3.0TypeScript Since Aug 20Pushed 8mo agoCompare [ Source](https://github.com/armezit/iran-geo-data)[ Packagist](https://packagist.org/packages/armezit/iran-geo-data)[ RSS](/packages/armezit-iran-geo-data/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependenciesVersions (2)Used By (0) لیست شهرها و استان‌های ایران ============================ [](#لیست-شهرها-و-استان‌های-ایران) [![GitHub (Pre-)Release Date](https://camo.githubusercontent.com/1e777b3b4846d8d1242c04c8a9182a7d443b2054506244c0248372b263a5ff6d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652d646174652d7072652f73616a616464702f6c6973742d6f662d6369746965732d696e2d4972616e3f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/1e777b3b4846d8d1242c04c8a9182a7d443b2054506244c0248372b263a5ff6d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652d646174652d7072652f73616a616464702f6c6973742d6f662d6369746965732d696e2d4972616e3f7374796c653d666f722d7468652d6261646765)[![GitHub](https://camo.githubusercontent.com/8a32a3317df056de76c13f9666edcf14b1a410587370a5f1e558ac573d235a8e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f73616a616464702f6c6973742d6f662d6369746965732d696e2d4972616e3f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/8a32a3317df056de76c13f9666edcf14b1a410587370a5f1e558ac573d235a8e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f73616a616464702f6c6973742d6f662d6369746965732d696e2d4972616e3f7374796c653d666f722d7468652d6261646765)[![GitHub last commit](https://camo.githubusercontent.com/57bd8d4d0e9a7d124878f250bf425ca6b41bc79083099a4e44702cb5c24b41fa/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f73616a616464702f6c6973742d6f662d6369746965732d696e2d4972616e3f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/57bd8d4d0e9a7d124878f250bf425ca6b41bc79083099a4e44702cb5c24b41fa/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f73616a616464702f6c6973742d6f662d6369746965732d696e2d4972616e3f7374796c653d666f722d7468652d6261646765) این مخزن شامل لیستی جامع از شهرها و استان‌های ایران به همراه اطلاعات و استانداردهای مربوطه است. این مخزن شامل آخرین اطلاعات رسمی تقسیمات کشوری جمهوری اسلامی ایران تا ۱۴۰۲ است. در صورتی که فایل به‌روزتری منتشر شده است، به ما اطلاع دهید. موردتعداداستان‌ها31شهرستان‌ها482بخش‌ها1184شهرها1659دهستان‌ها1524آبادی‌هابه زودیویژگی‌ها -------- [](#ویژگی‌ها) - لیست شهرهای ایران به تفکیک استان - لیست شهرستان‌های ایران - پشتیبانی از فرمت‌های گوناگون: - CSV - JSON - XLSX - SQL (برای MySQL، PostgreSQL، MSSQL) - TypeScript - JavaScript - GO - Kotlin - Python - و هر زبانی که از .json پشتیبانی کند محتویات ------- [](#محتویات) - [مقدمه](#%D9%85%D9%82%D8%AF%D9%85%D9%87) - [ساختار پوشه‌ها](#%D8%B3%D8%A7%D8%AE%D8%AA%D8%A7%D8%B1-%D9%BE%D9%88%D8%B4%D9%87%E2%80%8C%D9%87%D8%A7) - [نحوه استفاده](#%D9%86%D8%AD%D9%88%D9%87-%D8%A7%D8%B3%D8%AA%D9%81%D8%A7%D8%AF%D9%87) - [مشارکت](#%D9%85%D8%B4%D8%A7%D8%B1%DA%A9%D8%AA) - [نسخه اختصاصی](#%D9%86%D8%B3%D8%AE%D9%87-%D8%A7%D8%AE%D8%AA%D8%B5%D8%A7%D8%B5%DB%8C) - [مجوز](#%D9%85%D8%AC%D9%88%D8%B2) - [سلب مسئولیت](#%D8%B3%D9%84%D8%A8-%D9%85%D8%B3%D8%A6%D9%88%D9%84%DB%8C%D8%AA) مقدمه ----- [](#مقدمه) این پروژه با هدف ارائه یک منبع باز و رایگان از داده‌های شهرها و استان‌های ایران ایجاد شده است. داده‌ها به صورت فایل‌های CSV، JSON، XLSX، SQL و دیگر فرمت‌ها در دسترس هستند. ساختار پوشه‌ها -------------- [](#ساختار-پوشه‌ها) - `docs/`: شامل مثال‌هایی از نحوه استفاده از داده‌ها در زبان‌های مختلف برنامه‌نویسی. - `official/`: شامل فایل‌های رسمی و استانداردهای تقسیمات کشوری. - `dist/`: شامل خروجی‌های تولید شده از داده‌ها. - `tools/`: شامل ابزارهای مورد نیاز برای تبدیل و پردازش داده‌ها. نحوه استفاده ------------ [](#نحوه-استفاده) برای استفاده از داده‌ها، می‌توانید مخزن را با دستور زیر کلون کنید: ``` git clone https://github.com/sajaddp/list-of-cities-in-Iran.git ``` همچنین می‌توانید فایل‌های موجود در پوشه `dist/` را دانلود کرده و در پروژه‌های خود استفاده کنید. ابزارهای موجود در پوشه `tools/` برای پردازش و تبدیل داده‌ها نیز قابل استفاده هستند. مشارکت ------ [](#مشارکت) ما از مشارکت‌های شما استقبال می‌کنیم. لطفاً قبل از ارسال درخواست، مستندات مشارکت را مطالعه کنید. برای تغییرات عمده، ابتدا یک issue باز کنید و تغییرات پیشنهادی خود را مطرح کنید. نسخه اختصاصی ------------ [](#نسخه-اختصاصی) در صورت نیاز به نسخه اختصاصی، از طریق آیدی [t.me/sajaddp71](https://t.me/sajaddp71) ارتباط برقرار کنید. مجوز ---- [](#مجوز) این پروژه تحت مجوز MIT منتشر شده است. برای اطلاعات بیشتر، فایل `LICENSE` را مطالعه کنید. سلب مسئولیت ----------- [](#سلب-مسئولیت) تنها مرجع اعلام مختصات جغرافیایی جمهوری اسلامی ایران، وزارت کشور است. این مخزن برای استناد حقوقی مناسب نیست و هرگونه استناد حقوقی فاقد ارزش است. --- List of Cities and Provinces in Iran ------------------------------------ [](#list-of-cities-and-provinces-in-iran) This repository contains a comprehensive list of cities and provinces in Iran along with related information and standards. This repository contains the latest official administrative divisions of the Islamic Republic of Iran as of 2023. If a newer file has been released, please inform us. ItemCountProvinces31Counties482Districts1184Cities1659Rural Districts1524VillagesSoonFeatures -------- [](#features) - List of cities in Iran by province - List of counties in Iran - Supported formats: - CSV - JSON - XLSX - SQL (for MySQL, PostgreSQL, MSSQL) - TypeScript - JavaScript - GO - Kotlin - Python - and any language supporting .json Contents -------- [](#contents) - [Introduction](#introduction) - [Folder Structure](#folder-structure) - [Usage](#usage) - [Contributing](#contributing) - [Exclusive Version](#exclusive-version) - [License](#license) - [Disclaimer](#disclaimer) Introduction ------------ [](#introduction) This project aims to provide an open and free resource of data for cities and provinces in Iran. The data is available in CSV, JSON, XLSX, SQL, and various other formats. Folder Structure ---------------- [](#folder-structure) - `docs/`: Contains examples of how to use the data in different programming languages. - `official/`: Contains official files and administrative division standards. - `dist/`: Contains generated distributions from the data. - `tools/`: Contains tools needed for data conversion and processing. Usage ----- [](#usage) To use the data, clone the repository with the following command: ``` git clone https://github.com/sajaddp/list-of-cities-in-Iran.git ``` You can also download the files available in the `dist/` folder and use them in your projects. Additionally, the tools available in the `tools/` folder can be used for data processing and conversion. Contributing ------------ [](#contributing) We welcome your contributions. Please read the contribution guidelines before submitting a request. For major changes, please open an issue first to discuss what you would like to change. Exclusive Version ----------------- [](#exclusive-version) For an exclusive version, please contact [t.me/sajaddp71](https://t.me/sajaddp71). License ------- [](#license) This project is licensed under the MIT License. For more information, see the `LICENSE` file. Disclaimer ---------- [](#disclaimer) The Ministry of Interior is the only official source for the geographic coordinates of the Islamic Republic of Iran. This repository is not suitable for legal reference, and any legal citation is invalid. Made with ❤ by [@sajaddp](https://github.com/sajaddp) ### Health Score 29 — LowBetter than 60% of packages Maintenance58 Moderate activity, may be stable Popularity6 Limited adoption so far Community13 Small or concentrated contributor base Maturity35 Early-stage or recently created project Bus Factor1 Top contributor holds 75.7% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 265d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/a703c4312d493c2434e8f560bec9706635f7f60c72c0378c9d27eb8dbb5f3e7b?d=identicon)[armezit](/maintainers/armezit) --- Top Contributors [![sajaddp](https://avatars.githubusercontent.com/u/3147493?v=4)](https://github.com/sajaddp "sajaddp (28 commits)")[![armezit](https://avatars.githubusercontent.com/u/2006991?v=4)](https://github.com/armezit "armezit (2 commits)")[![cinasina](https://avatars.githubusercontent.com/u/65864255?v=4)](https://github.com/cinasina "cinasina (1 commits)")[![farhadhp](https://avatars.githubusercontent.com/u/13365824?v=4)](https://github.com/farhadhp "farhadhp (1 commits)")[![majid-gholamheidari](https://avatars.githubusercontent.com/u/42252849?v=4)](https://github.com/majid-gholamheidari "majid-gholamheidari (1 commits)")[![mohammad-hassani](https://avatars.githubusercontent.com/u/59317946?v=4)](https://github.com/mohammad-hassani "mohammad-hassani (1 commits)")[![navidkhalilian](https://avatars.githubusercontent.com/u/69416447?v=4)](https://github.com/navidkhalilian "navidkhalilian (1 commits)")[![sina-yeganeh](https://avatars.githubusercontent.com/u/71815150?v=4)](https://github.com/sina-yeganeh "sina-yeganeh (1 commits)")[![BlackIQ](https://avatars.githubusercontent.com/u/55284339?v=4)](https://github.com/BlackIQ "BlackIQ (1 commits)") ### Embed Badge ![Health badge](/badges/armezit-iran-geo-data/health.svg) ``` [![Health](https://phpackages.com/badges/armezit-iran-geo-data/health.svg)](https://phpackages.com/packages/armezit-iran-geo-data) ``` ### Alternatives [vishnubob/wait-for-it Pure bash script to test and wait on the availability of a TCP host and port 9.8k157.6k3](/packages/vishnubob-wait-for-it)[ddeboer/transcoder Better encoding conversion for PHP 16705.6k10](/packages/ddeboer-transcoder)[nodejs-php-fallback/nodejs-php-fallback Allow you to call node.js module or scripts throught PHP and call a fallback function if node.js is not available 17454.7k8](/packages/nodejs-php-fallback-nodejs-php-fallback)[fjw/color-compare A library for converting colors (Hex, RGB, HSL, CIELAB (LAB), DIN-99) and calculating color distances based on DIN-99. 1310.0k](/packages/fjw-color-compare) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)