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

بيانات Places Insights

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

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

تتضمّن القائمة النموذجية بيانات لأهم مدينة في كل بلد من البلدان المتاحة:
أمستردام (هولندا) هلسنكي (FI) بلوفديف (BG)
أنقرة (TR) هونغ كونغ (HK) الرفاع (البحرين)
أريكيبا (بيرو) جاكرتا (إندونيسيا) روما (إيطاليا)
أثينا (اليونان) جدة (المملكة العربية السعودية) سانتياغو (CL)
باد غاستاين (النمسا) جوهانسبرغ (جنوب أفريقيا) ساو باولو (البرازيل)
برلين (ألمانيا) كوالالمبور (ماليزيا) الشارقة (الإمارات العربية المتحدة)
برنو (التشيك) لشبونة (البرتغال) سنغافورة (SG)
بروكسل (بلجيكا) لندن (المملكة المتحدة) ستوكهولم (السويد)
بوخارست (رومانيا) لوسيل (قطر) سيدني (أستراليا)
بوينس آيرس (الأرجنتين) مدريد (إسبانيا) تايبيه (تايوان)
بوسان (KR) مانيلا (الفلبين) تل أبيب-يافا (إسرائيل)
القاهرة (مصر) ميديلين (كولومبيا) طوكيو (اليابان)
شيانغ ماي (تايلاند) مكسيكو سيتي (المكسيك) تورونتو (كندا)
كوبنهاغن (الدنمارك) مومباي (الهند) وارسو (بولندا)
كورك (أيرلندا) مدينة نيويورك (الولايات المتحدة) ويلينغتون (نيوزيلندا)
دبرتسن (هنغاريا) أوسلو (النرويج) زيورخ (CH)
هانوي (فيتنام) باريس (فرنسا)

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

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

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

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

على سبيل المثال، إذا كنت تعمل على مجموعة البيانات الخاصة بإسبانيا (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 قائمة بأرقام تعريف الأماكن، والتي يمكن استخدامها للبحث عن معلومات الأماكن الفردية باستخدام منتجات "منصة خرائط Google" الأخرى، مثل Places API وحزمة أدوات "خرائط Google" الجاهزة للأماكن.

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

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

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

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

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

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