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

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

  • تتيح هذه السمة إمكانية الاشتراك في Places Insights في موقع BigQuery الذي تختاره.

  • نقل مجموعات بيانات Places Insights من مساحات تخزين البيانات الآمنة إلى بطاقات بيانات في "سوق بيانات BigQuery"

  • تفصل حقول العناوين في مخطط مجموعة البيانات الحقلين id وname إلى حقول منفصلة من السلاسل أو مصفوفات السلاسل.

نقل البيانات إلى بطاقات بيانات

تم نشر بيانات الإصدار الأوّلي من "إحصاءات الأماكن" في غرف آمنة للبيانات في 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";