تصاویر زنده ماهواره‌ای: تصویر Sentinel، نقشه سطح سوخته و نقشه سیلاب

برای دریافت توکن، با خرید بسته ژئوکوین کیف پول را شارژ کنید و در توکن‌های API توکن بسازید. هزینه هر درخواست موفق از اعتبار همان توکن کم می‌شود.

این سرویس‌ها آنلاین‌اند: تصویر هر بار از آرشیو ماهواره‌های Sentinel برنامه Copernicus اروپا ساخته می‌شود (پاسخ "mode": "online" دارد). تاریخ‌ها میلادی و به شکل YYYY-MM-DD هستند؛ اگر فقط تاریخ شروع بدهید بازه ۱۰ روزه در نظر گرفته می‌شود. ضلع محدوده حداکثر ۱۲۰ کیلومتر است و دقت تصویر (resolution_m) برای محدوده‌های کوچک‌تر از ۱۰ کیلومتر به ۱۰ متر می‌رسد.

محدوده را به یکی از این چهار شکل بدهید: place (نام شهرستان)، bbox (west,south,east,north)، polygon ([[lat, lon], …]) یا lat و lon و radius_km.

۱. کدام روزها تصویر بدون ابر دارند؟

curl -X POST "https://cloud.geotajak.ir/api/geo/imagery/scenes" \
  -H "Authorization: Bearer YOUR_TOKEN" -H "Content-Type: application/json" \
  -d '{"lat": 33.65, "lon": 46.45, "radius_km": 10, "days": 30}'

{
  "summary": "شعاع 10 کیلومتری: در 30 روز اخیر 14 گذر Sentinel-2؛ آخرین تصویر کم‌ابر در 2026-09-29 با 2.5٪ ابر.",
  "days": 30,
  "count": 14,
  "latest_clear": {"date": "2026-09-29", "cloud_cover_pct": 2.5, "tiles": 1},
  "scenes": [{"date": "2026-10-09", "cloud_cover_pct": 86.5, "tiles": 1}, {"date": "2026-10-06", "cloud_cover_pct": 36.0, "tiles": 1}, {"date": "2026-10-04", "cloud_cover_pct": 80.8, "tiles": 1}]
}

اول این سرویس را صدا بزنید تا تاریخ مناسب را برای سرویس‌های بعدی انتخاب کنید. ماهواره هر نقطه را حدود هر ۵ روز یک بار می‌بیند.

۲. تصویر ماهواره‌ای یک محدوده

curl -X POST "https://cloud.geotajak.ir/api/geo/imagery/snapshot" \
  -H "Authorization: Bearer YOUR_TOKEN" -H "Content-Type: application/json" \
  -d '{"lat": 35.72, "lon": 51.33, "radius_km": 8, "date_from": "2025-07-01", "date_to": "2025-07-20", "style": "true_color"}'

تصویر در فیلد image به‌صورت Data URL (JPEG) برمی‌گردد و image_bounds چهار گوشه آن است. style یکی از این‌هاست: true_color رنگ طبیعی، false_color رنگ کاذب (پوشش گیاهی قرمز دیده می‌شود)، swir فروسرخ موج کوتاه (برای آتش و رطوبت)، ndvi نقشه سبزینگی. از هر نقطه کم‌ابرترین تصویر بازه انتخاب می‌شود.

۳. نقشه سطح سوخته پس از آتش‌سوزی

یک بازه درست قبل از آتش‌سوزی و یک بازه درست بعد از آن بدهید:

curl -X POST "https://cloud.geotajak.ir/api/geo/imagery/burn-scar" \
  -H "Authorization: Bearer YOUR_TOKEN" -H "Content-Type: application/json" \
  -d '{"bbox": "46.3,33.9,46.9,34.4", "before_from": "2024-05-20", "before_to": "2024-06-05", "after_from": "2024-07-10", "after_to": "2024-07-25"}'

