آدرس هوشمند
متن آزاد آدرس (از پیامک، تلگرام یا فرم سفارش) را به اجزا و مختصات تبدیل کنید.
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است و فقط یک جستجوی معمولی حساب میشود.
آدرس هوشمند — قدرتگرفته از یوتاپن.