الاستعلام عن مجموعة البيانات باستخدام دوال Places Count

دوال Places Count هي طلبات بحث SQL محدّدة مسبقًا يتم تنفيذها في BigQuery، وهي مكمّلة لطلب البحث في مجموعة البيانات مباشرةً. الفرق الرئيسي بين طلب البحث عن البيانات مباشرةً واستخدام دالة هو أنّ الدوال لا تفرض حدًا أدنى لعدد النتائج، بل تفرض حدًا أدنى لمساحة البحث:

• يمكن أن تعرض طلبات البحث عن مجموعات بيانات الأماكن أعدادًا تبلغ 5 أو أكثر فقط، ولكنّها لا تفرض أي قيود على حجم مساحة البحث.
• يمكن أن تعرض دوال "عدد الأماكن" أي أعداد، بما في ذلك 0، ولكنها تفرض حدًا أدنى لمساحة البحث يبلغ 40.0 مترًا في 40.0 مترًا (1600 متر²). يمكن أن تعرض الدوال أيضًا معرّفات الأماكن، والتي يمكن استخدامها للبحث عن معلومات حول أماكن فردية.

يمكنك استخدام دوال Places Count إذا كان من المهم معرفة ما إذا كان طلب البحث لا يعرض أي نتائج أو إذا كنت بحاجة إلى معرفة عدد قليل من الأماكن أقل من 5. ويفيد أيضًا إذا كنت بحاجة إلى الحصول على معلومات فردية عن الأماكن للتأكّد من صحة نتائجك.

لا توفّر دوال Places Count سوى عدد النتائج، لذا إذا كنت بحاجة إلى تنفيذ طلبات بحث أكثر تعقيدًا، مثل عمليات ربط البيانات، أو الحصول على إحصاءات إضافية، مثل متوسط التقييم لمجموعة من الأماكن، عليك إجراء طلب بحث في مجموعة البيانات مباشرةً.

الدول ووظائف "عدد الأماكن" المتاحة

تتيح أداة "إحصاءات الأماكن" الوظائف التالية:

• ‫science PLACES_COUNT_V2: تعرض جدولاً يحتوي على عدد الأماكن ونماذج من معرّفات الأماكن. تقبل هذه الدالة مَعلمة جدول لإدخال بيانات من مناطق جغرافية متعددة، ما يتيح معالجة فعّالة للبيانات المجمّعة. وهي محسّنة بشكل كبير لعمليات الربط الجغرافية المكانية مقارنةً بالدالتَين PLACES_COUNT وPLACES_COUNT_PER_GEO.
• ‫science PLACES_COUNT_PER_TYPE_V2: تعرض هذه السمة جدولاً يتضمّن عدد الأماكن ونماذج من أرقام تعريف الأماكن، مصنّفة حسب نوع المكان. على غرار PLACES_COUNT_V2، تقبل هذه الدالة معلَمة جدول لمعالجة مناطق جغرافية متعددة في الوقت نفسه. تتيح هذه البنية معالجة فعّالة للدُفعات وتوفّر ربطًا محسّنًا للبيانات الجغرافية المكانية مقارنةً بـ PLACES_COUNT_PER_TYPE.
• ‫PLACES_COUNT_PER_H3: تعرض جدول BigQuery يتضمّن عدد الأماكن لكل خلية H3.
• ‫PLACES_COUNT: تعرض صفًا واحدًا يحتوي على عدد الأماكن.
• ‫PLACES_COUNT_PER_TYPE: تعرض جدول BigQuery يحتوي على عدد الأماكن لكل نوع من أنواع الأماكن.
• ‫PLACES_COUNT_PER_GEO: تعرض جدول BigQuery يتضمّن عدد الأماكن حسب المناطق الجغرافية.

بالإضافة إلى أعداد الأماكن، تعرض جميع الدوال ما يصل إلى 250 رقم تعريف للمكان لكل عنصر من عناصر الردّ، باستثناء الدالة PLACES_COUNT.

يمكن استخدام معرّفات الأماكن مع ما يلي:

• ‫Places API (جديدة)
• Geocoding API
• Places UI Kit

كتابة طلبات بحث باستخدام الدوال

استخدِم التنسيق التالي لاستدعاء الدوال: [project name (optional)].[table name].[function name].

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

على سبيل المثال:

PROJECT_NAME.places_insights___us.PLACES_COUNT

استخدِم JSON_OBJECT لتمرير وسيطات إلى الدالة.

تصفية النتائج

تتيح دوال "عدد الأماكن" استخدام العديد من الفلاتر لتحسين عملية البحث. هذه المَعلمات (مثل price_level أو types) حسّاسة لحالة الأحرف ويجب أن تتطابق مع أسماء المَعلمات تمامًا. الاطّلاع على مرجع مَعلمات الفلتر للحصول على قائمة كاملة بالخيارات

في المثال التالي، يمكنك تطبيق فلاتر للحدّ من البحث حسب الحد الأدنى لتقييم المستخدمين ومستوى السعر وحالة المؤسسة وما إذا كان المطعم يسمح باصطحاب الكلاب، وذلك باستخدام الدالة PLACES_COUNT_V2.

