موقعیت مکانی (Location)
مقدمه
در اکوسیستم دیوار، موقعیت مکانی یا Location یکی از اجزای اساسی و مهم هر آگهی محسوب میشود. این مفهوم در پلتفرم کنار دیوار نیز با همان اهمیت و ساختار وجود دارد. این مستند به منظور آشنایی توسعهدهندگان با جزئیات و ویژگیهای خاص موقعیت مکانی در پلتفرم کنار تهیه شده است.
ساختار سلسله مراتبی موقعیت مکانی
در پلتفرم دیوار، موقعیت مکانی دارای ساختار سلسله مراتبی (Hierarchical Structure) است که شامل سه سطح اصلی میباشد:
استان (Province) > شهر (City) > منطقه (District)
مثال:
تهران > تهران > جنت آباد
اصفهان > اصفهان > خیابان چهارباغ
خراسان رضوی > مشهد > احمدآباد
شناسه شهر (City Slug)
در پلتفرم کنار دیوار، شناسه اصلی که برای کار با موقعیت مکانی استفاده میشود، شناسه شهر یا City Slug است. این شناسه یک رشته متنی منحصر به فرد برای هر شهر میباشد.
مشخصات فنی شناسه شهر:
- فرمت: رشته متنی با حروف کوچک انگلیسی، اعداد و خط تیره (
[a-z0-9-]
) - مثالها:
tehran
،isfahan
،mashhad
،shiraz
- پایداری: شناسه شهرها معمولاً تغییر نمیکنند و پایدار هستند
سطوح موقعیت مکانی
۱. استان (Province)
- کاربرد: در پلتفرم کنار معمولاً مستقیماً با استان کار نمیکنیم
- دلیل: اکثر عملیات و جستجوها در سطح شهر انجام میشود
۲. شهر (City)
- اهمیت: اصلیترین سطح موقعیت مکانی در پلتفرم کنار
- شناسه: هر شه ر دارای شناسه منحصر به فرد (City Slug) است
- پایداری: شهرها معمولاً تغییر نمیکنند و پایدار هستند
- نقش: اساس فیلترینگ و جستجوی آگهیها
۳. منطقه (District)
- وجود: همه شهرها منطقه ندارند
- تغییرپذیری: مناطق ممکن است در طول زمان تغییر کنند، اضافه یا حذف شوند
- کاربرد: برای فیلترینگ دقیقتر آگهیها در شهرهای بزرگ
اطلاعات موقعیت مکانی در پاسخ آگهی
در پاسخ آگهی، اطلاعات موقعیت مکانی به صورت زیر بازگردانده میشود:
{
"business_data": {
"business_name": "string",
"business_type": "CAR"
},
"category": "string",
"chat_enabled": true,
"city": "string",
"data": {},
"district": "string",
"first_published_at": "2024-07-29T15:51:28.071Z",
"is_phone_hidden": true,
"state": "PUBLISHED",
"supplier_chat_assistant_enabled": true,
"token": "string"
}