توصیف هوشمند مکان با هوش مصنوعی

این سرویس همه اطلاعات مکانی یک نقطه یا محدوده را جمع می‌کند — آدرس، ارتفاع، نقاط مهم اطراف، فاصله تا مراکز، نزدیک‌ترین شهر، شاخص دسترسی به خدمات و برای محدوده‌ها کاربری غالب اراضی — و به یک مدل زبانی می‌دهد تا یک توصیف روان و قابل‌فهم بنویسد. مدل فقط از داده‌های داده‌شده استفاده می‌کند و اطلاعات نمی‌سازد.

کاربردها

• تولید خودکار متن معرفی ملک در آگهی‌ها
• گزارش‌های کارشناسی و امکان‌سنجی
• دستیارهای هوشمند و چت‌بات‌های مکانی

دریافت توکن

1. وارد داشبورد ژئوتاژک کلود شوید و با خرید بسته ژئوکوین کیف پول خود را شارژ کنید (با تایید شماره موبایل، ۲۰۰ هزار ژئوکوین هدیه می‌گیرید).
2. در بخش توکن‌های API یک توکن بسازید، دسترسی «توصیف هوشمند مکان با هوش مصنوعی» را به آن بدهید و بخشی از موجودی کیف پول را به آن اختصاص دهید.
3. کلید توکن را کپی کنید و در هدر Authorization بفرستید.

هزینه هر درخواست در صفحه سرویس‌ها درج شده و از اعتبار همان توکن کم می‌شود؛ خرید جداگانه برای هر سرویس لازم نیست.

آدرس سرویس

POST https://cloud.geotajak.ir/api/geo/describe

توکن را در هدر Authorization بفرستید:

Authorization: Bearer YOUR_TOKEN

(هدر X-API-Key: YOUR_TOKEN یا پارامتر ?api_key=YOUR_TOKEN هم پذیرفته می‌شود.)

بدنه درخواست (JSON)

فقط یکی از سه حالت نقطه، polygon یا line را بفرستید. توجه کنید ترتیب مختصات در این سرویس‌ها [lat, lon] است (نه [lon, lat] مانند GeoJSON). | language | متن | زبان خروجی: fa فارسی یا en انگلیسی |

نمونه درخواست

cURL

curl -X POST "https://cloud.geotajak.ir/api/geo/describe" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"lat": 35.6892, "lon": 51.389, "radius_m": 800, "language": "fa"}'

Python

import requests

TOKEN = "YOUR_TOKEN"
resp = requests.post(
    "https://cloud.geotajak.ir/api/geo/describe",
    json={"lat": 35.6892, "lon": 51.389, "radius_m": 800, "language": "fa"},
    headers={"Authorization": f"Bearer {TOKEN}"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
print("اعتبار باقی‌مانده توکن:", resp.headers.get("X-Credit-Remaining"))

JavaScript

const TOKEN = "YOUR_TOKEN";
const res = await fetch("https://cloud.geotajak.ir/api/geo/describe", {
  method: "POST",
  headers: { Authorization: `Bearer ${TOKEN}`, "Content-Type": "application/json" },
  body: JSON.stringify({"lat": 35.6892, "lon": 51.389, "radius_m": 800, "language": "fa"}),
});
const data = await res.json();
console.log(data, res.headers.get("X-Credit-Remaining"));

نمونه پاسخ

{
  "description": "این موقعیت در خیابان امام خمینی، منطقه ۱۱ مرکز تهران و در ارتفاع ۱۱۶۵ متری قرار دارد. در اطراف آن بانک‌ها، مدارس و فروشگاه‌های متعددی وجود دارد و ..."
}

هزینه و هدرهای پاسخ

هزینه هر درخواست موفق از اعتبار توکن کم می‌شود. در هر پاسخ این هدرها برگردانده می‌شوند:

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

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

خطاها

پاسخ خطا به این شکل است:

{"error": "insufficient_credit", "message": "اعتبار این توکن تمام شده است؛ از کیف پول خود به آن اعتبار اضافه کنید"}

نکته‌ها

• زمان پاسخ بین چند ثانیه تا حدود ۴۰ ثانیه است؛ timeout کلاینت را حداقل ۶۰ ثانیه بگذارید.
• برای محدوده‌ها polygon بفرستید تا کاربری اراضی هم در توصیف بیاید.

---

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