پرش به محتوا

آدرس هوشمند

متن آزاد آدرس (از پیامک، تلگرام یا فرم سفارش) را به اجزا و مختصات تبدیل کنید.

POST https://api.uttamap.ir/v1/ai/address

curl -X POST https://api.uttamap.ir/v1/ai/address -H "X-Api-Key: um_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"text":"سلام ببخشید آدرس: تبریز ولیعصر توانیر جنوبی نرسیده به فلکه بعد بانک ملت کوچه نسترن پ ۱۲ ط ۲","city_hint":"تبریز"}'
فیلد ورودیتوضیح
textمتن آدرس، حداکثر ۱۰۰۰ نویسه (الزامی)
city_hintشهر پیش‌فرض اگر در متن نیامده باشد
near[lat, lng] برای اولویت نتایج نزدیک
{
  "location": { "lat": 38.0571, "lng": 46.3612 },
  "precision": "street",
  "confidence": 0.8,
  "components": {
    "province": "آذربایجان شرقی",
    "city": "تبریز",
    "district": "ولیعصر",
    "street": "خیابان توانیر جنوبی",
    "alley": "نسترن",
    "plaque": "۱۲",
    "unit": "طبقه ۲",
    "landmarks": ["بانک ملت", "فلکه"]
  },
  "formatted": "تبریز، ولیعصر، خیابان توانیر جنوبی، کوچه نسترن، پلاک ۱۲، طبقه ۲",
  "ai": true,
  "powered_by": "uttapen"
}

precision چه می‌گوید

مقدارمعنی
buildingروی خود مکانی که در متن آمده (مثلاً «شرکت …» یا «بانک …»)
alleyسرِ کوچهٔ ذکرشده
streetروی خیابان؛ اگر خیابان قبلی هم آمده باشد، سرِ تقاطع آن دو
landmarkکنار نشانهٔ ذکرشده
district / cityفقط محله یا شهر پیدا شد
noneپیدا نشد؛ components باز هم پر است

components همیشه همهٔ اجزای استخراج‌شده از متن را دارد، حتی وقتی روی نقشه پیدا نشده باشند. با آن فرم آدرس مشتری را خودکار پر کنید و فقط نقطه را از او تأیید بگیرید.

حریم خصوصی و هزینه

  • متن آدرس ذخیره نمی‌شود. شماره‌های موبایل داخل متن پیش از پردازش پوشانده می‌شوند.
  • سهمیهٔ آدرس هوشمند جدا از سهمیهٔ درخواست‌هاست (۱۰۰ در ماه در پلن رایگان).
  • اگر سرویس هوش مصنوعی لحظه‌ای در دسترس نباشد، پاسخ با جستجوی معمولی ساخته می‌شود، ai برابر false است و فقط یک جستجوی معمولی حساب می‌شود.

آدرس هوشمند — قدرت‌گرفته از یوتاپن.