هذا المنتج أو الميزة قيد الاختبار (قبل طرحه للجميع). قد يكون الدعم المقدَّم للمنتجات والميزات في مرحلة ما قبل الإصدار العلني محدودًا، وقد لا تكون التغييرات التي يتم إجراؤها على المنتجات والميزات في مرحلة ما قبل الإصدار العلني متوافقة مع الإصدارات الأخرى من مرحلة ما قبل الإصدار العلني. تخضع "عروض مرحلة ما قبل الإطلاق" للأحكام المحدّدة لخدمة Google Maps Platform. لمزيد من المعلومات، يُرجى الاطّلاع على أوصاف مراحل الإطلاق. الاشتراك لاختبار "إحصاءات الأماكن"

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

نظرة عامة على دوالّ عدد الأماكن

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

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

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

دوال عدد الأماكن والبلدان المتوافقة

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

PLACES_COUNT: تعرض صفًا واحدًا يحتوي على عدد الأماكن.
‫PLACES_COUNT_PER_TYPE: تعرض جدول BigQuery يتضمّن عدد الأماكن لكل نوع من أنواع الأماكن.
‫PLACES_COUNT_PER_GEO: تعرض جدول BigQuery يتضمّن عدد الأماكن حسب المناطق الجغرافية.
‫PLACES_COUNT_PER_H3: تعرض جدول BigQuery يتضمّن عدد الأماكن لكل خلية H3.

بالإضافة إلى عدد الأماكن، تعرض الدالات PLACES_COUNT_PER_TYPE وPLACES_COUNT_PER_GEO وPLACES_COUNT_PER_H3 أيضًا ما يصل إلى 250 معرّف مكان لكل عنصر من عناصر الردّ.

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

للاطّلاع على القائمة الكاملة بالمدن والبلدان التي تتوفّر فيها هذه الميزة، يُرجى الرجوع إلى المرجع الخاص بوظائف احتساب عدد الأماكن في BigQuery.

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

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

مثال على دالة عدد الأماكن

يستخدم المثال التالي الدالة PLACES_COUNT لعرض عدد المطاعم المفتوحة ضمن مسافة 1,000 متر من مبنى Empire State في مدينة نيويورك:

SELECT `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"]
      )
) as count;

تحتوي الاستجابة على عدد واحد:

نتائج دالة "عدد الأماكن" في مدينة نيويورك

في هذا المثال، يشير البيان SELECT إلى الدالة PLACES_COUNT الخاصة بالولايات المتحدة باستخدام البنية التالية:

PROJECT_NAME.places_insights___us.PLACES_COUNT

استخدِم JSON_OBJECT لتمرير وسيطات إلى الدالة. يستخدم هذا المثال الدالة BigQuery ST_GEOGPOINT لعرض قيمة GEOGRAPHY من نقطة، ثم تمرير هذه القيمة إلى المَعلمة geography. كما يمرّر نصف قطر البحث حول النقطة ونوع المكان، "restaurant"، الذي تريد البحث عنه.

عدد الأماكن لكل نوع أو موقع جغرافي أو مثال على H3

بالإضافة إلى عدد الأماكن، تعرض الدالات PLACES_COUNT_PER_TYPE وPLACES_COUNT_PER_GEO وPLACES_COUNT_PER_H3 أيضًا ما يصل إلى 250 معرّف مكان للأماكن المضمّنة في الردّ.

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

يعرض استدعاء الدالة التالي عدد الأماكن التي تتضمّن الأنواع: restaurant وcafe وbar:

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'types', ["restaurant", "cafe", "bar"],
      'business_status', ['OPERATIONAL']
      )
);

تعرض هذه الدالة جدولاً يتضمّن ثلاثة أعمدة: type وcount وsample_place_ids. يعرض عمود count عدد الأماكن لكل type، ويعرض عمود sample_place_ids ما يصل إلى 250 معرّف مكان لكل type.

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

تطبيق الفلاتر على الدالة

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

SELECT `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"],
      'min_rating', 1.3,
      'price_level', ['PRICE_LEVEL_INEXPENSIVE', 'PRICE_LEVEL_MODERATE'],
      'allows_dogs', TRUE
      )
) as count;

عرض النتائج

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

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

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

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

تتوفّر إحصاءات COUNT فقط.
يجب ألا تقل مساحة البحث عن 40.0 متر × 40.0 متر (1600 متر²).
يقتصر حجم إدخال مَعلمة عدد الدوال في "وضع الوظيفة" على 1 ميغابايت.
لا تتوفّر إمكانية الفلترة حسب معرّف المكان أو مكوّن العنوان.

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

