دالة 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 على ما يصل إلى 250 رقم تعريف مكان لكل منطقة جغرافية.

مثال: حساب عدد المطاعم في كل مقاطعة من مقاطعات مدينة نيويورك

ينشئ هذا المثال جدولاً بأعداد المطاعم التي تعمل في كل مقاطعة من مقاطعات مدينة نيويورك.

يستخدِم هذا المثال مجموعة البيانات العامة public dataset في United States Census Bureau Data BigQuery للحصول على حدود المقاطعات الثلاث في مدينة نيويورك: "Queens" و"Kings" و"New York". تتضمّن حدود كل مقاطعة عمود 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، انقر على فتح في -> Looker Studio. يتم استيراد نتائجك تلقائيًا إلى Looker Studio.

3. ينشئ Looker Studio صفحة تقرير تلقائية ويضبطها بعنوان وجدول ورسم بياني شريطي للنتائج.

   

4. اختَر كل العناصر في الصفحة واحذفها.

5. انقر على إدراج - > خريطة ملوّنة لإضافة خريطة ملوّنة إلى تقريرك.

6. ضمن أنواع الرسوم البيانية -> الإعداد ، اضبط الحقول كما هو موضّح أدناه:

   

7. تظهر الخريطة الملوّنة كما هو موضّح أعلاه. يمكنك اختياريًا النقر على أنواع الرسوم البيانية -> الأنماط لضبط مظهر الخريطة بشكلٍ أكبر.

لمزيد من المعلومات والمثال عن عرض نتائج "إحصاءات الأماكن"، راجِع عرض نتائج طلب البحث.