نمای کلی

API مربوط به Places Aggregate سرویسی است که بر اساس معیارهایی مانند موقعیت مکانی، نوع، وضعیت عملیاتی، سطح قیمت و رتبه‌بندی کاربران، بینش‌هایی در مورد مکان‌های موجود در یک منطقه مشخص ارائه می‌دهد. این سرویس می‌تواند به تجزیه و تحلیل تراکم انواع مکان‌های خاص در اطراف یک مکان مشخص کمک کند و به سؤالاتی مانند «چه یا چند رستوران $$$ با رتبه ۵ ستاره در شعاع ۵ کیلومتری این مکان وجود دارد؟» پاسخ دهد.

نتایج به صورت شمارش‌های تجمیعی یا شناسه‌های مکان شناسایی‌شده در منطقه مورد نظر جستجو بازگردانده می‌شوند. کاربران می‌توانند از API جزئیات مکان برای بازیابی اطلاعات بیشتر در مورد آن شناسه‌های مکان استفاده کنند.

چرا از Places Aggregate API استفاده کنیم؟

API Places Aggregate به کاربران شما این امکان را می‌دهد که بر اساس اطلاعات جامعی که شما در مورد مکان‌های مختلف ارائه می‌دهید، تصمیمات مبتنی بر داده بگیرند. این API از مدل‌های مکانی دقیق و به‌روز استفاده می‌کند که از موارد استفاده کلیدی زیر پشتیبانی می‌کند:

  • کسب و کارها : رقابت و مکان‌های بالقوه برای شعب جدید را تجزیه و تحلیل کنید.
  • توسعه‌دهندگان : برنامه‌هایی بسازید که توصیه‌های شخصی‌سازی‌شده ارائه می‌دهند.
  • محققان : روندها و الگوها را در حوزه‌های خاص بررسی می‌کنند.

کارهایی که می‌توانید با Places Aggregate API انجام دهید

با استفاده از API مربوط به Places Aggregate، می‌توانید اطلاعات زیر را دریافت کنید:

  • شمارش : تعداد مکان‌هایی که با معیارهای شما مطابقت دارند را بازیابی کنید.
  • شناسه‌های مکان‌ها : شناسه‌های مکان مکان‌های خاصی را که با معیارهای شما مطابقت دارند، بازیابی کنید.

همچنین می‌توانید از فیلتر کردن برای اصلاح جستجوی خود بر اساس ویژگی‌های مختلف مانند نوع مکان، ساعات کاری، سطح قیمت و رتبه‌بندی مشتریان استفاده کنید.

مثال‌ها

این بخش مثال‌هایی از کاربردهای Places Aggregate API را شرح می‌دهد و کد کاربردی هر مثال را نیز در بر می‌گیرد.

افتتاح یک کافه جدید

صاحب رستورانی می‌خواهد یک کافه جدید افتتاح کند. برای انجام این کار، ابتدا می‌خواهد نقاط کانونی کافه‌ها را تجسم کند تا بتواند مناطقی با تمرکز بالا و پایین را برای تصمیم‌گیری تجاری خود شناسایی کند. API Places Aggregate می‌تواند به تجزیه و تحلیل تعداد کافه‌ها در یک شعاع خاص بر اساس ویژگی‌هایی مانند وضعیت فعالیت، سطح قیمت و رتبه‌بندی مشتریان کمک کند تا تصمیمی مبتنی بر داده‌ها در مورد محل افتتاح شعبه بعدی خود بگیرد.

مشاهده نمونه

نقشه سانفرانسیسکو و امتیازات سرگرمی بر اساس کد پستی.

شرکت سرمایه‌گذاری املاک و مستغلات

یک شرکت سرمایه‌گذاری املاک و مستغلات می‌خواهد مدل‌های مالی خود را بهبود بخشد و بازگشت سرمایه (ROI) سرمایه‌گذاری‌های برنامه‌ریزی‌شده خود در املاک را به طور دقیق تعیین کند. با استفاده از API Places Aggregate، آنها می‌توانند داده‌های دقیقی در مورد امکانات رفاهی نزدیک املاک بالقوه برای سرمایه‌گذاری، مانند دستگاه‌های خودپرداز، بیمارستان‌ها، ایستگاه‌های حمل و نقل و فروشگاه‌های مواد غذایی، جمع‌آوری کنند تا بتوانند امکانات رفاهی نزدیک املاک بالقوه برای سرمایه‌گذاری را درک کنند.

خدمات تحویل خرده فروشی

هنگام گسترش به یک شهر جدید، یک سرویس تحویل خرده‌فروشی باید تعداد رانندگان تحویل را برای تخصیص به یک منطقه بر اساس تراکم مقاصد محبوب مصرف‌کنندگان، مانند رستوران‌ها، فروشگاه‌های رفاه و فروشگاه‌های مشروبات الکلی، تعیین کند. با استفاده از API، سرویس تحویل تعداد کل این مراکز را در سراسر شهر می‌شمارد تا بتواند منابع را به طور مؤثر برنامه‌ریزی و تخصیص دهد.

مشاهده نمونه

نقشه حرارتی رستوران‌ها بر اساس حجم بازدید در مانتین ویو.

نحوه عملکرد API Places Aggregate

API Places Aggregate به شما امکان می‌دهد فیلترهایی را برای محدود کردن معیارهای جستجوی خود تعیین کنید. پس از انتخاب نوع Insight از INSIGHT_COUNT یا INSIGHT_PLACES ، می‌توانید معیارهای فیلتر، از جمله موارد زیر را اضافه کنید:

  • مکان : منطقه مورد نظر را با استفاده از دایره‌ها، مناطق یا چندضلعی‌های سفارشی تعریف کنید.
  • نوع : انواع مکان‌هایی را که به آنها علاقه‌مند هستید مشخص کنید.
  • وضعیت عملیات : مکان‌ها را بر اساس وضعیت عملیاتی‌شان فیلتر کنید.
  • سطوح قیمت : مکان‌ها را بر اساس سطوح قیمت فیلتر کنید.
  • رتبه‌بندی‌ها : مکان‌ها را بر اساس رتبه‌بندی کاربران فیلتر کنید.

شیء ComputeInsightsResponse در پاسخ API شامل نتایج درخواست Insight است. برای مثال، اگر INSIGHT_COUNT انتخاب کرده باشید، پاسخ شامل تعداد کل مکان‌ها است و اگر INSIGHT_PLACES انتخاب کرده باشید، پاسخ شامل لیستی از شناسه‌های مکان‌ها است.

نحوه استفاده از API Places Aggregate

۱ آماده شوید. با راه‌اندازی پروژه Google Cloud خود شروع کنید و دستورالعمل‌های بعدی را تکمیل کنید.
۲ درخواستی برای دریافت تعداد مکان‌های منطبق ارسال کنید. به «اولین درخواست خود را انجام دهید» مراجعه کنید.
۳ آشنایی با پارامترهای درخواست به پارامترهای درخواست مراجعه کنید.

قدم بعدی چیست؟