تابع PLACES_COUNT_PER_TYPE

تابع PLACES_COUNT_PER_TYPE جدولی از تعداد را برای هر نوع مکان مشخص شده برای تابع برمی گرداند. به عنوان مثال، اگر انواع doctor ، hospital و pharmacy را جستجو کنید، پاسخ حاوی یک جدول با یک ردیف جداگانه برای هر نوع است.

از آنجایی که تابع PLACES_COUNT_PER_TYPE یک جدول را برمی گرداند، آن را با استفاده از یک عبارت FROM فراخوانی کنید.

  • پارامترهای ورودی:

    • مورد نیاز : پارامتر فیلتر geography که ناحیه جستجو را مشخص می کند. پارامتر geography مقداری را می گیرد که توسط نوع داده BigQuery GEOGRAPHY تعریف شده است که از نقاط، رشته های خطی و چند ضلعی ها پشتیبانی می کند.

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

    • مورد نیاز : پارامتر فیلتر types که انواع مکان را برای جستجو مشخص می کند.

    • اختیاری : پارامترهای فیلتر اضافی برای اصلاح جستجوی شما.

  • برمی گرداند:

    • جدولی با یک ردیف در هر types . این جدول شامل type ستون‌ها ( STRING )، count ( INT64 ) و place_ids ( ARRAY<STRING> ) است که place_ids حاوی حداکثر 250 شناسه مکان برای هر type است.

مثال: تعداد برگشت رستوران، کافه، و بار

در این مثال، تمام رستوران‌ها، کافه‌ها و بارهای عملیاتی را در ناحیه جستجوی مشخص شده که به عنوان چند ضلعی در شهر نیویورک تعریف شده است، جستجو می‌کنید.

پارامتر types آرایه ای از مقادیر STRING را می گیرد که انواع مکان های جستجو را مشخص می کند. برای فهرست کامل مقادیر ممکن، انواع مکان را ببینید.

این مثال همچنین از تابع BigQuery ST_GEOGFROMTEXT برای برگرداندن مقدار GEOGRAPHY از یک چند ضلعی استفاده می کند.

DECLARE geo GEOGRAPHY;
SET geo = ST_GEOGFROMTEXT('''POLYGON((-73.985708 40.75773,-73.993324 40.750298,
                                      -73.9857 40.7484,-73.9785 40.7575,
                                      -73.985708 40.75773))''');  -- NYC viewport

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'types', ["restaurant", "cafe", "bar"],
      'geography', geo,
      'business_status', ['OPERATIONAL']
      )
);

این تابع یک جدول با سه ردیف، یکی در هر نوع، برمی گرداند:

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