این محصول یا ویژگی در Experimental (قبل از GA) است. محصولات و ویژگی‌های Pre-GA ممکن است پشتیبانی محدودی داشته باشند، و تغییرات در محصولات و ویژگی‌های pre-GA ممکن است با سایر نسخه‌های pre-GA سازگار نباشد. پیشنهادات قبل از GA تحت پوشش شرایط خاص سرویس پلتفرم Google Maps هستند. برای اطلاعات بیشتر، به توضیحات مرحله راه اندازی مراجعه کنید. برای آزمایش Places Insights ثبت نام کنید !

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

نمای کلی توابع تعداد مکان

توابع شمارش مکان راه دیگری برای پرس و جو از داده های Places موجود در Places Insights است. این توابع پرس و جوهای SQL از پیش تعریف شده هستند که در BigQuery اجرا می شوند و مکمل پرس و جوهای داده مکان هستند. تفاوت اصلی این است که توابع یک آستانه شمارش حداقل را اعمال نمی کنند، بلکه در عوض یک منطقه جستجوی حداقل را اعمال می کنند:

جستارهای مجموعه داده مکان فقط می توانند تعداد بالای 5 را برگردانند اما هیچ محدودیتی در اندازه منطقه جستجو اعمال نمی کنند.
توابع شمارش مکان ها می توانند هر تعداد از جمله 0 را برگردانند، اما حداقل منطقه جستجوی 40.0 متر در 40.0 متر (1600 متر ^مربع ) را اعمال می کنند.

ممکن است بخواهید از توابع شمارش مکان استفاده کنید اگر مهم است بدانید که یک پرس و جو هیچ نتیجه ای نمی دهد یا اگر باید تعداد مکان های کمتر از 5 را بدانید. به عنوان مثال، امکان برگرداندن تعداد کم برای موارد استفاده انتخاب سایت مهم است.

توابع و کشورها شمارش مکان پشتیبانی می شود

Places Insights از توابع زیر پشتیبانی می کند:

PLACES_COUNT : یک ردیف حاوی تعدادی مکان را برمی‌گرداند.
PLACES_COUNT_PER_TYPE : جدول BigQuery از تعداد مکان‌ها در هر نوع مکان را برمی‌گرداند.
PLACES_COUNT_PER_GEO : جدول BigQuery از تعداد مکان‌ها در هر جغرافیا را برمی‌گرداند.
PLACES_COUNT_PER_H3 : جدول BigQuery از تعداد مکان‌ها در هر سلول H3 را برمی‌گرداند.

همراه با تعداد مکان‌ها، توابع PLACES_COUNT_PER_TYPE ، PLACES_COUNT_PER_GEO ، و PLACES_COUNT_PER_H3 تا 250 شناسه مکان در هر عنصر پاسخ را برمی‌گردانند.

مشابه مجموعه داده‌های مکان‌ها، توابع شمارش مکان‌ها برای یک شهر برتر برای هر یک از کشورهای پشتیبانی‌شده در دسترس هستند. به عنوان مثال، برای استرالیا، می توانید به توابع شمارش مکان برای سیدنی، استرالیا دسترسی داشته باشید.

برای فهرست کامل شهرها و کشورهای پشتیبانی شده، به توابع شمارش مکان مرجع در BigQuery مراجعه کنید.

مثال تابع شمارش مکان

مثال زیر از تابع PLACES_COUNT برای برگرداندن تعداد رستوران های عملیاتی در 1000 متری ساختمان امپایر استیت در شهر نیویورک استفاده می کند:

SELECT `maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"]
      )
) as count;

پاسخ شامل یک تعداد واحد است:

نتایج برای تابع شمارش مکان در شهر نیویورک.

در این مثال دستور SELECT به تابع PLACES_COUNT برای ایالات متحده با استفاده از نحو ارجاع می دهد:

maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT

برای فهرست کامل شهرها و کشورهای پشتیبانی شده، به توابع شمارش مکان مرجع در BigQuery مراجعه کنید.

از JSON_OBJECT برای ارسال آرگومان ها به تابع استفاده کنید. این مثال از تابع BigQuery ST_GEOGPOINT برای برگرداندن یک مقدار GEOGRAPHY از یک نقطه و سپس ارسال آن مقدار به پارامتر geography استفاده می کند. همچنین شعاع جستجو در اطراف نقطه و نوع مکان، "restaurant" را برای جستجو می گذراند.

تعداد مکان در هر نوع، جغرافیایی یا نمونه H3

همراه با تعداد مکان‌ها، توابع PLACES_COUNT_PER_TYPE ، PLACES_COUNT_PER_GEO ، و PLACES_COUNT_PER_H3 نیز تا 250 شناسه مکان را برای مکان‌های موجود در پاسخ برمی‌گردانند.

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

فراخوانی تابع زیر تعدادی مکان را با انواع: restaurant ، cafe و bar برمی گرداند:

SELECT * FROM `maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'types', ["restaurant", "cafe", "bar"],
      'business_status', ['OPERATIONAL']
      )
);

این تابع یک جدول با سه ستون برمی گرداند: type ، count و sample_place_ids . ستون های count تعداد مکان ها را برای هر type نشان می دهد و ستون sample_place_ids تا 250 شناسه مکان را برای هر type نشان می دهد.

نتایج برای تابع نوع شمارش مکان در شهر نیویورک.

فیلترها را روی عملکرد اعمال کنید

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

