برای جستجوی نام خیابانها، نامهای قدیمی، اماکن و کسب و کارهای ثبتشده بر روی نقشه (Location Based Search API) میتوانید از وبسرویس جستجوی نشان استفاده کنید. این وبسرویس بهترین نتایج ممکن را با توجه به نقطهی مرجع (طول و عرض جغرافیایی مکانی که جستجو بایستی حول آن انجام شود) در اختیار شما قرار میدهد. در پاسخ به هر درخواست جستجو حداکثر ۳۰ نتیجهی مرتبط توسط وبسرویس برگردانده میشود.
وب سرویس جستجوی مکان محور نقشه نشان یکی از کاملترین سرویسهای جستجو مبتنی بر موقعیت ایرانی میباشد.
این سرویس با پشتیبانی کامل از زبان فارسی و نگارشهای مختلف از حروف فارسی، با توجه به موقعیت جغرافیایی مورد نظر شما (نقطه مرجع)
بهترین نتایج را به صورت مرتبشده بر اساس فاصله تا آن نقطه مرجع در پاسخ باز میگرداند.
نقطه مرجع در این سرویس میتواند موقعیت جاری کاربر یا مرکز نقشهای که کاربر مشاهده میکند باشد. این نقطه باید بهصورت طول و عرض جغرافیایی
(Latitude & Longitude)
ارسال گردد.
پارامتر نقطهی مرجع به شما کمک میکند نتایج بهتری را در خروجی داشته باشید. با توجه به معماری سرویس جستجوی مکانمحور نشان، شما محدودیتی در دریافت نتایج بسیار دور از نقطهی مرجع (به عنوان مثال در شهری دیگر) را نیز نخواهید داشت. این نقطه میتواند مکان جغرافیایی کاربر نهایی شما یا مرکز نقشهای که مشاهده میکند باشد.
GET:
https://api.neshan.org/v1/search?term=YOUR_SEARCH_TERM&lat=LATITUDE&lng=LONGITUDE
Headers:
Api-Key: YOUR_API_KEY
{
"count": 1,
"items": [
{
"title": "حرم مطهر امام رضا (ع)",
"address": "مشهد، خراسان رضوی",
"neighbourhood": "حرم مطهر",
"region": "مشهد، خراسان رضوی",
"type": "religious",
"category": "place",
"location": {
"x": 59.6157432,
"y": 36.2880443
}
}
]
}