تابع PLACES_COUNT_PER_GEO

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

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

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

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

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

• بازده:

  • جدولی با یک ردیف برای هر منطقه جغرافیایی. این جدول شامل ستون‌های geography ( GEOGRAPHY )، count ( INT64 ) و place_ids ( ARRAY<STRING> ) است که place_ids شامل حداکثر ۲۵۰ شناسه مکان برای هر منطقه جغرافیایی است.

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

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

توجه: از آنجا که جدول پاسخ شامل یک فیلد geographies است، می‌توانید آن را با استفاده از ابزارهایی که از انواع BigQuery GEOGRAPHY پشتیبانی می‌کنند، تجسم کنید. برای مثالی از تجسم نتایج یک تابع، به Visualize results مراجعه کنید. برای اطلاعات بیشتر و مثالی در مورد تجسم نتایج Places Insights، به Visualize query results مراجعه کنید.

این مثال از مجموعه داده عمومی BigQuery اداره سرشماری ایالات متحده برای بدست آوردن مرزهای سه شهرستان در شهر نیویورک استفاده می‌کند: "کوئینز"، "کینگز"، "نیویورک". مرزهای هر شهرستان در ستون county_geom قرار دارد.

این مثال سپس از تابع BigQuery ST_SIMPLIFY برای برگرداندن یک نسخه ساده‌شده از county_geom استفاده می‌کند. تابع ST_SIMPLIFY زنجیره‌های تقریباً مستقیم از لبه‌ها را با یک لبه بلند جایگزین می‌کند.

DECLARE geos ARRAY<GEOGRAPHY>;

SET geos = (SELECT ARRAY_AGG(ST_SIMPLIFY(county_geom, 100))
            FROM `bigquery-public-data.geo_us_boundaries.counties`
            WHERE county_name IN ("Queens","Kings", "New York") AND state_fips_code = "36");

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_GEO`(
  JSON_OBJECT(
      'geographies', geos,
      'types', ["restaurant"],
      'business_status', ["OPERATIONAL"]
      )
);

پاسخ برای تابع:

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

تصاویر زیر این داده‌ها را که در Looker Studio به صورت یک نقشه پر شده نمایش داده می‌شوند، شامل طرح کلی هر شهرستان نشان می‌دهند:

برای وارد کردن داده‌ها به Looker Studio:

1. برای تولید نتایج، تابع بالا را اجرا کنید.

2. در نتایج BigQuery، روی Open in -> Looker Studio کلیک کنید. نتایج شما به طور خودکار به Looker Studio وارد می‌شوند.

3. Looker Studio یک صفحه گزارش پیش‌فرض ایجاد می‌کند و آن را با عنوان، جدول و نمودار میله‌ای نتایج مقداردهی اولیه می‌کند.

   

4. هر چیزی که در صفحه وجود دارد را انتخاب کرده و حذف کنید.

5. برای افزودن یک نقشه پر شده به گزارش خود، روی Insert -> Filled map کلیک کنید.

6. در قسمت انواع نمودار -> تنظیمات، فیلدها را مطابق شکل زیر پیکربندی کنید:

   

7. نقشه پر شده مانند بالا ظاهر می‌شود. می‌توانید به صورت اختیاری انواع نمودار -> سبک‌ها را برای پیکربندی بیشتر ظاهر نقشه انتخاب کنید.

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