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

بيانات Places Insights

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

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

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

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

تتضمّن مجموعات البيانات الكاملة بيانات لكل بلد متوافق ويجب شراؤها. إذا كنت مهتمًا بالاشتراك في "إحصاءات الأماكن"، يُرجى ملء نموذج الطلب. على المشترك في البيانات فقط أن يطلب الوصول إلى مجموعة بيانات إحصاءات الأماكن. بعد تفعيل الاشتراك في مشروع 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 و4، سيتم حذف النتيجة من الردّ. على سبيل المثال، لن يتم عرض أي رد على طلب البحث عن العدد الإجمالي للمطاعم في منطقة معيّنة إلا إذا كان العدد الإجمالي 5 أو أكثر.

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

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

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

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

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

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

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