دالة PLACES_COUNT_PER_GEO

تأخذ الدالة PLACES_COUNT_PER_GEO مصفوفة من المناطق الجغرافية للبحث فيها وتعرض جدولاً بعدد الأماكن في كل منطقة. على سبيل المثال، إذا حدّدت مصفوفة من الرموز البريدية كمنطقة البحث، سيتضمّن الردّ جدولاً يحتوي على صف منفصل لكل رمز بريدي.

بما أنّ الدالة PLACES_COUNT_PER_GEO تعرض جدولاً، يمكنك استدعاؤها باستخدام عبارة FROM.

• مَعلمات الإدخال:

  • مطلوبة: geographies مَعلمة الفلتر التي تحدّد منطقة البحث. تأخذ المَعلمة geographies مصفوفة من القيم المحدّدة بواسطة نوع بيانات GEOGRAPHY في BigQuery، والذي يتيح استخدام النقاط والسلاسل الخطية والمضلّعات.

  • اختياري: مَعلمات فلتر إضافية لتحسين البحث

• المرتجعات:

  • جدول يحتوي على صف واحد لكل منطقة جغرافية يحتوي الجدول على الأعمدة geography (GEOGRAPHY) وcount (INT64) وplace_ids (ARRAY<STRING>) حيث يحتوي place_ids على ما يصل إلى 250 رقم تعريف مكان لكل منطقة جغرافية.

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

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

يستخدم هذا المثال مجموعة البيانات العامة في 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"]
      )
);

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

يستخدم المثال التالي فلتر 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. تظهر الخريطة الممتلئة كما هو موضح أعلاه. يمكنك اختياريًا تحديد أنواع الرسوم البيانية -> الأنماط لضبط مظهر الخريطة بشكل أكبر.

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