دالة PLACES_COUNT_PER_GEO

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

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

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

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

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

• المرتجعات:

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

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

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

يستخدم هذا المثال بيانات مكتب الإحصاء الأمريكي مجموعة البيانات العامة في BigQuery للحصول على حدود المقاطعات الثلاث في مدينة نيويورك: "كوينز" و"كينغز" و"نيويورك". يتم تضمين حدود كل مقاطعة في العمود county_geom.

يستخدم هذا المثال بعد ذلك الدالة ST_SIMPLIFY في BigQuery لعرض نسخة مبسطة من 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 `places_insights___us___sample.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. يظهر الخريطة المملوءة كما هو موضح أعلاه. يمكنك اختياريًا النقر على أنواع الرسوم البيانية -> الأنماط لضبط مظهر الخريطة بشكلٍ أكبر.

لمزيد من المعلومات والأمثلة حول عرض نتائج Places Insights بشكل مرئي، يُرجى الاطّلاع على عرض نتائج طلب البحث بشكل مرئي.