دالة PLACES_COUNT_PER_TYPE

تعرض الدالة PLACES_COUNT_PER_TYPE جدولاً بأعداد كل نوع من الأماكن المحدّدة للدالة. على سبيل المثال، إذا بحثت عن الأنواع doctor وhospital وpharmacy، سيتضمّن الردّ جدولاً يحتوي على صف منفصل لكل نوع.

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

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

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

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

  • مطلوبة: types مَعلمة فلتر التي تحدّد أنواع الأماكن التي يجب البحث عنها.

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

• المرتجعات:

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

مثال: عرض عدد المطاعم والمقاهي والبارات

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

تأخذ المَعلمة types صفيفًا من قيم STRING تحدّد أنواع الأماكن التي يجب البحث عنها. للاطّلاع على القائمة الكاملة بالقيم المتاحة، راجِع أنواع الأماكن.

يستخدم هذا المثال أيضًا دالة BigQuery ST_GEOGFROMTEXT لعرض قيمة GEOGRAPHYمن شكل مضلّع.

DECLARE geo GEOGRAPHY;
SET geo = ST_GEOGFROMTEXT('''POLYGON((-73.985708 40.75773,-73.993324 40.750298,
                                      -73.9857 40.7484,-73.9785 40.7575,
                                      -73.985708 40.75773))''');  -- NYC viewport

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'types', ["restaurant", "cafe", "bar"],
      'geography', geo,
      'business_status', ['OPERATIONAL']
      )
);

تعرض هذه الدالة جدولاً يحتوي على ثلاثة صفوف، صف واحد لكل نوع:

مثال: عرض الأعداد حسب النوع بعد الفلترة حسب العلامة التجارية

يستخدم المثال التالي فلتر brand_ids لاسترداد أعداد الأنواع لـ علامات تجارية معيّنة، مثل Starbucks التي تحمل المعرّف "1413758728321880760"

DECLARE geo GEOGRAPHY;
SET geo = ST_GEOGFROMTEXT('POLYGON((-73.985708 40.75773,-73.993324 40.750298,
                                      -73.9857 40.7484,-73.9785 40.7575,
                                      -73.985708 40.75773))');  -- NYC viewport

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'types', ["cafe", "restaurant"],
      'geography', geo,
      'brand_ids', ["1413758728321880760"], -- Filter for Starbucks
      'business_status', ['OPERATIONAL']
      )
);