لایه‌های داده آفلاین: مقدار در نقطه، آمار منطقه‌ای (Zonal Statistics) و نقشه GeoJSON

سرویس‌های ریسک و منابع جواب آماده می‌دهند. اگر می‌خواهید خودتان با داده خام کار کنید، این چهار سرویس موتور عمومی همان لایه‌ها هستند.

سرویس	آدرس	جواب می‌دهد
فهرست لایه‌ها	`GET /api/geo/layers`	نام، واحد، دقت، منبع، مجوز و تاریخ هر لایه
مقدار در نقطه	`GET /api/geo/layers/point`	مقدار چند لایه در یک نقطه
آمار منطقه‌ای	`POST /api/geo/layers/zonal`	خلاصه هر لایه داخل یک محدوده
نقشه لایه	`GET /api/geo/layers/map`	سلول‌های GeoJSON یک لایه برای نقشه

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

لایه‌های موجود

گروه	لایه‌ها	دقت
سیلاب	`flood_rp10`، `flood_rp100`، `flood_rp500` (عمق به متر)	حدود ۳۰۰ متر
زمین‌لغزش	`landslide` (رده ۱ تا ۵)	حدود ۱ کیلومتر
پوشش زمین	`landcover` (۱۱ کلاس)	حدود ۳۰۰ متر
خورشید	`solar_ghi`، `solar_dni`، `solar_pvout`، `solar_tilt`، `solar_temp`	حدود ۱ کیلومتر
باد	`wind_speed_100m`، `wind_power_100m`	حدود ۱ کیلومتر
بارش	`rain_yearly` (هر سال از ۱۹۸۱ یک باند)	حدود ۵ کیلومتر
اقلیم	`climate_tmean_base`، `climate_precip_ssp245_2041` و ...	حدود ۱۸ کیلومتر

فهرست کامل و به‌روز را همیشه از /layers بگیرید.

۱. مقدار در نقطه

curl -G "https://cloud.geotajak.ir/api/geo/layers/point" \
  --data-urlencode "lat=31.3183" \
  --data-urlencode "lon=48.6706" \
  --data-urlencode "layers=landcover,solar_pvout,flood_rp100" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "values": [{"layer": "landcover", "value": 50, "label": "ساخته‌شده (شهر و روستا)"},
             {"layer": "solar_pvout", "unit": "kWh/kWp", "value": 1672.0},
             {"layer": "flood_rp100", "unit": "m", "value": 8.3}],
  "mode": "offline"
}

۲. آمار منطقه‌ای (Zonal Statistics)

محدوده: place، bbox، polygon یا lat و lon و radius_km.

curl -X POST "https://cloud.geotajak.ir/api/geo/layers/zonal" \
  -H "Authorization: Bearer YOUR_TOKEN" -H "Content-Type: application/json" \
  -d '{"layers": "flood_rp100,landcover,rain_yearly", "place": "شهرستان ابرکوه"}'

لایه پیوسته: میانگین، کمینه، بیشینه، میانه، صدک ۱۰ و ۹۰ و سهم سطح با مقدار غیرصفر
لایه کلاسی: مساحت و سهم هر کلاس و کلاس غالب
لایه سری زمانی: میانگین هر سال

سلول‌ها با مساحت واقعی‌شان وزن می‌گیرند.

۳. نقشه لایه

curl -G "https://cloud.geotajak.ir/api/geo/layers/map" \
  --data-urlencode "layer=flood_rp100" \
  --data-urlencode "bbox=48.4,31.1,49.0,31.6" \
  --data-urlencode "max_cells=2000" \
  -H "Authorization: Bearer YOUR_TOKEN"

یک FeatureCollection که هر سلول value (و برای لایه کلاسی label) دارد. اگر کادر بزرگ باشد سلول‌ها ادغام می‌شوند (cell_m اندازه هر سلول را می‌گوید). برای لایه سری زمانی با band سال را انتخاب کنید.

منبع و مجوز

هر پاسخ source، licence و data_date دارد. همه لایه‌ها از داده‌های آزاد جهانی ساخته شده‌اند (JRC، NASA، ESA، بانک جهانی، CHIRPS، WorldClim) و برای غربال و مقایسه مناسب‌اند.

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

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