Places Aggregate API سرویسی است که بر اساس معیارهایی مانند مکان، نوع، وضعیت عملیاتی، سطح قیمت و رتبه‌بندی کاربران، اطلاعاتی درباره مکان‌ها در یک منطقه مشخص ارائه می‌کند. این سرویس می‌تواند به تجزیه و تحلیل تراکم انواع مکان‌های خاص در اطراف یک مکان معین کمک کند و به سؤالاتی مانند "چه تعداد یا چند رستوران با رتبه 5 $$$ در شعاع 5 کیلومتری این مکان قرار دارند؟"
نتایج به‌عنوان تعداد انبوه یا شناسه‌های مکان شناسایی‌شده در ناحیه جستجوی مورد علاقه برگردانده می‌شوند. کاربران می‌توانند از API جزئیات مکان برای بازیابی اطلاعات بیشتر درباره شناسه‌های مکان استفاده کنند.
چرا از Places Aggregate API استفاده کنید
Places Aggregate API به کاربران شما این امکان را می‌دهد تا بر اساس اطلاعات جامعی که در مورد مکان‌های مختلف ارائه می‌دهید، تصمیمات مبتنی بر داده اتخاذ کنند. از مدل‌های مکان دقیق و به‌روز استفاده می‌کند که موارد استفاده کلیدی زیر را پشتیبانی می‌کند:
- مشاغل : رقابت و مکان های بالقوه برای شعب جدید را تجزیه و تحلیل کنید.
- توسعه دهندگان : برنامه هایی بسازید که توصیه های شخصی را ارائه می دهند.
- محققان : روندها و الگوها را در مناطق خاص بررسی کنید.
کارهایی که می توانید با Places Aggregate API انجام دهید
با Places Aggregate API، می توانید اطلاعات زیر را دریافت کنید:
- شمارش : تعداد مکان هایی را که با معیارهای شما مطابقت دارند بازیابی کنید.
- شناسه‌های مکان‌ها : شناسه‌های مکان مکان‌های خاصی را که با معیارهای شما مطابقت دارند، بازیابی کنید.
همچنین می‌توانید از فیلتر برای اصلاح جستجوی خود بر اساس ویژگی‌های مختلف مانند انواع مکان، ساعات کار، سطح قیمت و رتبه‌بندی مشتریان استفاده کنید.
نمونه ها
این بخش موارد مثال استفاده را برای Places Aggregate API توصیف می کند و شامل کدهای کاری برای هر نمونه است.
افتتاح یک کافه جدید
یک صاحب رستوران می خواهد یک کافه جدید باز کند. برای انجام این کار، آنها ابتدا می‌خواهند مکان‌های داغ کافه‌ها را تجسم کنند تا بتوانند مناطق با تمرکز بالا و پایین را برای اطلاع از تصمیم تجاری خود شناسایی کنند. Places Aggregate API می‌تواند به تجزیه و تحلیل تعداد کافه‌ها در یک شعاع خاص بر اساس ویژگی‌هایی مانند وضعیت عملیات، سطح قیمت و رتبه‌بندی مشتریان کمک کند تا براساس داده‌ها تصمیم بگیرید که مکان بعدی خود را کجا باز کنید.
شرکت سرمایه گذاری املاک و مستغلات
یک شرکت سرمایه گذاری در املاک و مستغلات می خواهد مدل های مالی خود را بهبود بخشد و با دقت ROI سرمایه گذاری های ملکی برنامه ریزی شده خود را تعیین کند. با استفاده از Places Aggregate API، آنها می‌توانند داده‌های دقیقی را در مورد امکانات موجود در نزدیکی دارایی‌های سرمایه‌گذاری بالقوه، مانند دستگاه‌های خودپرداز، بیمارستان‌ها، ایستگاه‌های حمل‌ونقل، و فروشگاه‌های مواد غذایی جمع‌آوری کنند تا بتوانند امکانات نزدیک به املاک سرمایه‌گذاری بالقوه را درک کنند.
خدمات تحویل خرده فروشی
هنگام گسترش به یک شهر جدید، یک سرویس تحویل خرده‌فروشی باید تعداد رانندگان تحویل را برای تخصیص به یک منطقه بر اساس تراکم مقصدهای محبوب مصرف‌کننده، مانند رستوران‌ها، فروشگاه‌های رفاه و مشروب‌فروشی‌ها تعیین کند. با استفاده از API، سرویس تحویل، تعداد کل این مؤسسات را در سراسر شهر شمارش می‌کند تا بتوانند منابع را به طور مؤثر برنامه‌ریزی و تخصیص دهند.
نحوه عملکرد Places Aggregate API
Places Aggregate API به شما امکان می دهد فیلترهایی را برای محدود کردن معیارهای جستجوی خود تعیین کنید. پس از انتخاب نوع Insight از INSIGHT_COUNT یا INSIGHT_PLACES ، می‌توانید معیارهای فیلتر را اضافه کنید، از جمله موارد زیر:
- مکان : ناحیه مورد نظر را با استفاده از دایره ها، مناطق یا چند ضلعی های سفارشی تعریف کنید.
- نوع : انواع مکان‌هایی را که به آنها علاقه دارید مشخص کنید.
- وضعیت عملیات : مکان ها را بر اساس وضعیت عملیاتی آنها فیلتر کنید.
- سطوح قیمت : مکان ها را بر اساس سطوح قیمت فیلتر کنید.
- رتبه‌بندی : مکان‌ها را بر اساس رتبه‌بندی کاربران فیلتر کنید.
شیء پاسخ API ComputeInsightsResponse حاوی نتایج بینش درخواست است. برای مثال، اگر INSIGHT_COUNT را انتخاب کرده باشید، پاسخ شامل تعداد کل مکان است، و اگر INSIGHT_PLACES را انتخاب کرده باشید، پاسخ حاوی لیستی از شناسه‌های مکان است.
نحوه استفاده از Places Aggregate API
| 1 | راه اندازی شود. | با راه اندازی پروژه Google Cloud خود شروع کنید و دستورالعمل های زیر را تکمیل کنید. |
| 2 | برای دریافت تعداد مکان‌های منطبق، درخواست دهید. | به اولین درخواست خود مراجعه کنید. |
| 3 | با پارامترهای درخواست آشنا شوید. | پارامترهای درخواست را ببینید. |
بعدش چی
- محدودیت های قیمت و استفاده را بررسی کنید
- مرجع API را مشاهده کنید
- سوالات متداول را مرور کنید
- گزینه های پشتیبانی را بررسی کنید