يسرد الجدول التالي الاختلافات الرئيسية:

	دوال عدد الأماكن	طلبات البحث عن مجموعات بيانات الأماكن
الواجهة	أربع دوال SQL محدّدة مسبقًا تنشئ إحصاءات `COUNT`: عدد فردي، وعدد لكل نوع، وعدد لكل منطقة جغرافية، وعدد لكل خلية H3	يستخدم SQL لتشغيل دوال التجميع، مثل `COUNT, COUNT_IF, SUM` و`AVG.`. ويمكن إنشاء إحصاءات إضافية باستخدام `JOIN, GROUP BY, WHERE` وغيرها.
القيود	يفرض حدًا أدنى لمساحة البحث يبلغ 40.0 مترًا في 40.0 مترًا (1600 متر مربع²). تعرض الدالة نتيجة حتى إذا كان عدد عمليات التجميع أقل من 5 طالما تم استيفاء الحد الأدنى لمساحة البحث.	يفرض حدًا أدنى للعدد يبلغ 5، ولكن بدون حد أدنى لمساحة البحث.
فلاتر السمات المتاحة	المخطّط الكامل متوافق باستثناء: مكان `id` مكوّنات العنوان	مخطّط كامل متوافق
المزايا	يمكنه عرض أي عدد. تم تحسينه لتحقيق أداء عالٍ وتكلفة معالجة منخفضة. سهل الاستخدام لا حاجة إلى كتابة طلبات بحث معقّدة. يتحقّق من صحة مَعلمات الإدخال ويعرض خطأ لتسهيل الاستخدام وتصحيح الأخطاء. تعرض هذه الطريقة أرقام تعريف الأماكن التي يمكن استخدامها للاستعلام عن واجهات برمجة تطبيقات أخرى.	تسمح بطلبات بحث معقّدة، مثل الفلترة المتقدّمة وعمليات الربط. لا يفرض حدًا أدنى لمساحة البحث. يتيح استخدام دوال تجميع إضافية بخلاف `COUNT`، مثل `AVG` و`SUM` و`GROUP BY`.

دوال احتساب الأماكن المرجعية في BigQuery

تتيح دوال حساب الأماكن المدن التالية (مجموعة بيانات نموذجية) والبلدان التالية (مجموعة بيانات كاملة). يجب الاشتراك في كل مدينة وبلد بشكل منفصل.

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

المدينة والبلد	أسماء الجداول
سيدني، أستراليا	`places_insights___au___sample.FUNCTION_NAME`
ساو باولو، البرازيل	`places_insights___br___sample.FUNCTION_NAME`
تورونتو، كندا	`places_insights___ca___sample.FUNCTION_NAME`
باريس، فرنسا	`places_insights___fr___sample.FUNCTION_NAME`
برلين، ألمانيا	`places_insights___de___sample.FUNCTION_NAME`
مومباي، الهند	`places_insights___in___sample.FUNCTION_NAME`
جاكرتا، أندونيسيا	`places_insights___id___sample.FUNCTION_NAME`
روما، إيطاليا	`places_insights___it___sample.FUNCTION_NAME`
طوكيو، اليابان	`places_insights___jp___sample.FUNCTION_NAME`
مكسيكو سيتي، المكسيك	`places_insights___mx___sample.FUNCTION_NAME`
مدريد، إسبانيا	`places_insights___es___sample.FUNCTION_NAME`
زيوريخ، سويسرا	`places_insights___ch___sample.FUNCTION_NAME`
لندن، المملكة المتحدة	`places_insights___gb___sample.FUNCTION_NAME`
مدينة نيويورك، الولايات المتحدة	`places_insights___us___sample.FUNCTION_NAME`

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

البلد	أسماء الجداول
أستراليا	`places_insights___au.FUNCTION_NAME`
البرازيل	`places_insights___br.FUNCTION_NAME`
كندا	`places_insights___ca.FUNCTION_NAME`
فرنسا	`places_insights___fr.FUNCTION_NAME`
ألمانيا	`places_insights___de.FUNCTION_NAME`
الهند	`places_insights___in.FUNCTION_NAME`
إندونيسيا	`places_insights___id.FUNCTION_NAME`
إيطاليا	`places_insights___it.FUNCTION_NAME`
اليابان	`places_insights___jp.FUNCTION_NAME`
المكسيك	`places_insights___mx.FUNCTION_NAME`
إسبانيا	`places_insights___es.FUNCTION_NAME`
سويسرا	`places_insights___ch.FUNCTION_NAME`
المملكة المتحدة	`places_insights___gb.FUNCTION_NAME`
الولايات المتحدة	`places_insights___us.FUNCTION_NAME`