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