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

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

  • يدعم إمكانية الاشتراك في إحصاءات الأماكن في موقع BigQuery الذي تختاره.

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

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

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

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

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

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

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

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

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

  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`

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

في الإصدار الأوّلي من "إحصاءات الأماكن"، كان مخطط مجموعة البيانات يمثّل حقل العنوان كـ 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.

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

في الإصدار الأوّلي من إحصاءات الأماكن، كنت تستخدم الحقل 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";