پوشش زمین، انرژی خورشیدی و بادی، سابقه بارش، تغییر اقلیم و میدان دید

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

این داده‌ها آفلاین روی سرور نگهداری می‌شوند (پاسخ‌ها "mode": "offline" دارند) و هر پاسخ منبع، مجوز و تاریخ داده را هم برمی‌گرداند.

۱. پوشش زمین

curl -G "https://cloud.geotajak.ir/api/geo/landcover/point" \
  --data-urlencode "lat=35.6892" \
  --data-urlencode "lon=51.3890" \
  --data-urlencode "radius_m=1000" \
  -H "Authorization: Bearer YOUR_TOKEN"

کلاس‌ها: ساخته‌شده (شهر و روستا)، زمین کشاورزی، مرتع و علفزار، بوته‌زار، پوشش درختی، زمین بایر، آب، تالاب، برف و یخ.

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

curl -X POST "https://cloud.geotajak.ir/api/geo/landcover/area" \
  -H "Authorization: Bearer YOUR_TOKEN" -H "Content-Type: application/json" \
  -d '{"bbox": "48.4,31.1,49.0,31.6"}'

{
  "summary": "محدوده انتخابی: زمین کشاورزی 51.4٪، زمین بایر و کم‌پوشش 32.5٪، ساخته‌شده (شهر و روستا) 6.2٪، مرتع و علفزار 4.3٪.",
  "built_up_pct": 6.2, "cropland_pct": 51.4, "rangeland_pct": 6.0, "bare_pct": 32.5,
  "classes": [{"class": 40, "label": "زمین کشاورزی", "area_km2": 1620.5, "area_hectare": 162050, "share_pct": 51.4}]
}

دقت داده حدود ۳۰۰ متر است؛ برای قطعه‌های چند هکتاری مناسب نیست.

۲. پتانسیل انرژی خورشیدی

curl -G "https://cloud.geotajak.ir/api/geo/energy/solar" \
  --data-urlencode "lat=31.9" \
  --data-urlencode "lon=54.36" \
  --data-urlencode "kwp=1000" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "summary": "این نقطه: تابش کل افقی 2,069 کیلووات‌ساعت بر متر مربع در سال؛ هر کیلووات پنل حدود 1,809 کیلووات‌ساعت در سال تولید می‌کند (پتانسیل بسیار خوب)؛ نیروگاه 1000 کیلوواتی حدود 1,809 مگاوات‌ساعت در سال.",
  "ghi_kwh_m2_year": 2069, "pvout_kwh_per_kwp_year": 1809, "capacity_factor_pct": 20.6, "optimum_tilt_deg": 30, "rating": "بسیار خوب",
  "system": {"kwp": 1000, "energy_mwh_year": 1809.0, "panel_area_m2": 5500, "land_area_hectare": 1.5}
}

با kwp ظرفیت نیروگاه را بدهید تا تولید سالانه، سطح پنل و زمین لازم برآورد شود.

۳. پتانسیل انرژی بادی

curl -G "https://cloud.geotajak.ir/api/geo/energy/wind" \
  --data-urlencode "lat=31.03" \
  --data-urlencode "lon=61.50" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "summary": "این نقطه: میانگین سرعت باد در ارتفاع ۱۰۰ متر 8.6 متر بر ثانیه و چگالی توان 708 وات بر متر مربع؛ پتانسیل بادی عالی.",
  "wind_speed_100m_ms": 8.6, "power_density_100m_w_m2": 708, "rating": "عالی"
}

۴. سابقه بارش سالانه

curl -G "https://cloud.geotajak.ir/api/geo/climate/rainfall" \
  --data-urlencode "place=رشت" \
  -H "Authorization: Bearer YOUR_TOKEN"

بارش هر سال از ۱۹۸۱ (yearly)، میانگین، ضریب تغییرات، روند در هر دهه، پربارش‌ترین و کم‌بارش‌ترین سال و مقایسه سال آخر با میانگین. سال‌ها میلادی‌اند.

۵. تغییر اقلیم

curl -G "https://cloud.geotajak.ir/api/geo/climate/projection" \
  --data-urlencode "place=یزد" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "summary": "این نقطه: نرمال ۱۹۷۰ تا ۲۰۰۰ میانگین دما 19.0 درجه و بارش 106 میلی‌متر؛ تا میانه قرن در سناریوی میانه +2.7 درجه و بارش +3٪؛ در بدترین حالت (بدبینانه (SSP5-8.5)، ۲۰۸۱ تا ۲۱۰۰) +7.2 درجه.",
  "baseline": {"temp_mean_c": 19.0, "hottest_month_max_c": 39.5, "precipitation_mm": 106.0},
  "projections": [{"scenario_fa": "میانه (SSP2-4.5)", "period": "۲۰۴۱ تا ۲۰۶۰", "warming_c": 2.7, "precipitation_change_pct": 2.8}]
}

چهار ردیف: دو سناریو (میانه و بدبینانه) برای دو دوره. میانگین پنج مدل اقلیمی روی شبکه ۱۸ کیلومتری است: روند منطقه را نشان می‌دهد و بارش آینده عدم‌قطعیت زیادی دارد.

۶. میدان دید (Viewshed)

برای جانمایی دکل مخابراتی، برج دیده‌بانی آتش یا دوربین:

curl -G "https://cloud.geotajak.ir/api/geo/terrain/viewshed" \
  --data-urlencode "lat=35.80" \
  --data-urlencode "lon=51.42" \
  --data-urlencode "radius_m=5000" \
  --data-urlencode "observer_height_m=20" \
  -H "Authorization: Bearer YOUR_TOKEN"

سهم زمین قابل دید، برد دید در هشت جهت و محدوده دید به‌صورت GeoJSON. فقط عوارض زمین در نظر گرفته می‌شود (بدون ساختمان و درخت).

۷. خط دید بین دو نقطه

curl -G "https://cloud.geotajak.ir/api/geo/terrain/line-of-sight" \
  --data-urlencode "from_lat=35.70" \
  --data-urlencode "from_lon=51.38" \
  --data-urlencode "to_lat=35.80" \
  --data-urlencode "to_lon=51.42" \
  --data-urlencode "from_height_m=20" \
  --data-urlencode "to_height_m=20" \
  --data-urlencode "frequency_mhz=5800" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "summary": "فاصله 11.7 کیلومتر؛ دید مستقیم برقرار نیست؛ کمترین فاصله پرتو تا زمین -23.3 متر در 5.3 کیلومتری مبدأ؛ ناحیه فرنل آزاد نیست.",
  "visible": false, "distance_m": 11700, "min_clearance": {"distance_m": 5300, "clearance_m": -23.3}, "fresnel_clear": false
}

نیمرخ زمین و پرتو در profile برمی‌گردد. انحنای زمین لحاظ شده و با frequency_mhz ناحیه فرنل لینک رادیویی هم بررسی می‌شود.

منبع داده

پوشش زمین: ESA WorldCover 2021؛ خورشید: Global Solar Atlas؛ باد: Global Wind Atlas؛ بارش: CHIRPS؛ اقلیم: WorldClim و CMIP6؛ ارتفاع: SRTM. همه با مجوز آزاد (CC BY 4.0 یا مالکیت عمومی).

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

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