لمحة عن بيانات وطلبات بحث Places Insights

بيانات Places Insights

توفّر أداة Places Insights مجموعات بيانات كاملة وعينات في BigQuery.

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

يتضمّن نموذج بيانات المؤسسة بيانات عن مدينة رئيسية في كل بلد من البلدان المتاحة: سيدني (أستراليا)، وساو باولو (البرازيل)، وتورونتو (كندا)، وزيورخ (سويسرا)، وبرلين (ألمانيا)، ومدريد (إسبانيا)، وباريس (فرنسا)، ولندن (المملكة المتحدة)، وجاكرتا (إندونيسيا)، ومومباي (الهند)، وروما (إيطاليا)، وطوكيو (اليابان)، ومكسيكو سيتي (المكسيك)، ونيويورك (الولايات المتحدة).

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

تتضمّن كل مجموعة بيانات خاصة ببلد معيّن بطاقة بيانات خاصة بها يجب الاشتراك فيها بشكل منفصل. لمزيد من المعلومات حول الاشتراك في بطاقة بيانات، اطّلِع على إعداد Places Insights.

مخططات مجموعات البيانات

يتألف مخطط مجموعة بيانات الأماكن لكل بلد من جزأين:

• المخطط الأساسي المشترك بين مجموعات البيانات في جميع البلدان
• مخطط خاص ببلد معيّن يحدّد عناصر المخطط الخاصة بهذا البلد

على سبيل المثال، إذا كنت تعمل على مجموعة بيانات خاصة بإسبانيا (ES)، عليك الرجوع إلى كل من المخطط الأساسي والمخطط الخاص بإسبانيا.

يحدّد مخطط مجموعة بيانات العلامات التجارية ثلاثة حقول:

• ‫id: معرّف العلامة التجارية.
• name: اسم العلامة التجارية، مثل "Hertz" أو "Chase".
• ‫category: الفئة العالية المستوى للعلامة التجارية، مثل "محطة وقود" أو "طعام وشراب" أو "أماكن إقامة"

طلب بيانات Places Insights

توفّر أداة Places Insights طريقتَين لطلب البحث في مجموعات البيانات:

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

طلبات البحث المباشرة

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

طلبات البحث عن دالة عدد الأماكن

يمكن أن تعرض دوال عدد الأماكن قائمة بمعرّفات الأماكن، ويمكن استخدامها للبحث عن معلومات خاصة بمكان معيّن باستخدام منتجات أخرى من "منصة Google للتسويق"، مثل Places API وPlaces UI Kit.

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

حالات طلب البحث عن البيانات مباشرةً وحالات استخدام الدوال

يمكنك طلب البيانات مباشرةً إذا لم تكن بحاجة إلى أعداد نتائج منخفضة، أو إذا كنت تريد الحصول على إحصاءات تتجاوز الأعداد، مثل AVG أو SUM أو COUNTIF، أو إذا كنت بحاجة إلى تنفيذ طلبات بحث أكثر تعقيدًا، مثل دمج مجموعات البيانات.

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

يقدّم هذا الجدول مقارنة تفصيلية للاختلافات بين طلبات البحث المباشرة ووظائف عدد الأماكن.

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