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

تصمیم درباره اینکه امسال در یک منطقه چه بکاریم به سه چیز بستگی دارد: خاک آن زمین، اقلیم منطقه (یخبندان، گرما، بارش و تبخیر) و وضعیت آب امسال. سرویسهای کشاورزی ژئوتاژک این سه را برای هر نقطه ایران (و جهان) فراهم میکنند و در نهایت محصولات مناسب را رتبهبندی میکنند؛ برای سامانههای مشاوره کشاورزی، بیمه محصول، تسهیلات بانکی کشاورزی و دستیارهای هوشمند تصمیمیار.
| سرویس | آدرس | کاربرد |
|---|---|---|
| خاکشناسی نقطه | GET /api/geo/soil | بافت، pH، کربن آلی، نیتروژن، CEC، گروه خاک و احتمال شوری |
| اقلیم کشاورزی | GET /api/geo/agro/climate | تاریخ یخبندان، طول دوره رشد، درجه-روز رشد، تبخیر-تعرق و کمبود آب ماهانه |
| پایش خشکسالی | GET /api/geo/agro/drought | بارش سال آبی و ماههای اخیر نسبت به نرمال، شاخص SPI و رطوبت خاک |
| الگوی کشت پیشنهادی (AI) | GET /api/geo/agro/crop-suitability | رتبهبندی بیش از ۲۰ محصول با نیاز آبیاری و توضیح هوشمند |
دریافت توکن
- در داشبورد ژئوتاژک کلود با خرید بسته ژئوکوین کیف پول را شارژ کنید (با تایید موبایل ۲۰۰ هزار ژئوکوین هدیه میگیرید).
- در توکنهای API توکنی با دسترسی به این سرویسها بسازید.
- کلید را در هدر
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 |
explain | true = یک پاراگراف توصیه فارسی که هوش مصنوعی از نتایج مینویسد |
محصولات: گندم (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 | منبع داده موقتا در دسترس نیست | خیر |
سوالی دارید؟ از بخش تیکتها در داشبورد با ما در ارتباط باشید.
