دليل نقل البيانات

يتضمّن إصدار "إحصاءات الأماكن" هذا بتاريخ 4 سبتمبر 2025 التغييرات التالية مقارنةً بالإصدار الأوّلي:

نقل البيانات إلى بطاقات بيانات المتجر

تم نشر بيانات الإصدار الأوّلي من "إحصاءات الأماكن" في غرف آمنة للبيانات في BigQuery. في الإصدار الذي تم طرحه في 4 أيلول (سبتمبر) 2025، نقلنا مجموعات البيانات إلى قوائم BigQuery للسماح لك بالاشتراك في مجموعة البيانات في منطقة محدّدة في BigQuery. لا يؤثر هذا التغيير في ميزات المنتج وإمكانية استخدام "إحصاءات الأماكن".

للاشتراك في Places Insights في منطقة معيّنة، عليك الاشتراك في القوائم الجديدة في BigQuery Sharing. بعد الاشتراك في القوائم الجديدة، لن تحتاج إلى تعديل طلبات بحث SQL. وستبقى وظائفها كما هي.

  • المستخدمون الجدد: إذا كنت مستخدمًا جديدًا لخدمة Places Insights، اتّبِع الخطوات الواردة في إعداد Places Insights لإعداد بيئة التطوير من أجل الوصول إلى بيانات المؤسسات.

  • المستخدمون الحاليون: اتّبِع الخطوات التالية لنقل البيانات إلى "بطاقات بيانات المتجر".

خطوات نقل البيانات

للانتقال إلى البطاقات، عليك إجراء ما يلي:

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

  2. عدِّل اسم مجموعة البيانات في طلبات البحث أو الدوال إلى الاسم الذي اخترته أعلاه.

  3. إذا سبق لك استخدام الدوال، أزِل اسم المشروع المستخدَم مع مساحات تخزين البيانات النظيفة (maps-platform-analytics-hub).

  4. عدِّل طلبات البحث أو الدوال الحالية لتضمين اسم مشروعك (اختياري) وحقول العناوين الجديدة.

تضمين اسم مشروعك عند الإشارة إلى البطاقة (اختياري)

باستخدام البطاقات، يمكنك تضمين اسم مشروعك في طلب البحث. في حال عدم تحديد اسم مشروع، سيتم تلقائيًا استخدام المشروع النشط في طلب البحث.

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

مثال على طلب بحث معدَّل يتضمّن اسم المشروع واسم مجموعة البيانات

يتضمّن هذا الطلب اسم مشروع ويستخدم اسم مجموعة البيانات my_dataset_name:

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.my_dataset_name.places`

نقل البيانات إلى حقول العناوين الجديدة

في الإصدار الأوّلي من Places Insights، كان مخطط مجموعة البيانات يمثّل حقل العنوان كـ STRUCT أو RECORD يحتوي على حقلَين فرعيَين هما id وname. يعمل هذا الإصدار على تسوية المخطط لتحديد حقول منفصلة من المستوى الأعلى لكل من id وname. الحقول الجديدة هي حقول سلاسل أو مصفوفات سلاسل.

على سبيل المثال، يظهر أدناه مخطط مكوّن عنوان الموقع الجغرافي للإصدار الأوّلي:

locality STRUCT
  locality.id STRING
  locality.name STRING

في هذا الإصدار، تحتوي مجموعة البيانات الآن على حقلَين من حقول مصفوفة السلاسل من المستوى الأعلى. على سبيل المثال، يظهر أدناه المخطط المعدَّل لبيانات الموقع الجغرافي:

locality_ids ARRAY<string>
locality_names ARRAY<string>

اطّلِع على مرجع المخطط الكامل.

الحقول غير المصفوفة

في هذا الإصدار، أصبح الحقلان id وname من الحقول البارزة STRING لحقول العناوين غير المرتّبة على شكل مصفوفة:

administrative_area_level_1_id STRING
administrative_area_level_1_name STRING

ينطبق هذا التنسيق الجديد على جميع الحقول في النموذج administrative_area_level_N، حيث يكون N رقمًا من 1 إلى 7.

مثال على استخدام الحقول الجديدة

في الإصدار الأوّلي من Places Insights، كنت تستخدم الحقل administrative_area_level_1.name في عبارة WHERE لتصفية النتائج:

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.places_insights___us.places`
WHERE administrative_area_level_1.name = "New York";

باستخدام الحقول الجديدة، يمكنك كتابة طلب البحث باستخدام الحقل administrative_area_level_1_name:

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.places_insights___us.places`
WHERE administrative_area_level_1_name = "New York";