SELECT `maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"],
      'min_rating', 1.3,
      'price_level', ['PRICE_LEVEL_INEXPENSIVE', 'PRICE_LEVEL_MODERATE'],
      'allows_dogs', TRUE
      )
) as count;

نتایج را تجسم کنید

ابزارهای تجزیه و تحلیل و هوش تجاری برای کمک به شما در کشف اطلاعات بینش از داده های BigQuery بسیار مهم هستند. BigQuery از چندین ابزار تجسم داده های Google و شخص ثالث پشتیبانی می کند که می توانید از آنها برای تجزیه و تحلیل نتایج عملکردهای خود در داده های Places Insights استفاده کنید.

برای مثالی از تجسم نتایج یک تابع، مشاهده نتایج را ببینید. برای اطلاعات بیشتر و مثال در مورد تجسم نتایج Places Insights، به مشاهده نتایج جستجو مراجعه کنید.

محدودیت ها و الزامات

توابع شمارش مکان دارای محدودیت ها و الزامات زیر است:

فقط COUNT اطلاعات بینش پشتیبانی می شود.
حداقل منطقه جستجو 40.0 متر در 40.0 متر (1600 متر ^مربع ) مورد نیاز است.
اندازه ورودی پارامتر تعداد تابع مکان به 1 مگابایت محدود است.
هیچ پشتیبانی برای فیلتر کردن بر اساس شناسه مکان یا جزء آدرس.

توابع شمارش مکان و پرس و جوهای مجموعه داده را مقایسه کنید

جدول زیر تفاوت های کلیدی را فهرست می کند:

	توابع شمارش مکان	پرس و جوهای مجموعه داده را قرار دهید
رابط	چهار تابع SQL از پیش تعریف شده که `COUNT` بینش ایجاد می کنند: تعداد تک، تعداد در هر نوع، تعداد در هر جغرافیا، تعداد در هر سلول H3.	از SQL برای اجرای توابع تجمع مانند `COUNT, COUNT_IF, SUM` و `AVG.` با استفاده از `JOIN, GROUP BY, WHERE` و موارد دیگر می‌توان اطلاعات بینش بیشتری ایجاد کرد.
محدودیت ها	حداقل منطقه جستجو 40.0 متر در 40.0 متر (1600 متر ^مربع ) را اعمال می کند. یک تابع نتیجه را برمی‌گرداند حتی اگر تعداد تجمع کمتر از 5 باشد تا زمانی که حداقل منطقه جستجو برآورده شده باشد.	آستانه شمارش 5 را اعمال می کند اما حداقل منطقه جستجو را ندارد.
فیلترهای ویژگی پشتیبانی شده	طرح کامل پشتیبانی می شود به جز: `id` مکان اجزای آدرس	طرح کامل پشتیبانی می شود
مزایا	می تواند هر تعداد را برگرداند. برای عملکرد و هزینه پردازش کم بهینه شده است. ساده برای استفاده. نیازی به نوشتن پرس و جوهای پیچیده نیست. پارامترهای ورودی را اعتبار سنجی می کند و یک خطا برمی گرداند که استفاده و اشکال زدایی آن را آسان تر می کند.	امکان پرس و جوهای پیچیده مانند فیلتر کردن پیشرفته و پیوستن را فراهم می کند. حداقل منطقه جستجو را اعمال نمی کند. از توابع مجموع اضافی فراتر از `COUNT` مانند `AVG` ، `SUM` و `GROUP BY` پشتیبانی می کند.

توابع شمارش مکان مرجع در BigQuery

توابع شمارش مکان از شهرها و کشورهای زیر پشتیبانی می کنند. شما باید در هر شهر و کشور جداگانه مشترک شوید .

شهر، کشور	نام جدول
سیدنی، استرالیا	`maps-platform-analytics-hub.sample_places_insights_au. FUNCTION_NAME`
سائوپائولو، برزیل	`maps-platform-analytics-hub.sample_places_insights_br. FUNCTION_NAME`
تورنتو، کانادا	`maps-platform-analytics-hub.sample_places_insights_ca. FUNCTION_NAME`
پاریس، فرانسه	`maps-platform-analytics-hub.sample_places_insights_fr. FUNCTION_NAME`
برلین، آلمان	`maps-platform-analytics-hub.sample_places_insights_de. FUNCTION_NAME`
لندن، بریتانیای کبیر	`maps-platform-analytics-hub.sample_places_insights_gb. FUNCTION_NAME`
بمبئی، هند	`maps-platform-analytics-hub.sample_places_insights_in. FUNCTION_NAME`
جاکارتا، اندونزی	`maps-platform-analytics-hub.sample_places_insights_id. FUNCTION_NAME`
رم، ایتالیا	`maps-platform-analytics-hub.sample_places_insights_it. FUNCTION_NAME`
توکیو، ژاپن	`maps-platform-analytics-hub.sample_places_insights_jp. FUNCTION_NAME`
مکزیکو سیتی، مکزیک	`maps-platform-analytics-hub.sample_places_insights_mx. FUNCTION_NAME`
مادرید، اسپانیا	`maps-platform-analytics-hub.sample_places_insights_es. FUNCTION_NAME`
زوریخ، سوئیس	`maps-platform-analytics-hub.sample_places_insights_ch. FUNCTION_NAME`
شهر نیویورک، ایالات متحده آمریکا	`maps-platform-analytics-hub.sample_places_insights_us. FUNCTION_NAME`