Background
بازگشت به بلاگ

سرویس‌های کشاورزی: خاک، اقلیم کشاورزی، خشکسالی و الگوی کشت هوشمند

۱۴۰۵/۷/۹
تیم ژئوتاژک
سرویس‌های کشاورزی: خاک، اقلیم کشاورزی، خشکسالی و الگوی کشت هوشمند

تصمیم درباره اینکه امسال در یک منطقه چه بکاریم به سه چیز بستگی دارد: خاک آن زمین، اقلیم منطقه (یخبندان، گرما، بارش و تبخیر) و وضعیت آب امسال. سرویس‌های کشاورزی ژئوتاژک این سه را برای هر نقطه ایران (و جهان) فراهم می‌کنند و در نهایت محصولات مناسب را رتبه‌بندی می‌کنند؛ برای سامانه‌های مشاوره کشاورزی، بیمه محصول، تسهیلات بانکی کشاورزی و دستیارهای هوشمند تصمیم‌یار.

سرویسآدرسکاربرد
خاک‌شناسی نقطهGET /api/geo/soilبافت، pH، کربن آلی، نیتروژن، CEC، گروه خاک و احتمال شوری
اقلیم کشاورزیGET /api/geo/agro/climateتاریخ یخبندان، طول دوره رشد، درجه-روز رشد، تبخیر-تعرق و کمبود آب ماهانه
پایش خشکسالیGET /api/geo/agro/droughtبارش سال آبی و ماه‌های اخیر نسبت به نرمال، شاخص SPI و رطوبت خاک
الگوی کشت پیشنهادی (AI)GET /api/geo/agro/crop-suitabilityرتبه‌بندی بیش از ۲۰ محصول با نیاز آبیاری و توضیح هوشمند

دریافت توکن

  1. در داشبورد ژئوتاژک کلود با خرید بسته ژئوکوین کیف پول را شارژ کنید (با تایید موبایل ۲۰۰ هزار ژئوکوین هدیه می‌گیرید).
  2. در توکن‌های API توکنی با دسترسی به این سرویس‌ها بسازید.
  3. کلید را در هدر Authorization: Bearer YOUR_TOKEN بفرستید.

مکان را در همه سرویس‌ها با place (نام شهر یا منطقه) یا lat و lon مشخص کنید.

۱. خاک‌شناسی نقطه

curl -G "https://cloud.geotajak.ir/api/geo/soil" \
  --data-urlencode "place=اصفهان" \
  -H "Authorization: Bearer YOUR_TOKEN"

پاسخ (خلاصه‌شده):

{
  "topsoil_0_30cm": {"clay_pct": 32.9, "sand_pct": 31.0, "silt_pct": 36.1, "ph": 7.8,
                     "organic_carbon_g_kg": 6.7, "nitrogen_g_kg": 0.9, "cec_cmol_kg": 18.2},
  "texture_fa": "لوم رسی",
  "ph_class": "قلیایی",
  "soil_group": {"name_fa": "رگوسول", "probabilities": [{"name_fa": "رگوسول", "percent": 31}]},
  "salinity_risk_pct": 0,
  "notes": ["خاک آهکی/قلیایی رایج در ایران؛ کود ریزمغذی (آهن و روی) توصیه می‌شود", "مواد آلی کم تا متوسط"],
  "profile": {"clay": {"0-5cm": 31.6, "5-15cm": 32.8, "15-30cm": 35.4, "30-60cm": 36.0, "60-100cm": 35.1}}
}
  • topsoil_0_30cm: میانگین وزنی لایه سطحی (عمق شخم)؛ profile همه ویژگی‌ها را تا عمق ۱ متر می‌دهد.
  • texture_fa: کلاس بافت خاک (مثلث بافت USDA) و soil_group: گروه خاک (طبقه‌بندی WRB) با توضیح فارسی.
  • salinity_risk_pct: احتمال شور یا سدیمی بودن خاک بر اساس گروه خاک (آزمایش EC را جایگزین نمی‌کند).
  • در شهرها و پهنه‌های آبی داده خاک وجود ندارد؛ سرویس نزدیک‌ترین نقطه دارای داده (تا حدود ۲٫۵ کیلومتر) را برمی‌گرداند و مختصات آن را در sampled_at می‌دهد.

۲. اقلیم کشاورزی

curl -G "https://cloud.geotajak.ir/api/geo/agro/climate" \
  --data-urlencode "place=اصفهان" --data-urlencode "years=20" \
  -H "Authorization: Bearer YOUR_TOKEN"
  • frost: میانگین تاریخ آخرین یخبندان بهاره و اولین یخبندان پاییزه (شمسی)، تاریخ «امن» (۹۰٪ سال‌ها بعد از آن یخبندان نبوده)، طول دوره بدون یخبندان و تعداد روزهای یخبندان.
  • annual: بارش، تبخیر-تعرق مرجع (ET0)، کمبود آب، شاخص خشکی و کلاس اقلیمی، درجه-روز رشد (پایه ۰، ۵ و ۱۰)، روزهای سرد زمستان (نیاز سرمایی درختان)، روزهای بالای ۳۵ و ۴۰ درجه.
  • months: برای هر ماه شمسی دما، بارش، ET0، کمبود آب، روزهای یخبندان و گرما.

