کشف محلی را با Nearby Search (جدید) API بهبود دهید

در این سند، نحوه استفاده از Nearby Search (جدید) API برای ساخت یک ساده و مقرون به صرفه را بررسی خواهید کرد.

تجربه کشف محلی

یک تجربه اکتشافی محلی به کاربران مکان‌های کلیدی مورد علاقه نزدیک مکانی را که هنگام جستجوی هتل یا ملک مشخص می‌کنید نشان می‌دهد. اغلب از یک نقشه تعاملی، با یک پانل اضافی شامل یک انتخابگر مکان و یک گالری عکس تشکیل شده است. محصولات و قابلیت‌های مختلف پلتفرم Google Maps به شما ارائه می‌شود تا تجربه را با تعامل افزایش دهید.

نمونه کشف محلی

موارد استفاده

حال بیایید بفهمیم چه عناصری از یکپارچه سازی اکتشاف محلی ارزش کاربر را هدایت می کند:

  • کشف - با نمایاندن مکان‌های مرتبط از انواع مختلف، به کاربران یک نمای کلی از آنچه در اطراف یک مکان وجود دارد ارائه دهید.

  • تعامل - به کاربران امکان می دهد مکان را انتخاب کنند و داده ها را به صورت پویا تازه کنند

    نسبت به آن مکان

  • تجسم - بررسی مکان ها، عکس ها را ارائه دهید

    و زمان و مسافت پیاده روی را برای کاربران به سرعت درک می کنند که آیا با نیازهای آنها مطابقت دارد یا خیر.

معماری مرجع

alt_text

کشف محلی

راه های زیادی برای ایجاد یک تجربه کشف محلی وجود دارد. ادغام زیر نمونه ای سفارشی از یک تجربه کاربری است که از API های شناخته شده پلتفرم نقشه های گوگل و همچنین برخی از ویژگی های جدید هیجان انگیز استفاده می کند. اگر می خواهید یک رویکرد قالبی برای کشف محلی داشته باشید، می توانید از Web Components استفاده کنید.

نمونه برنامه

نمونه راهنما

در جدول زیر می‌توانید نمونه برنامه‌ای را که به مراحل مختلف تقسیم شده است، همراه با توضیحی درباره پیاده‌سازی فنی با APIهای پلتفرم Google Maps مشاهده خواهید کرد.

1. جستجوی مکان با AutocompleteSearch مکان

  • API جاوا اسکریپت Maps را بارگیری کنید.
  • پرس و جو تکمیل خودکار یا انتخاب مکان را روی نقشه قرار می دهد .

نمونه تکمیل خودکار

2. نقاط محلی مورد علاقه را با استفاده از Nearby Search (جدید) API نمایان کنید

  • رتبه بندی محبوبیت (نتایج مرتبط تر) یا رتبه بندی فاصله.
  • includedTypes , excludedTypes ; اگر شما یک هتل هستید، می توانید نوع اقامت را حذف کنید و فقط انواع مناسب را شامل شود، به عنوان مثال: "رستوران، کافه، پارک، جاذبه_ تور".
  • اهرم includedPrimaryTypes ، excludedPrimaryTypes برای کنترل بیشتر بر نتایج.
  • `محدودیت مکان برای جلوگیری از تعداد ناکافی نتایج یا مکان های بسیار دور. در صورت صفر بودن نتایج، اندازه دایره / مستطیل را قبل از نمایش نتایج، بزرگ کنید.

نمونه مکان های نزدیک

نمونه پرس و جو هنگام رزرو هتل با فیلدهای داده درخواست شده:

  • پایه ( displayName ، types ، openingHours ، formattedAddress )
  • تماس ( websiteUri , nationalPhoneNumber , internationalPhoneNumber )
  • برگزیده ( reviews ، priceLevel ، userRatingCount ) 
 { "includedTypes": ["restaurant","cafe","park"], "excludedTypes":
["lodging","convenience_store"], "includedPrimaryTypes":
["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes":
["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": {
"center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }

نمونه پرس و جو هنگام جستجوی یک ملک با فیلدهای داده درخواست شده:

  • پایه ( displayName ، types ، openingHours ، formattedAddress ) 
 { "includedTypes": ["school","transport","bus","convenience_store"],
"excludedTypes": ["lodging"], "includedPrimaryTypes":
["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes":
["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": {
"center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }

3. تعامل را با Dynamic Maps and Directions API اضافه کنید

  • بخش و مراحل به‌روز با پرس و جوی Directions API . * از زمان در بخش بعدی استفاده کنید.

جهت نمونه

4. نمایش اطلاعات دقیق از مکان پس از تعامل

  1. توضیحات : displayName , types , rating , userRatingCount , priceLevel .

    زمان : از جستار قبلی Directions API.

  2. نظرات : reviews[i].author ، reviews[i].rating ، reviews[i].text .

  3. تصاویر : در طول پیش‌نمایش نامحدود Nearby Search (جدید) API ، باید جزئیات مکان‌ها را با place.id پرس و جو کنید تا photo_reference را دریافت کنید و سپس در تجربه خود یکی یکی پرس و جو کنید.

جزئیات مکان ها

تعداد پرس و جوها و هزینه مرتبط

  • Maps JavaScript API : 1 نقشه در بارگیری تجربه.
  • API تکمیل خودکار مکان‌ها: هر نویسه تایپ شده را ۱ پرس و جو کنید (در صورت استفاده از ویجت تکمیل خودکار )، می‌توان آن را سفارشی کرد.
  • Nearby Search (جدید) API : 1 پرس و جو در هر 20 مکان نمایش داده می شود. صورت‌حساب متفاوت با توجه به داده‌های مکان که بخشی از پاسخ پرس و جو هستند.
  • Directions API : 1 پرس و جو در هر مکان انتخاب شده توسط کاربر.
  • Place Photo API : 1 پرس و جو برای هر عکس نمایش داده می شود.

نتیجه گیری

تجربه کشف محلی یک راه قدرتمند برای ارائه ارزش کاربر است. این پیاده‌سازی نمایشی دارای ویژگی‌های زیادی است که احتمالاً هنگام ایجاد چنین تجربه‌ای در پلتفرم Google Maps با قابلیت‌های ویژه از Nearby Search (جدید) API شامل می‌شود.

مراحل بعدی

پیشنهاد مطالعه بیشتر:

مشارکت کنندگان

نویسندگان اصلی:

توماس آنگلرت | مهندس راه حل های پلتفرم نقشه های گوگل