أولاً، استخدِم جدول المواقع الجغرافية الذي أدخلته أو أعدّ جدولاً يتضمّن المواقع الجغرافية التي اخترتها:

-- Create a table for the input geographies
CREATE TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas` AS (
  SELECT
    '1' AS geo_id, -- Unique identifier
    ST_GEOGPOINT(-73.9857, 40.7484) AS geo -- Empire State Building
  UNION ALL
  SELECT
    '2' AS geo_id, -- Unique identifier
    ST_GEOGPOINT(-73.9851, 40.7580) AS geo -- Times Square
);

بعد ذلك، استدعِ الدالة PLACES_COUNT_V2 مع الجدول وعنصر JSON الذي يحتوي على الفلاتر. يتم تضمين نطاق البحث الجغرافي في فلاتر JSON وسيتم تطبيقه حول كل نقطة في الجدول my_search_areas.

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_V2`(
  TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas`,
  JSON_OBJECT(
      'geography_radius', 1000, -- Radius in meters around each point in 'geo'
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"],
      'min_rating', 1.3,
      'price_level', ['PRICE_LEVEL_INEXPENSIVE', 'PRICE_LEVEL_MODERATE'],
      'allows_dogs', TRUE
      )
);

مثال على الدالة Places Count

يستخدم المثال التالي الدالة PLACES_COUNT_V2 مع جدول الجغرافيا المخصّص للإدخال my_search_area لعرض عدد المطاعم المفتوحة ضمن مسافة 1,000 متر من مبنى Empire State وTimes Square في مدينة نيويورك:

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_V2`(
  TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas`,
  JSON_OBJECT(
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"]
      )
);

الردّ هو جدول BigQuery يحتوي على geo_id والجغرافيا والعدد وعيّنة من معرّفات الأماكن.

عرض النتائج

تُعدّ أدوات التحليل وذكاء الأعمال ضرورية لمساعدتك في استخلاص الإحصاءات من بياناتك في BigQuery. يتوافق BigQuery مع العديد من أدوات عرض البيانات بشكل مرئي من Google والجهات الخارجية التي يمكنك استخدامها لتحليل نتائج الدوال على بيانات إحصاءات الأماكن.

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

القيود والمتطلبات

تخضع وظائف "عدد الأماكن" للقيود والمتطلبات التالية:

• تتوفّر إحصاءات COUNT فقط.
• يجب ألا تقل مساحة البحث عن 40.0 متر × 40.0 متر (1600 متر²).
• الحد الأقصى لحجم إدخال المَعلمات: يقتصر حجم عنصر JSON الذي يتم تمريره كمَعلمة إلى الدوال على 1 ميغابايت. يعتمد تأثير هذا الحدّ على إصدار الدالة:
• بالنسبة إلى دوال الإصدار 2 (PLACES_COUNT_V2 وPLACES_COUNT_PER_TYPE_V2)، ينطبق هذا الحدّ على عنصر JSON الخاص بالفلاتر فقط. بما أنّ المناطق الجغرافية يتم توفيرها بشكل منفصل باستخدام مَعلمة جدول، يمكن توسيع نطاق هذه الدوال لتشمل عددًا أكبر بكثير من المناطق الجغرافية المُدخَلة بدون بلوغ الحد الأقصى لحجم JSON.
  • بالنسبة إلى PLACES_COUNT_PER_H3 وPLACES_COUNT وPLACES_COUNT_PER_TYPE وPLACES_COUNT_PER_GEO، ينطبق هذا الحدّ على كائن JSON بأكمله، بما في ذلك جميع تعريفات المناطق الجغرافية. وقد يؤدي ذلك إلى الحدّ من عدد المناطق الجغرافية التي يمكن معالجتها في طلب واحد.
• لا تتوفّر إمكانية الفلترة حسب معرّف المكان أو العلامات التجارية أو خيارات شحن المركبات الكهربائية أو مكوّن العنوان.
• يمكنك الوصول إلى دوال "عدد الأماكن" للمدن والبلدان التي اشتركت فيها فقط. اطّلِع على إعداد إحصاءات الأماكن للحصول على إذن الوصول إلى مجموعة البيانات.
• إنّ مَعلمات الفلترة (مثل geography أو types) حسّاسة لحالة الأحرف ويجب أن تتطابق مع أسماء المَعلمات تمامًا، وإلا سيفشل طلب البحث.

مراجع لدوال Places Count في BigQuery

تتيح جميع المدن في مجموعة البيانات النموذجية والبلدان في مجموعة البيانات الكاملة استخدام دوال Places Count.

يمكنك الوصول إلى دوال "عدد الأماكن" التي تتوافق مع مجموعات بيانات المدن والبلدان التي اشتركت فيها. اطّلِع على إعداد Places Insights للوصول إلى مجموعة البيانات.

تسرد هذه الجداول المدن والبلدان المتاحة وأسماء الجداول المقابلة لها.

عيّنات البيانات

البيانات الكاملة