دالة PLACES_COUNT_PER_H3

تأخذ الدالة PLACES_COUNT_PER_H3 منطقة جغرافية للبحث وتعرض جدولاً يتضمّن عدد الأماكن لكل خلية H3 في منطقة البحث.

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

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

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

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

  • مطلوبة: h3_resolution مَعلمة الفلتر التي تحدّد دقة H3 المستخدَمة لتجميع عدد الأماكن في كل خلية H3. تتراوح القيم المسموح بها بين 0 و8.

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

• المرتجعات:

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

مثال: عدد متاجر البقالة والمتاجر الصغيرة التي يمكن الوصول إليها باستخدام الكراسي المتحركة لكل خلية H3

يحسب المثال أدناه عدد المتاجر الصغيرة ومتاجر البقالة التي يمكن الوصول إليها بواسطة الكراسي المتحركة والتي تعمل في كل خلية H3 في مدينة نيويورك. تستخدم خلايا H3 مستوى دقة يبلغ 8.

يستخدم هذا المثال بيانات Overture Maps مجموعة البيانات المتاحة للجميع في BigQuery للحصول على الجغرافيا الخاصة بمدينة نيويورك.

DECLARE geo GEOGRAPHY;

-- Get the geography for New York City.
SET geo = (SELECT geometry FROM `bigquery-public-data.overture_maps.division_area`
  WHERE country = 'US' AND names.primary = 'City of New York'  LIMIT 1);

SELECT * FROM `maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT_PER_H3`(
  JSON_OBJECT(
      'geography', geo,
      'types', ["convenience_store","grocery_store"],
      'wheelchair_accessible_entrance', true,
      'business_status', ['OPERATIONAL'],
      'h3_resolution', 8
    )
);

الردّ على الدالة:

عرض النتائج

تعرض الصور التالية هذه البيانات في Looker Studio كخريطة مملوءة. كلما كانت خلية H3 أغمق، زاد تركيز النتائج:

لاستيراد بياناتك إلى Looker Studio، اتّبِع الخطوات التالية:

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

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

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

   

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

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

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

   

7. يظهر الخريطة المملوءة كما هو موضح أعلاه. يمكنك اختياريًا النقر على أنواع الرسوم البيانية -> الأنماط لمزيد من إعدادات مظهر الخريطة.

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