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

بيانات Places Insights

توفر خدمة إحصاءات الأماكن مجموعات بيانات كاملة وعيّنات منها في BigQuery.

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

تتضمّن العيّنة بيانات مدينة رئيسية لكل بلد من البلدان المتاحة:

أمستردام (هولندا) هلسنكي (فنلندا) بلوفديف (بلغاريا)
أنقرة (تركيا) هونغ كونغ الرفاع (البحرين)
أريكويبا (بيرو) جاكرتا (إندونيسيا) روما (إيطاليا)
أثينا (اليونان) جدة (المملكة العربية السعودية) سانتياغو (تشيلي)
باد غاستين (النمسا) جوهانسبرغ (جنوب أفريقيا) ساو باولو (البرازيل)
برلين (ألمانيا) كوالالمبور (ماليزيا) الشارقة (الإمارات العربية المتحدة)
برنو (جمهورية التشيك) لشبونة (البرتغال) سنغافورة (سنغافورة)
بروكسل (بلجيكا) لندن (المملكة المتحدة) ستوكهولم (السويد)
بوخارست (رومانيا) لوسيل (قطر) سيدني (أستراليا)
بوينس آيرس (الأرجنتين) مدريد (إسبانيا) تايبيه (تايوان)
بوسان (كوريا الجنوبية) مانيلا (الفلبين) تل أبيب - يافا (إسرائيل)
القاهرة (مصر) ميديلين (كولومبيا) طوكيو (اليابان)
شيانغ ماي (تايلاند) مكسيكو (المكسيك) تورونتو (كندا)
كوبنهاغن (الدنمارك) مومباي (الهند) وارسو (بولندا)
كورك (أيرلندا) نيويورك (الولايات المتحدة) ويلينغتون (نيوزيلندا)
ديبرتسن (هنغاريا) أوسلو (النرويج) زيورخ (سويسرا)
هانوي (فيتنام) باريس (فرنسا)

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

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

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

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

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

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

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

الاستعلام عن بيانات إحصاءات الأماكن

توفّر خدمة إحصاءات الأماكن طريقتَين للاستعلام عن مجموعات البيانات:

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

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

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

طلبات البحث باستخدام دوال Places Count

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

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

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

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

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

يوفّر هذا الجدول مقارنة تفصيلية للاختلافات بين طلبات البحث المباشرة ودوال Places Count.

دوال Places Count طلبات البحث المباشرة عن مجموعة البيانات
المزايا
  • تعرض أرقام تعريف الأماكن التي يمكن استخدامها للاستعلام عن واجهات برمجة التطبيقات الأخرى.
  • يمكن أن تعرض أي عدد.
  • محسّنة لتحقيق الأداء الجيد وتخفيض تكلفة المعالجة
  • سهلة الاستخدام لا حاجة إلى كتابة طلبات بحث معقّدة
  • تتحقّق من صحة مَعلمات الإدخال وتعرض خطأ، ما يسهّل استخدامها وتصحيح الأخطاء فيها
  • تسمح بإجراء طلبات بحث معقّدة، مثل الفلترة المتقدّمة وعمليات الربط
  • لا تفرض حدًا أدنى لمنطقة البحث
  • تتيح استخدام دوال تجميع إضافية بخلاف 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 (أي يتم استبعاد الصف).
فلاتر السمات المتاحة تتيح مَعلمات فلتر دالة Places Count الفلاتر نفسها التي تتيحها فلاتر سمات طلب البحث المباشر باستثناء ما يلي:
  • id المكان
  • مكوّنات العنوان
  • ساعات العمل
  • خيارات شحن المركبات الكهربائية
  • العلامات التجارية
المخطط الكامل متاح.