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

بيانات Places Insights

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

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

تتضمّن القائمة النموذجية بيانات لأهم مدينة في كل بلد من البلدان المتاحة:

  • أمستردام (هولندا)
  • أنقرة (TR)
  • أريكيبا (بيرو)
  • أثينا (اليونان)
  • باد غاستاين (النمسا)
  • برلين (ألمانيا)
  • برنو (التشيك)
  • بروكسل (بلجيكا)
  • بوخارست (رومانيا)
  • بوينس آيرس (الأرجنتين)
  • بوسان (كوريا الجنوبية)
  • القاهرة (مصر)
  • شيانغ ماي (تايلاند)
  • كوبنهاغن (الدنمارك)
  • كورك (أيرلندا)
  • دبرتسن (هنغاريا)
  • هانوي (فيتنام)
  • هلسنكي (FI)
  • هونغ كونغ (HK)
  • جاكرتا (إندونيسيا)
  • جدة (المملكة العربية السعودية)
  • جوهانسبرغ (جنوب أفريقيا)
  • كوالالمبور (ماليزيا)
  • لشبونة (البرتغال)
  • لندن (بريطانيا العظمى)
  • لوسيل (قطر)
  • مدريد (إسبانيا)
  • مانيلا (الفلبين)
  • ميديلين (CO)
  • مكسيكو سيتي (المكسيك)
  • مومباي (الهند)
  • مدينة نيويورك (الولايات المتحدة)
  • أوسلو (النرويج)
  • باريس (فرنسا)
  • بلوفديف (BG)
  • الرفاع (البحرين)
  • روما (إيطاليا)
  • سانتياغو (CL)
  • ساو باولو (البرازيل)
  • الشارقة (الإمارات العربية المتحدة)
  • سنغافورة (SG)
  • ستوكهولم (السويد)
  • سيدني (أستراليا)
  • تايبيه (تايوان)
  • تل أبيب-يافا (إسرائيل)
  • طوكيو (اليابان)
  • تورونتو (كندا)
  • وارسو (بولندا)
  • ويلينغتون (نيوزيلندا)
  • زيورخ (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

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

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

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

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

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

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

دوال 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"
  • مكونات العنوان
 المخطط الكامل متوافق.