https://github.com/sajaddp/list-of-cities-in-iran
لیست شهرهای ایران به تفکیک استان - با ستاره دار کردن مخزن، قلبم را شاد کنید. ❤
https://github.com/sajaddp/list-of-cities-in-iran
csv go iran javascript json kotlin mssql mysql pgsql php postgres postgresql python3 sql typescript xlsx
Last synced: about 1 month ago
JSON representation
لیست شهرهای ایران به تفکیک استان - با ستاره دار کردن مخزن، قلبم را شاد کنید. ❤
- Host: GitHub
- URL: https://github.com/sajaddp/list-of-cities-in-iran
- Owner: sajaddp
- License: gpl-3.0
- Created: 2018-03-01T14:53:49.000Z (about 7 years ago)
- Default Branch: main
- Last Pushed: 2025-03-21T11:26:12.000Z (about 2 months ago)
- Last Synced: 2025-04-01T01:36:42.254Z (about 1 month ago)
- Topics: csv, go, iran, javascript, json, kotlin, mssql, mysql, pgsql, php, postgres, postgresql, python3, sql, typescript, xlsx
- Language: TypeScript
- Homepage:
- Size: 15.5 MB
- Stars: 438
- Watchers: 6
- Forks: 91
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# لیست شهرها و استان‌های ایران
این مخزن شامل لیستی جامع از شهرها و استان‌های ایران به همراه اطلاعات و استانداردهای مربوطه است. این مخزن شامل آخرین اطلاعات رسمی تقسیمات کشوری جمهوری اسلامی ایران تا ۱۴۰۲ است. در صورتی که فایل به‌روزتری منتشر شده است، به ما اطلاع دهید.
| مورد | تعداد |
| ---------- | ------- |
| استان‌ها | 31 |
| شهرستان‌ها | 482 |
| بخش‌ها | 1184 |
| شهرها | 1659 |
| دهستان‌ها | 1524 |
| آبادی‌ها | به زودی |
## ویژگی‌ها
- لیست شهرهای ایران به تفکیک استان
- لیست شهرستان‌های ایران
- پشتیبانی از فرمت‌های گوناگون:
- CSV
- JSON
- XLSX
- SQL (برای MySQL، PostgreSQL، MSSQL)
- TypeScript
- JavaScript
- GO
- Kotlin
- Python
- و هر زبانی که از .json پشتیبانی کند
## محتویات
- [مقدمه](#مقدمه)
- [ساختار پوشه‌ها](#ساختار-پوشه‌ها)
- [نحوه استفاده](#نحوه-استفاده)
- [مشارکت](#مشارکت)
- [نسخه اختصاصی](#نسخه-اختصاصی)
- [مجوز](#مجوز)
- [سلب مسئولیت](#سلب-مسئولیت)
## مقدمه
این پروژه با هدف ارائه یک منبع باز و رایگان از داده‌های شهرها و استان‌های ایران ایجاد شده است. داده‌ها به صورت فایل‌های CSV، JSON، XLSX، SQL و دیگر فرمت‌ها در دسترس هستند.
## ساختار پوشه‌ها
- `docs/`: شامل مثال‌هایی از نحوه استفاده از داده‌ها در زبان‌های مختلف برنامه‌نویسی.
- `official/`: شامل فایل‌های رسمی و استانداردهای تقسیمات کشوری.
- `dist/`: شامل خروجی‌های تولید شده از داده‌ها.
- `tools/`: شامل ابزارهای مورد نیاز برای تبدیل و پردازش داده‌ها.
## نحوه استفاده
برای استفاده از داده‌ها، می‌توانید مخزن را با دستور زیر کلون کنید:
```shell
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
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.
| Item | Count |
| --------------- | ----- |
| Provinces | 31 |
| Counties | 482 |
| Districts | 1184 |
| Cities | 1659 |
| Rural Districts | 1524 |
| Villages | Soon |
## 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
- [Introduction](#introduction)
- [Folder Structure](#folder-structure)
- [Usage](#usage)
- [Contributing](#contributing)
- [Exclusive Version](#exclusive-version)
- [License](#license)
- [Disclaimer](#disclaimer)
## 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
- `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
To use the data, clone the repository with the following command:
```shell
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
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
For an exclusive version, please contact [t.me/sajaddp71](https://t.me/sajaddp71).
## License
This project is licensed under the MIT License. For more information, see the `LICENSE` file.
## 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)