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

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

• پرس‌وجوهای مجموعه داده‌های مکانی فقط می‌توانند تعداد بالاتر از ۵ را برگردانند، اما هیچ محدودیتی در اندازه ناحیه جستجو اعمال نمی‌کنند.

• توابع شمارش مکان می‌توانند هر تعداد عددی، از جمله صفر، را برگردانند، اما حداقل مساحت جستجو را ۴۰.۰ متر در ۴۰.۰ متر (۱۶۰۰ متر ^مربع ) اعمال می‌کنند.

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

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

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 نیز تا ۲۵۰ شناسه مکان را برای هر عنصر از پاسخ برمی‌گردانند.

شناسه‌های مکان را می‌توان با موارد زیر استفاده کرد:

• API مکان‌ها (جدید)
• API کدگذاری جغرافیایی
• کیت رابط کاربری مکان‌ها

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

نوشتن کوئری با توابع

اگر هنگام تنظیم Places Insights نام مجموعه داده پیوند شده را تغییر داده‌اید، از نام دلخواه خود به جای نام‌های پیش‌فرض جدول که در اینجا فهرست شده‌اند استفاده کنید. همچنین می‌توانید به صورت اختیاری نام پروژه خود را نیز وارد کنید. اگر نامی وارد نشود، کوئری به طور پیش‌فرض روی پروژه فعال اجرا می‌شود. برای مثال [project name].[dataset name].places_sample.PLACES_COUNT .

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

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

SELECT `PROJECT_NAME.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 برای ایالات متحده ارجاع می‌دهد:

PROJECT_NAME.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 نیز تا ۲۵۰ شناسه مکان را برای مکان‌های موجود در پاسخ برمی‌گردانند.

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

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

SELECT * FROM `PROJECT_NAME.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 تا ۲۵۰ شناسه مکان را برای هر type نشان می‌دهد.

اعمال فیلترها روی تابع

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

SELECT `PROJECT_NAME.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 از چندین ابزار تجسم داده‌های گوگل و شخص ثالث پشتیبانی می‌کند که می‌توانید از آنها برای تحلیل نتایج توابع خود در داده‌های Places Insights استفاده کنید.

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

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

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

• فقط بینش‌های COUNT پشتیبانی می‌شوند.
• حداقل مساحت جستجو ۴۰ متر در ۴۰ متر (۱۶۰۰ متر ^مربع ) مورد نیاز است.
• اندازه ورودی پارامتر شمارش تابع، حداکثر ۱ مگابایت است.
• از فیلتر کردن بر اساس شناسه مکان یا مؤلفه آدرس پشتیبانی نمی‌کند.

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

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

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

توابع شمارش مکان از شهرها ( مجموعه داده نمونه ) و کشورهای ( مجموعه داده کامل ) زیر پشتیبانی می‌کنند. شما باید به طور جداگانه در هر شهر و کشور مشترک شوید .

داده‌های نمونه

داده‌های کامل