نمونه خلاصه: «اصفهان: اقلیم کشاورزی خشک با بارش سالانه حدود ۱۳۶ و تبخیر-تعرق مرجع حدود ۱۴۶۳ میلی‌متر. دوره بدون یخبندان حدود ۲۳۲ روز؛ آخرین یخبندان بهاره به‌طور میانگین ۱۳ فروردین و اولین یخبندان پاییزه ۲۹ آبان.»

۳. پایش خشکسالی

curl -G "https://cloud.geotajak.ir/api/geo/agro/drought" \
  --data-urlencode "place=یزد" \
  -H "Authorization: Bearer YOUR_TOKEN"
  • status و index: وضعیت کلی (از «خشکسالی بسیار شدید» تا «ترسالی شدید») و شاخص استاندارد بارش.
  • water_year: بارش سال آبی (از ۱ مهر) نسبت به نرمال همان بازه در ۳۰ سال گذشته؛ در هفته‌های اول مهر، سال آبی گذشته گزارش می‌شود.
  • windows: بارش ۱، ۳، ۶ و ۱۲ ماه اخیر با درصد نرمال و شاخص SPI (در فصل خشک «بارش ناچیز و طبیعی» گزارش می‌شود).
  • soil_moisture: رطوبت خاک ناحیه ریشه و صدک آن نسبت به سال‌های گذشته.
  • advice: توصیه کلی برای برنامه کشت امسال.

۴. الگوی کشت پیشنهادی (AI)

curl -G "https://cloud.geotajak.ir/api/geo/agro/crop-suitability" \
  --data-urlencode "place=یزد" --data-urlencode "explain=true" \
  -H "Authorization: Bearer YOUR_TOKEN"
پارامترتوضیح
crops(اختیاری) فقط این محصولات، مثلا wheat,pistachio,saffron
explaintrue = یک پاراگراف توصیه فارسی که هوش مصنوعی از نتایج می‌نویسد

محصولات: گندم (wheat)، جو (barley)، کلزا (canola)، گلرنگ (safflower)، ذرت (corn)، برنج (rice)، پنبه (cotton)، چغندرقند (sugar_beet)، سیب‌زمینی (potato)، گوجه‌فرنگی (tomato)، هندوانه (watermelon)، یونجه (alfalfa)، پسته (pistachio)، بادام (almond)، انگور (grape)، انار (pomegranate)، زیتون (olive)، خرما (date_palm)، سیب (apple)، زعفران (saffron) و کینوا (quinoa).

برای هر محصول: امتیاز ۰ تا ۱۰۰، کلاس (بسیار مناسب، مناسب، محدود، نامناسب)، نیاز آبی فصل و نیاز آبیاری (پس از کسر بارش مؤثر)، تحمل شوری و عوامل محدودکننده به زبان ساده؛ مثلا «امسال خشکسالی شدید؛ نیاز آبی زیاد (۸۰۰ میلی‌متر) پرریسک است» یا «سرمای زمستان برای این محصول خطرناک است». فیلد recommended محصولات مناسب را به ترتیب می‌دهد.

امتیاز از مقایسه نیاز هر محصول (دمای فصل رشد، تحمل سرمای زمستان، طول دوره بدون یخبندان، نیاز سرمایی، گرمای تابستان، pH و بافت خاک، شوری و نیاز آبی در شرایط خشکسالی امسال) با داده همان نقطه به دست می‌آید. این یک غربال اولیه و تصمیم‌یار است؛ برای تصمیم نهایی آزمایش خاک و آب و نظر کارشناس محلی لازم است.

ابزارهای تکی

سرویس‌های بالا از چند ابزار ساخته شده‌اند که جداگانه هم قابل استفاده‌اند؛ اگر فقط یک بخش را لازم دارید ارزان‌تر است:

ابزارآدرسخروجی
تقویم یخبندانGET /api/geo/agro/frostآخرین یخبندان بهاره و اولین یخبندان پاییزه (میانگین و تاریخ امن)، دوره بدون یخبندان، روزهای یخبندان هر ماه
بیلان آب و نیاز آبیGET /api/geo/agro/water-balanceبارش، تبخیر-تعرق مرجع و کمبود آب هر ماه شمسی و کلاس خشکی
رطوبت خاکGET /api/geo/agro/soil-moistureرطوبت سطح، ناحیه ریشه و کل نیمرخ خاک (۰ تا ۱) نسبت به همین زمان در سال‌های گذشته و روند ۶۰ روزه
بارش‌های حدیGET /api/geo/climate/rain-extremesصدک‌ها و رکورد بارش روزانه، بیشینه سه و پنج روزه، بارش با دوره بازگشت ۲ تا ۱۰۰ ساله

منبع داده

  • خاک: ISRIC SoilGrids با تفکیک ۲۵۰ متر (مجوز CC BY 4.0).
  • اقلیم، بارش و رطوبت خاک: NASA POWER (بازتحلیل MERRA-2) از سال ۱۹۸۱؛ تبخیر-تعرق به روش هارگریوز.
  • پیش‌بینی جوی: مؤسسه هواشناسی نروژ (MET Norway).

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

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

خطاها

کدتوضیحهزینه کسر می‌شود؟
400ورودی نادرست (مکان، نام محصول، بازه سال)خیر
404داده برای این نقطه موجود نیست (مثلا وسط دریاچه)بله
402اعتبار توکن تمام شده استخیر
502منبع داده موقتا در دسترس نیستخیر

سوالی دارید؟ از بخش تیکت‌ها در داشبورد با ما در ارتباط باشید.

APIکشاورزیخاکخشکسالیالگوی کشت