{"id":13824525,"url":"https://github.com/ahmadazizi/iran-cities","last_synced_at":"2025-04-09T19:57:39.130Z","repository":{"id":40395820,"uuid":"87732593","full_name":"ahmadazizi/iran-cities","owner":"ahmadazizi","description":"The most accurate database of city, county, village and province names of Iran.","archived":false,"fork":false,"pushed_at":"2021-10-15T20:34:52.000Z","size":12119,"stargazers_count":458,"open_issues_count":3,"forks_count":76,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-04-09T19:57:29.598Z","etag":null,"topics":["database","geographic","iran"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ahmadazizi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-04-09T19:09:22.000Z","updated_at":"2025-04-08T18:48:55.000Z","dependencies_parsed_at":"2022-08-18T06:06:00.475Z","dependency_job_id":null,"html_url":"https://github.com/ahmadazizi/iran-cities","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmadazizi%2Firan-cities","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmadazizi%2Firan-cities/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmadazizi%2Firan-cities/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmadazizi%2Firan-cities/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ahmadazizi","download_url":"https://codeload.github.com/ahmadazizi/iran-cities/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248103910,"owners_count":21048245,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["database","geographic","iran"],"created_at":"2024-08-04T09:01:04.304Z","updated_at":"2025-04-09T19:57:39.105Z","avatar_url":"https://github.com/ahmadazizi.png","language":null,"funding_links":[],"categories":["Others"],"sub_categories":[],"readme":"# iran-cities\nIran-cities is the most accurate database of city, county, province and villages of Iran. Based on official released data.\n\n\u003cdiv dir=\"rtl\"\u003e\n  \n# بانک اطلاعات(دیتابیس) جامع و کامل اسامی استانها، شهرستانها، شهرها و روستاهای ایران\n\niran-cities .بانک اطلاعاتی حاوی تمامی تقسیمات کشوری ایران می باشد\n    سطوح تقسیمات سیاسی کشور ایران از بالاترین سطح تا پایین ترین آن به ترتیب شامل : استان، شهرستان، بخش و دهستان میباشد. بدینگونه که هر استان از چند شهرستان، هر شهرستان از چند بخش و هر بخش از چند دهستان تشکیل میشود. لازم به ذکر است که هر دهستان نیز شامل تعدادی نقاط روستایی، مکان و مزرعه میباشد که عناصر تقسیماتی نامیده میشوند.\n\n![Divisions of Iran](/docs/images/iran_divisions.png)\n    \nاین دیتابیس حاوی تمامی عناصر تقسیماتی کشور یعنی استان، شهرستان، بخش، شهر، دهستان و روستا/آبادی های ایران می باشد که به طور کامل براساس اطلاعات رسمی ارائه شده توسط مرکز آمار ایران ساخته شده است. برنامه نویسان و توسعه دهندگان نرم افزار می توانند براساس نیاز خود از کل یا بخشی از این داده ها در پروژه های خود استفاده نمایند.\n    \n    \n# تاریخچه\nاین بانک را زمانی ایجاد کردم که ناامید شدم! برای پروژه ای نیاز به بانک اطلاعاتی دقیق تمامی شهرهای ایران را داشتم، اما با جستجوی فراوان در اینترنت حتی یک نمونه کامل و بدون نقص پیدا نکردم.\nقبل از اینکه جستجو کنم به نظرم یافتن چنین چیزی بسیار ساده و پیش پا افتاده بود، اما در کمال تعجب نبود!\n    \nبا بررسی بانک های موجود بر روی اینترنت اشکالات زیر مشاهده گردید:\n- برخی از آنها بسیار قدیمی بودند و بسیاری از مناطق و شهرها در آنها لیست نشده بود، مثلا شامل استان البرز نبودند.\n- برخی از آنها تنها شامل برخی از شهرهای ایران بودند\n- برخی از آنها به اشتباه نام شهرستان های ایران را به عنوان لیست شهرهای ایران درج کرده بودند.\n- برخی از آنها بسیاری از شهرهای ایران را از قلم انداخته بودند، مثلا در یک بررسی سطحی مشخص شد که به عنوان مثال فاقد شهرهای لواسان در استان تهران و ساوه در استان مرکزی هستند.\n- علاوه بر اینها در اکثر آنها به جای استفاده از حروف فارسی از حروف معادل عربی (ي و ك) استفاده شده بود که برای جستجوی کاربران در اغلب سیستم عامل ها مشکل زا است.\n\nبه طور خلاصه اغلب بانک های موجود از روی چند منبع ناقص و قدیمی کپی شده بودند و دارای ایرادات فراوانی بودند.\n\nاین بانک تمام این اشکالات را برطرف کرده است و به طور کامل از روی آخرین داده های رسمی ایجاد گردیده است.\n\n# نسخه ۳.۰\nاین نسخه به روز رسانی مرداد ۱۳۹۹ می‌باشد که براساس آخرین داده‌های ارائه شده توسط مرکز آمار ایران ساخته شده است. این داده‌ها معمولاً به طور سالانه ارائه می‌شوند.\n\nتعداد تقسیمات کشوری به شرح زیر می‌باشد:\n\n| استان | شهرستان | بخش | شهر | دهستان | آبادی |\n| --- | --- | --- | --- | --- | --- |\n| ۳۱ | ۴۴۸ | ۱۰۹۹ | ۱۵۵۴/۱۳۵۴ | ۲۶۳۷ | ۹۸۱۰۰ |\n\n### ویژگی‌های جدید:\n* فیلد amar_code به تمامی جداول اضافه شده است که یک کد منحصربه‌فرد مرکز آمار ایران برای هریک از تقسیمات کشوری می‌باشد.\n\nاطلاعات تکمیلی مانند مختصات جغرافیایی برای کدهای آماری تاکنون به شکل آزاد توسط مرکز آمار ایران ارائه نشده است. \n**دسترسی به اطلاعات و آمار عمومی یک حق شهروندی است که متأسفانه علی‌رغم پیگیری‌های به عمل‌آمده، مرکز آمار ایران از ارائه آن سرباز می‌زند و مدارک آن هم موجود است.**\n\n# نسخه ۲.۰\nاین نسخه به روز رسانی فروردین ۱۳۹۹ می باشد. پس از استخراج و پاکسازی داده ها، این نسخه شامل ۳۱ استان، ۴۳۴ شهرستان، ۱۰۷۱ بخش، ۲۶۰۱ دهستان، ۱۵۱۸ شهر و ۹۷۹۱۵ روستا(آبادی و آبادی بلوکه) می باشد. بدیهی است در صورت به روز رسانی آمار رسمی، نسخه جدید هم براساس آخرین داده ها به روزآوری خواهد شد.\n\nهمچنین این ویژگیها نسبت به نسخه قبلی افزوده شده اند:\n- افزودن دهستان ها و روستاها(به تفکیک آبادی و آبادی-بلوکه مانند مرغداری ها و واحدهای صنعتی)\n- افزودن نواحی شهری و شهرداری که در شهرهای بزرگ وجود دارد(مناطق شهرداری مثل تهران منطقه ۱، منطقه ۲ و ...)\n- نام جداول از city, county, province به ostan, shahr و ... تغییر داده شده است.\n    \n# نسخه ۱.۰\nاین بانک براساس براساس آخرین تقسیمات کشوری تا پایان سال ۱۳۹۴ که توسط مرکز آمار ایران ارائه شده است ایجاد گردیده است. در زمان ایجاد این نسخه(فروردین ۱۳۹۶) این آخرین اطلاعات ارائه شده توسط مرکز آمار است که براساس آن  کشور ایران از ۳۱ استان، ۴۲۹ شهرستان، ۱۰۵۷ بخش، ۲۵۸۹ دهستان و ۱۲۴۵ شهر تشکیل یافته‌است. \nبدیهی است در صورت به روز رسانی آمار رسمی، نسخه جدید این بانک هم براساس آخرین داده ها به روزآوری خواهد شد.\n\n\n# ساختار\nساختار شامل جدول های 'ostan', 'shahrestan', 'bakhsh', 'dehestan', 'shahr', 'abadi' می باشد که نکات زیر قابل توجه می باشند:\n- حداکثر کلیدهای خارجی در داخل جدول ها گنجانده شده است تا سهولت لازم برای طراحی انواع رابطه بین جداول براساس نیاز وجود داشته باشد\n- داده ها به دو فرمت CSV و SQL ارائه شده است که باید قابلیت import کردن به تمامی دیتابیس های سازگار با SQL استاندارد(مانند MySQL, MSSQL, Oracle , غیره) را داشته باشد\n- در جدول shahr، فیلد shahr_type برای جداسازی شهر و ناحیه شهری تعبیه شده است\n- در جدول abadi، فیلد abadi_type برای جداسازی آبادی/روستا از آبادی-بلوکه تعبیه شده است\n\n\n![sample regions of Iran](/docs/images/sample_regions.png)\n![sample queries on iran-cities](/docs/images/sample_queries.png)\n\n\u003c/div\u003e\n\n# License\nMIT License\n\nCreated by Ahmad Azizi https://github.com/ahmadazizi/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahmadazizi%2Firan-cities","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fahmadazizi%2Firan-cities","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahmadazizi%2Firan-cities/lists"}