سرویس‌های مدیریت بحران: هشدار جوی، زمین‌لرزه، سیل، آتش‌سوزی، زیرساخت و مخابرات
در یک بحران سوال‌ها مشخص است: چه خطری در راه است؟ کجا زلزله آمده؟ کدام روستا در مسیر سیل است؟ نزدیک‌ترین بیمارستان، پایگاه هلال احمر، پست برق و دکل مخابراتی کجاست؟ سرویس‌های مدیریت بحران ژئوتاژک جواب این سوال‌ها را برای هر نقطه کشور در یک درخواست می‌دهند؛ مناسب سامانه‌های ستاد بحران، هلال احمر، داشبوردهای استانداری، بیمه و دستیارهای هوشمند تصمیم‌یار.
| سرویس | آدرس | کاربرد |
|---|---|---|
| هشدارهای جوی | GET /api/geo/hazard/alerts | هشدار زرد، نارنجی و قرمز ۹ روز آینده |
| زمین‌لرزه‌ها | GET /api/geo/hazard/earthquakes | زمین‌لرزه‌های اخیر و سابقه ۵۰ ساله |
| ریسک سیلاب | GET /api/geo/hazard/flood | خطر سیل روزهای آینده و استعداد سیل‌گیری |
| آتش‌سوزی‌های فعال | GET /api/geo/hazard/fires | نقاط آتش شناسایی‌شده با ماهواره |
| زیرساخت‌های حیاتی | GET /api/geo/infrastructure | درمان، امداد، انرژی، ارتباطات، آب و حمل‌ونقل اطراف هر نقطه |
| دکل‌ها و سلول‌های مخابراتی | GET /api/geo/telecom | دکل‌ها و مراکز مخابراتی و سلول‌های موبایل |
برای دریافت توکن کیف پول را شارژ کنید و در توکن‌های API توکن بسازید. مکان را با place یا lat و lon بفرستید؛ همه پاسخ‌ها یک فیلد summary فارسی آماده نمایش دارند.
۱. هشدارهای جوی
curl -G "https://cloud.geotajak.ir/api/geo/hazard/alerts" \
--data-urlencode "place=اردبیل" \
-H "Authorization: Bearer YOUR_TOKEN"
برای هر روز از ۹ روز آینده این خطرها بررسی می‌شوند:
| خطر | زرد | نارنجی | قرمز |
|---|---|---|---|
| بارش شدید باران (میلی‌متر در روز) | ۱۵ | ۳۰ | ۵۰ |
| برف (میلی‌متر آب معادل) | ۱ | ۱۰ | ۲۵ |
| یخبندان (کمینه دما) | ۰° | ۵-° | ۱۰-° |
| گرمای شدید (بیشینه دما) | ۴۰° | ۴۳° | ۴۶° |
| باد (کیلومتر بر ساعت) | ۵۰ | ۷۰ | ۹۰ |
| رعد و برق | ✓ |
پاسخ: alerts (تاریخ شمسی، روز هفته، نوع، سطح و جزئیات)، max_level_fa و پیش‌بینی روزانه کامل.
۲. زمین‌لرزه‌ها
curl -G "https://cloud.geotajak.ir/api/geo/hazard/earthquakes" \
--data-urlencode "place=تهران" --data-urlencode "radius_km=200" --data-urlencode "days=30" \
-H "Authorization: Bearer YOUR_TOKEN"
| پارامتر | پیش‌فرض | توضیح |
|---|---|---|
radius_km | 200 | شعاع جستجو (۱۰ تا ۱۰۰۰) |
days | 30 | بازه زمانی (۱ تا ۳۶۵ روز) |
min_magnitude | 2.5 | حداقل بزرگی |
پاسخ: recent (زمین‌لرزه‌ها با بزرگی، عمق، فاصله و زمان شمسی و قوی‌ترین رویداد) و historical (زمین‌لرزه‌های ۵ ریشتر به بالا از ۱۳۵۵ در شعاع ۱۰۰ کیلومتری و سطح لرزه‌خیزی ثبت‌شده).
۳. ریسک سیلاب
curl -G "https://cloud.geotajak.ir/api/geo/hazard/flood" \
--data-urlencode "lat=32.655" --data-urlencode "lon=51.68" --data-urlencode "radius_m=2000" \
-H "Authorization: Bearer YOUR_TOKEN"
سرویس سه چیز را کنار هم می‌گذارد:
- بارش پیش‌بینی‌شده ۹ روز آینده (بیشینه روزانه و سه‌روزه) در مقایسه با بارش‌های حدی ۳۰ سال گذشته همان نقطه (صدک ۹۹ و رکورد)؛
- فاصله تا رودخانه، مسیل و کانال و سدهای اطراف؛
- موقعیت توپوگرافی: اختلاف ارتفاع نقطه با اطراف (دره یا مسیل بودن).
پاسخ: risk_level (کم، متوسط، زیاد، بسیار زیاد) برای روزهای آینده، exposure_level (استعداد دائمی سیل‌گیری)، reasons به زبان ساده و جزئیات هر بخش. این یک برآورد اولیه است و جایگزین هشدار رسمی سازمان هواشناسی نیست.
۴. آتش‌سوزی‌های فعال
curl -G "https://cloud.geotajak.ir/api/geo/hazard/fires" \
--data-urlencode "place=ایلام" --data-urlencode "radius_km=50" --data-urlencode "days=2" \
-H "Authorization: Bearer YOUR_TOKEN"
نقاط آتش فعال شناسایی‌شده با ماهواره‌های VIIRS (تفکیک ۳۷۵ متر) در یک تا ده روز اخیر، با فاصله، زمان، اطمینان و شدت (توان تابشی).
۵. زیرساخت‌های حیاتی
curl -G "https://cloud.geotajak.ir/api/geo/infrastructure" \
--data-urlencode "place=کرمانشاه" --data-urlencode "radius_m=5000" \
-H "Authorization: Bearer YOUR_TOKEN"
| گروه | دسته‌ها |
|---|---|
| درمان | بیمارستان، درمانگاه و مرکز بهداشت، داروخانه |
| امداد | هلال احمر و اورژانس، آتش‌نشانی، اسکان اضطراری و نقطه تجمع، مدرسه و مسجد (اسکان موقت) |
| امنیت | پلیس |
| انرژی | پست برق، نیروگاه، خط انتقال برق، جایگاه سوخت |
| ارتباطات | دکل مخابراتی، مرکز مخابرات |
| آب | مخزن و سد، منبع آب، چاه، تصفیه‌خانه و ایستگاه پمپاژ |
| حمل‌ونقل | فرودگاه، بالگردنشین، ایستگاه راه‌آهن، پل‌های راه اصلی |
برای هر دسته تعداد و ۵ مورد نزدیک (نام، فاصله، مختصات و در صورت وجود ولتاژ، اپراتور، تعداد تخت و تلفن). با categories=hospital,red_crescent,substation فقط دسته‌های لازم را بگیرید. شعاع از ۲۰۰ متر تا ۲۰ کیلومتر است. داده از OpenStreetMap است و پوشش آن در همه مناطق کامل نیست.
۶. پوشش مخابراتی
curl -G "https://cloud.geotajak.ir/api/geo/telecom" \
--data-urlencode "place=بم" --data-urlencode "radius_m=3000" \
-H "Authorization: Bearer YOUR_TOKEN"
دکل‌ها و مراکز مخابراتی ثبت‌شده با فاصله و اپراتور، و آمار سلول‌های موبایل اطراف نقطه به تفکیک نسل شبکه (2G تا 5G) و اپراتور (همراه اول، ایرانسل، رایتل …).
ابزارهای تکی
سرویس‌های ریسک سیلاب و زیرساخت از این ابزارها ساخته شده‌اند که جداگانه هم در دسترس‌اند:
| ابزار | آدرس | خروجی |
|---|---|---|
| بارش‌های حدی و دوره بازگشت | GET /api/geo/climate/rain-extremes | صدک ۹۹، رکورد بارش، بیشینه چندروزه و بارش با دوره بازگشت ۲ تا ۱۰۰ ساله |
| آبراهه‌ها و سدها | GET /api/geo/hydro/waterways | رودخانه، مسیل، نهر، کانال، سد و مخزن اطراف نقطه با فاصله (radius_m تا ۱۰ کیلومتر) |
| پستی‌بلندی زمین | GET /api/geo/terrain/relief | ارتفاع، دره/دشت/دامنه/یال بودن، اختلاف ارتفاع با اطراف، شیب و جهت شیب |
| نزدیک‌ترین مراکز | GET /api/geo/nearest-facility | نزدیک‌ترین موارد از دسته‌های دلخواه، مثلا category=hospital,red_crescent,substation (limit تا ۵۰) |
دسته‌های nearest-facility: hospital، clinic، pharmacy، red_crescent، fire_station، police، shelter، school، mosque، substation، power_plant، power_line، fuel، telecom_mast، telephone_exchange، reservoir، water_tower، water_well، water_works، airport، helipad، rail_station، bridge.
برای پوشش شبکه موبایل (آنتن ایرانسل و همراه اول در نقطه، محدوده و مسیر) سرویس پوشش شبکه را ببینید.
منبع داده
MET Norway (پیش‌بینی، CC BY 4.0)، سازمان زمین‌شناسی آمریکا USGS (زمین‌لرزه)، NASA POWER (سابقه بارش)، NASA FIRMS (آتش فعال)، OpenStreetMap (زیرساخت و آبراهه‌ها)، SRTM (ارتفاع) و OpenCelliD (سلول‌های موبایل، CC BY-SA 4.0).
نمایش آماده در سایت (بدون کدنویسی)
اگر به آدرس همین سرویس ui=true اضافه کنید، به‌جای JSON یک صفحه آماده (نقشه، نمودار و جدول نتیجه) برمی‌گردد که در <iframe> سایت شما قرار می‌گیرد و با رنگ‌های توکن شما ساخته می‌شود. هزینه آن با درخواست معمولی یکی است. جزئیات در راهنمای شروع و نمونه زنده در «آزمایشگاه سرویس» صفحه هر سرویس.
خطاها
| کد | توضیح | هزینه کسر می‌شود؟ |
|---|---|---|
| 400 | ورودی نادرست (مکان، شعاع، بازه) | خیر |
| 402 | اعتبار توکن تمام شده است | خیر |
| 502 / 503 | منبع داده موقتا در دسترس نیست | خیر |
سوالی دارید؟ از بخش تیکت‌ها در داشبورد با ما در ارتباط باشید.