سامانه پایش هوشمند آلودگی هوا برای شهرهای ایران
Smart Air Pollution Monitoring System for Iranian Cities
هوایما یک اپلیکیشن وب تکصفحهای برای پایش کیفیت هوا در ۳۰ شهر بزرگ ایران است. این سامانه با استفاده از دادههای آنلاین، اطلاعات لحظهای شاخص کیفیت هوا (AQI)، پیشبینی هوشمند و راهنمای سلامت را در اختیار کاربران قرار میدهد.
HavayeMa is a single-page web application for monitoring air quality across 30 major Iranian cities. It provides real-time Air Quality Index (AQI) data, smart forecasts, and health recommendations using live online data.
|
Leaflet.heat |
| Charts | Chart.js |
| Air Quality API | Open-Meteo Air Quality API |
| Weather API | Open-Meteo Weather API |
| Font | Vazirmatn |
| Icons | Font Awesome 6 |
| Map Tiles | CartoDB Positron |
- یک مرورگر وب مدرن (Chrome, Firefox, Safari, Edge)
- اتصال به اینترنت (برای دریافت دادههای API)
# کلون کردن مخزن
git clone https://github.com/yourusername/havaye-ma.git
# ورود به پوشه پروژه
cd havaye-ma
# باز کردن در مرورگر
open index.html
# یا در ویندوز:
start index.html# با استفاده از Python
python -m http.server 8000
# یا با استفاده از Node.js
npx serve .
# یا با استفاده از PHP
php -S localhost:8000سپس در مرورگر باز کنید: http://localhost:8000
havaye-ma/
│
├── index.html
└── README.md
💡 این یک پروژه تکفایلی است. تمام HTML، CSS و JavaScript در فایل
index.htmlقرار دارد.
| شاخص AQI | وضعیت | رنگ | توضیحات |
|---|---|---|---|
| 0-50 | خوب | 🟢 سبز | کیفیت هوا رضایتبخش است |
| 51-100 | متوسط | 🟡 زرد | قابل قبول برای اکثر افراد |
| 101-150 | ناسالم برای حساسها | 🟠 نارنجی | گروههای حساس احتیاط کنند |
| 151-200 | ناسالم | 🔴 قرمز | همه باید احتیاط کنند |
| 201-300 | بسیار ناسالم | 🟣 بنفش | هشدار سلامت |
| 300+ | خطرناک | 🟤 قهوهای | اورژانس سلامت |
مشاهده لیست کامل ۳۰ شهر
| # | شهر | # | شهر | # | شهر |
|---|---|---|---|---|---|
| 1 | تهران | 11 | ارومیه | 21 | گرگان |
| 2 | مشهد | 12 | زاهدان | 22 | ساری |
| 3 | اصفهان | 13 | کرمان | 23 | بیرجند |
| 4 | کرج | 14 | اراک | 24 | بجنورد |
| 5 | شیراز | 15 | یزد | 25 | شهرکرد |
| 6 | تبریز | 16 | بندرعباس | 26 | سمنان |
| 7 | اهواز | 17 | همدان | 27 | یاسوج |
| 8 | قم | 18 | قزوین | 28 | اردبیل |
| 9 | رشت | 19 | زنجان | 29 | ایلام |
| 10 | کرمانشاه | 20 | سنندج | 30 | بوشهر |
اپلیکیشن از localStorage برای ذخیره تنظیمات کاربر استفاده میکند:
| کلید | توضیحات |
|---|---|
airQualityTheme |
تم انتخابی (light/dark) |
airQualityBookmarks |
مکانهای ذخیره شده |
airQualityLastLocation |
آخرین موقعیت انتخابی |
GET https://air-quality-api.open-meteo.com/v1/air-quality
پارامترها:
latitude- عرض جغرافیاییlongitude- طول جغرافیاییcurrent- دادههای لحظهای (us_aqi, pm10, pm2_5, ...)hourly- دادههای ساعتیtimezone- منطقه زمانی
GET https://api.open-meteo.com/v1/forecast
پارامترها:
latitude- عرض جغرافیاییlongitude- طول جغرافیاییcurrent- دما، رطوبت، سرعت باد
📝 هر دو API رایگان و بدون نیاز به کلید هستند.
از مشارکت شما استقبال میکنیم!
- پروژه را Fork کنید
- یک Branch جدید بسازید (
git checkout -b feature/amazing-feature) - تغییرات را Commit کنید (
git commit -m 'Add amazing feature') - به Branch خود Push کنید (
git push origin feature/amazing-feature) - یک Pull Request باز کنید
- اضافه کردن نوتیفیکیشن هشدار آلودگی
- پشتیبانی از PWA
- افزودن شهرهای بیشتر
- نمودار مقایسهای بین شهرها
- اشتراکگذاری در شبکههای اجتماعی
- Open-Meteo برای API رایگان کیفیت هوا
- Leaflet برای کتابخانه نقشه
- Vazirmatn برای فونت فارسی زیبا
- تمام مشارکتکنندگان عزیز
ساخته شده با ❤️ برای هوای پاک ایران
Made with ❤️ for Clean Air in Iran