{
  "summary": "محدوده انتخابی: بین 2024-05-20 و 2024-07-25 حدود 45.96 کیلومتر مربع (4,596 هکتار) سوخته دیده می‌شود، که 16.41 کیلومتر مربع آن شدت متوسط رو به زیاد یا زیاد است؛ 100٪ محدوده بدون ابر دیده شد.",
  "burned_km2": 45.96,
  "burned_hectare": 4596,
  "severe_km2": 16.41,
  "possible_low_severity_km2": 1178.26,
  "observed_pct": 100.0,
  "resolution_m": 54
}

زمینی «سوخته» شمرده می‌شود که شاخص سوختگی آن افت زیادی کرده و بعد از آن سیاه دیده شود؛ برداشت محصول و خشک‌شدن فصلی جدا در possible_low_severity_km2 می‌آید. هرچه دو بازه به زمان آتش‌سوزی نزدیک‌تر باشند نتیجه دقیق‌تر است. سوزاندن بقایای مزرعه هم سوختگی واقعی است و شمرده می‌شود. نقشه شدت در image برمی‌گردد (با "image": false حذف می‌شود). برای سابقه سالانه آتش‌سوزی از سابقه آتش‌سوزی استفاده کنید.

۴. نقشه سیلاب و گستره آب

بازه سیل را در date_from و یک بازه عادی قبل از آن را در reference_from بدهید:

curl -X POST "https://cloud.geotajak.ir/api/geo/imagery/water-extent" \
  -H "Authorization: Bearer YOUR_TOKEN" -H "Content-Type: application/json" \
  -d '{"bbox": "48.0,31.3,48.6,31.8", "date_from": "2019-04-08", "date_to": "2019-04-18", "reference_from": "2018-10-01", "reference_to": "2018-10-20"}'

{
  "summary": "محدوده انتخابی: در بازه 2019-04-08 تا 2019-04-18 حدود 266.26 کیلومتر مربع آب دیده می‌شود (سنجنده نوری (Sentinel-2))؛ نسبت به بازه مرجع 251.10 کیلومتر مربع آب جدید (آب‌گرفتگی) و 5.56 کیلومتر مربع آبِ از بین رفته؛ 69.1٪ محدوده دیده شد.",
  "water_km2": 266.26,
  "new_water_km2": 251.1,
  "new_water_hectare": 25110,
  "lost_water_km2": 5.56,
  "permanent_water_km2": 15.16,
  "observed_pct": 69.1
}

این نمونه سیل فروردین ۱۳۹۸ در دشت کرخه خوزستان است. new_water_km2 سطح آب‌گرفتگی جدید است. هنگام سیل معمولا آسمان ابری است: اگر observed_pct کم بود "sensor": "radar" را امتحان کنید که از ابر عبور می‌کند. رادار زمین صاف و خشک را هم شبیه آب می‌بیند، پس در مناطق خشک عدد آن را با تصویر نوری مقایسه کنید. بدون بازه مرجع فقط گستره آب همان بازه برمی‌گردد (مثلا سطح یک دریاچه یا سد).

منبع داده

تصاویر Sentinel-2 (نوری، ۱۰ متر) و Sentinel-1 (راداری) برنامه Copernicus اتحادیه اروپا؛ رایگان و آزاد. این نقشه‌ها برآورد سریع‌اند و جای بازدید میدانی و نقشه‌برداری رسمی را نمی‌گیرند.

نمایش آماده در سایت (بدون کدنویسی)

اگر به آدرس همین سرویس‌ها ui=true اضافه کنید، به‌جای JSON یک صفحه آماده (تصویر، نقشه، آمار و جدول نتیجه) برمی‌گردد که در <iframe> سایت شما قرار می‌گیرد و با رنگ‌های توکن شما ساخته می‌شود. جزئیات در راهنمای شروع و نمونه زنده در «آزمایشگاه سرویس» صفحه هر سرویس. با دکمه «چاپ / PDF» بالای همان صفحه می‌توانید نتیجه را به‌صورت گزارش PDF ذخیره کنید.