دالة 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"]
      )
);

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

يستخدِم المثال التالي فلتر brand_ids لاسترداد أعداد الأماكن ونماذج أرقام تعريف الأماكن لعلامات تجارية معيّنة، مثل Starbucks "1413758728321880760"

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,
      'brand_ids', ["1413758728321880760"], -- Filter for Starbucks
      'business_status', ["OPERATIONAL"]
      )
);

عرض النتائج

تعرض الصورتان التاليتان هذه البيانات في Looker Studio كخريطة ملوّنة، بما في ذلك الخطوط الخارجية لكل مقاطعة:

لاستيراد بياناتك إلى Looker Studio:

1. شغِّل الدالة أعلاه لإنشاء النتائج.

2. في نتائج BigQuery، انقر على فتح في -> Looker Studio. يتم استيراد نتائجك تلقائيًا إلى Looker Studio.

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

   

4. اختَر كل محتوى الصفحة واحذفه.

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

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

   

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

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