دالة PLACES_COUNT_PER_TYPE

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

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

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

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

      للحصول على أمثلة حول استخدام أنواع مختلفة من المواقع الجغرافية للبحث، مثل منافذ العرض والخطوط، اطّلِع على 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']
      )
);

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

نتائج الدالة Place Count Type في مدينة نيويورك