المرجع

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

تتم إضافة بادئة إلى أسماء الجداول حسب نوع المنتج (cropped_ أو full_frame_ أو pano_)، ولا تظهر في مجموعة البيانات سوى الجداول الخاصة بالمنتجات المضمّنة في اشتراكاتك. تتضمّن الجداول التي تنتهي بـ _all بيانات من جميع اللقطات، بينما تتضمّن الجداول التي تنتهي بـ _latest بيانات من أحدث لقطة فقط.

المفاهيم الأساسية

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

snapshots

اللقطة هي نسخة ثابتة وغير قابلة للتغيير من مجموعة بيانات في لحظة زمنية محددة. يوفّر جدول اللقطات بيانات وصفية مرتبطة باللقطات، ما يتيح لك فهم الحالة الزمنية للبيانات على مستوى عالٍ.

اسم العمود	النوع	الوصف
snapshot_id	سلسلة	المعرّف الفريد للّقطة يُستخدَم كمفتاح لربط الجداول.
subscription_id	سلسلة	المعرّف الفريد للاشتراك
creation_time	طابع زمني	الطابع الزمني لوقت إنشاء اللقطة طابع زمني بتنسيق ISO 8601، مثل 2019-09-25 17:26:27.757171 UTC.
product_types	مصفوفة<سلسلة نصية>	تمثّل هذه السمة أنواع المنتجات المرتبطة باللقطة. القيم الصالحة هي SV_CROPPED_ASSETS وSV_FULL_FRAME_ASSETS وSV_PANO.

cropped_observations_all

يوفّر جدول cropped_observations_all ملاحظات حول مواد العرض التي تم اقتصاصها من جميع اللقطات. يمكنك استخدام هذا الجدول لرصد الاختلافات في الملاحظات بين اللقطات.

اسم العمود	النوع	الوصف
snapshot_id	سلسلة	المعرّف الفريد للّقطة التي جمعت هذه الملاحظة
asset_id	سلسلة	المعرّف الفريد لمادة العرض المرتبطة بهذه الملاحظة
asset_type	سلسلة	التصنيف الرئيسي لمادة العرض القيم الصالحة هي ASSET_CLASS_ROAD_SIGN وASSET_CLASS_UTILITY_POLE وASSET_CLASS_MAINTENANCE_COVER.
location	STRUCT	بنية تحتوي على إحداثيات خطوط العرض/الطول كأعداد عشرية الموقع الجغرافي الذي تم فيه التقاط الصورة المرصودة
detection_time	طابع زمني	أحدث ملاحظة capture_time لمادة العرض المحدّدة طابع زمني بتنسيق ISO 8601، مثل 2019-09-25 17:26:27.757171 UTC.
observation_id	سلسلة	سلسلة تحدّد الملاحظة بشكل فريد
bbox	STRUCT	بنية من البُنى التي تحتوي على إحداثيات x/y التي تحاذي المربّع المحيط بمادة العرض
camera_pose	STRUCT	موضع الكاميرا LLA وزوايا أويلر بنية تحتوي على قيم عائمة لخط العرض/خط الطول والارتفاع (بالأمتار) والميل والاتجاه والالتفاف (بالدرجات).
capture_time	طابع زمني	الطابع الزمني لوقت تسجيل الملاحظة طابع زمني بتنسيق ISO 8601، مثل 2019-09-25 17:26:27.757171 UTC.
pano_id	سلسلة	المعرّف الفريد لصورة بانورامية مجمّعة بزاوية 360 درجة يمكن أن تكون هذه القيمة فارغة، وقد لا تكون متوفّرة. وإذا كان موجودًا، يمكن استخدامه كمفتاح وصول مع Google Maps Street View Static API.
gcs_uri	سلسلة	معرّف الموارد المنتظم (URI) لخدمة Google Cloud Storage حيث تتم استضافة الصورة
map_url	سلسلة	عنوان URL على خرائط Google يعرض الموقع الجغرافي لمادة العرض

cropped_assets_all

يوفّر الجدول cropped_assets_all مواد عرض تم اقتصاصها من جميع اللقطات. يمكنك استخدام هذا الجدول لاكتشاف الاختلافات في مواد العرض بين اللقطات.

اسم العمود	النوع	الوصف
asset_id	سلسلة	المعرّف الفريد لمادة العرض
snapshot_id	سلسلة	المعرّف الفريد للّقطة التي جمعت مادة العرض هذه
asset_type	سلسلة	التصنيف الرئيسي لمادة العرض القيم الصالحة هي ASSET_CLASS_ROAD_SIGN وASSET_CLASS_UTILITY_POLE وASSET_CLASS_MAINTENANCE_COVER.
location	STRUCT	بنية تحتوي على إحداثيات خطوط العرض/الطول كأرقام عائمة تمثّل الموقع الجغرافي التقريبي لمادة العرض.
detection_time	طابع زمني	أحدث ملاحظة capture_time لمادة العرض المحدّدة طابع زمني بتنسيق ISO 8601، مثل 2019-09-25 17:26:27.757171 UTC.

cropped_observations_latest

يوفّر جدول cropped_observations_latest ملاحظات حول مواد العرض التي تم اقتصاصها فقط من أحدث لقطة.

اسم العمود	النوع	الوصف
snapshot_id	سلسلة	المعرّف الفريد للّقطة التي جمعت هذه الملاحظة
asset_id	سلسلة	المعرّف الفريد لمادة العرض المرتبطة بهذه الملاحظة
asset_type	سلسلة	التصنيف الرئيسي لمادة العرض القيم الصالحة هي ASSET_CLASS_ROAD_SIGN وASSET_CLASS_UTILITY_POLE وASSET_CLASS_MAINTENANCE_COVER.
location	STRUCT	بنية تحتوي على إحداثيات خطوط العرض/الطول كأعداد عشرية الموقع الجغرافي الذي تم فيه التقاط الصورة المرصودة
detection_time	طابع زمني	أحدث ملاحظة capture_time لمادة العرض المحدّدة طابع زمني بتنسيق ISO 8601، مثل 2019-09-25 17:26:27.757171 UTC.
observation_id	سلسلة	سلسلة تحدّد الملاحظة بشكل فريد
bbox	STRUCT	بنية من البُنى التي تحتوي على إحداثيات x/y التي تحاذي المربّع المحيط بمادة العرض
camera_pose	STRUCT	موضع الكاميرا LLA وزوايا أويلر بنية تحتوي على قيم عائمة لخط العرض/خط الطول والارتفاع (بالأمتار) والميل والاتجاه والالتفاف (بالدرجات).
capture_time	طابع زمني	الطابع الزمني لوقت تسجيل الملاحظة طابع زمني بتنسيق ISO 8601، مثل 2019-09-25 17:26:27.757171 UTC.
pano_id	سلسلة	المعرّف الفريد لصورة بانورامية مجمّعة بزاوية 360 درجة يمكن أن تكون هذه القيمة فارغة، وقد لا تكون متوفّرة. وإذا كان موجودًا، يمكن استخدامه كمفتاح وصول مع Google Maps Street View Static API.
gcs_uri	سلسلة	معرّف الموارد المنتظم (URI) لخدمة Google Cloud Storage حيث تتم استضافة الصورة
map_url	سلسلة	عنوان URL على خرائط Google يعرض الموقع الجغرافي لمادة العرض

cropped_assets_latest

يوفّر الجدول cropped_assets_latest مواد عرض مقتصّة من أحدث لقطة فقط.

اسم العمود	النوع	الوصف
asset_id	سلسلة	المعرّف الفريد لمادة العرض
snapshot_id	سلسلة	المعرّف الفريد للّقطة التي جمعت مادة العرض هذه
asset_type	سلسلة	التصنيف الرئيسي لمادة العرض القيم الصالحة هي ASSET_CLASS_ROAD_SIGN وASSET_CLASS_UTILITY_POLE وASSET_CLASS_MAINTENANCE_COVER.
location	STRUCT	بنية تحتوي على إحداثيات خطوط العرض/الطول كأرقام عائمة تمثّل الموقع الجغرافي التقريبي لمادة العرض.
detection_time	طابع زمني	أحدث ملاحظة capture_time لمادة العرض المحدّدة طابع زمني بتنسيق ISO 8601، مثل 2019-09-25 17:26:27.757171 UTC.

full_frame_observations_all

يوفّر الجدول full_frame_observations_all بيانات رصد مواد العرض بإطار كامل (بدون اقتصاص) من جميع اللقطات. يمكنك استخدام هذا الجدول لرصد الاختلافات في الملاحظات بين اللقطات.

اسم العمود	النوع	الوصف
snapshot_id	سلسلة	المعرّف الفريد للّقطة التي جمعت هذه الملاحظة
asset_id	سلسلة	المعرّف الفريد لمادة العرض المرتبطة بهذه الملاحظة
asset_type	سلسلة	التصنيف الرئيسي لمادة العرض القيم الصالحة هي ASSET_CLASS_ROAD_SIGN وASSET_CLASS_UTILITY_POLE وASSET_CLASS_MAINTENANCE_COVER.
location	STRUCT	بنية تحتوي على إحداثيات خطوط العرض/الطول كأعداد عشرية الموقع الجغرافي الذي تم فيه التقاط الصورة المرصودة
detection_time	طابع زمني	أحدث ملاحظة capture_time لمادة العرض المحدّدة طابع زمني بتنسيق ISO 8601، مثل 2019-09-25 17:26:27.757171 UTC.
observation_id	سلسلة	سلسلة تحدّد الملاحظة بشكل فريد
bbox	STRUCT	بنية من البُنى التي تحتوي على إحداثيات x/y التي تحاذي المربّع المحيط بمادة العرض
camera_pose	STRUCT	موضع الكاميرا LLA وزوايا أويلر بنية تحتوي على قيم عائمة لخط العرض/خط الطول والارتفاع (بالأمتار) والميل والاتجاه والالتفاف (بالدرجات).
capture_time	طابع زمني	الطابع الزمني لوقت تسجيل الملاحظة طابع زمني بتنسيق ISO 8601، مثل 2019-09-25 17:26:27.757171 UTC.
pano_id	سلسلة	المعرّف الفريد لصورة بانورامية مجمّعة بزاوية 360 درجة يمكن أن تكون هذه القيمة فارغة، وقد لا تكون متوفّرة. وإذا كان موجودًا، يمكن استخدامه كمفتاح وصول مع Google Maps Street View Static API.
gcs_uri	سلسلة	معرّف الموارد المنتظم (URI) لخدمة Google Cloud Storage حيث تتم استضافة الصورة
map_url	سلسلة	عنوان URL على خرائط Google يعرض الموقع الجغرافي لمادة العرض

full_frame_assets_all

يوفّر الجدول full_frame_assets_all مواد عرض كاملة الإطار (غير مقتطَعة) من جميع اللقطات. يمكنك استخدام هذا الجدول لرصد الاختلافات في مواد العرض بين اللقطات.

اسم العمود	النوع	الوصف
asset_id	سلسلة	المعرّف الفريد لمادة العرض
snapshot_id	سلسلة	المعرّف الفريد للّقطة التي جمعت مادة العرض هذه
asset_type	سلسلة	التصنيف الرئيسي لمادة العرض القيم الصالحة هي ASSET_CLASS_ROAD_SIGN وASSET_CLASS_UTILITY_POLE وASSET_CLASS_MAINTENANCE_COVER.
location	STRUCT	بنية تحتوي على إحداثيات خطوط العرض/الطول كأرقام عائمة تمثّل الموقع الجغرافي التقريبي لمادة العرض.
detection_time	طابع زمني	أحدث ملاحظة capture_time لمادة العرض المحدّدة طابع زمني بتنسيق ISO 8601، مثل 2019-09-25 17:26:27.757171 UTC.

full_frame_observations_latest

يوفّر جدول full_frame_observations_latest ملاحظات حول مواد العرض ذات الإطار الكامل (غير المقتصّة) من أحدث لقطة فقط.

اسم العمود	النوع	الوصف
snapshot_id	سلسلة	المعرّف الفريد للّقطة التي جمعت هذه الملاحظة
asset_id	سلسلة	المعرّف الفريد لمادة العرض المرتبطة بهذه الملاحظة
asset_type	سلسلة	التصنيف الرئيسي لمادة العرض القيم الصالحة هي ASSET_CLASS_ROAD_SIGN وASSET_CLASS_UTILITY_POLE وASSET_CLASS_MAINTENANCE_COVER.
location	STRUCT	بنية تحتوي على إحداثيات خطوط العرض/الطول كأعداد عشرية الموقع الجغرافي الذي تم فيه التقاط الصورة المرصودة
detection_time	طابع زمني	أحدث ملاحظة capture_time لمادة العرض المحدّدة طابع زمني بتنسيق ISO 8601، مثل 2019-09-25 17:26:27.757171 UTC.
observation_id	سلسلة	سلسلة تحدّد الملاحظة بشكل فريد
bbox	STRUCT	بنية من البُنى التي تحتوي على إحداثيات x/y التي تحاذي المربّع المحيط بمادة العرض
camera_pose	STRUCT	موضع الكاميرا LLA وزوايا أويلر بنية تحتوي على قيم عائمة لخط العرض/خط الطول والارتفاع (بالأمتار) والميل والاتجاه والالتفاف (بالدرجات).
capture_time	طابع زمني	الطابع الزمني لوقت تسجيل الملاحظة طابع زمني بتنسيق ISO 8601، مثل 2019-09-25 17:26:27.757171 UTC.
pano_id	سلسلة	المعرّف الفريد لصورة بانورامية مجمّعة بزاوية 360 درجة يمكن أن تكون هذه القيمة فارغة، وقد لا تكون متوفّرة. وإذا كان متاحًا، يمكن استخدامه كمفتاح وصول مع Google Maps Street View Static API.
gcs_uri	سلسلة	معرّف الموارد المنتظم (URI) لخدمة Google Cloud Storage حيث تتم استضافة الصورة
map_url	سلسلة	عنوان URL على خرائط Google يعرض الموقع الجغرافي لمادة العرض

full_frame_assets_latest

يوفّر الجدول full_frame_assets_latest مواد عرض كاملة الإطار (غير مقتطَعة) فقط من أحدث لقطة.

اسم العمود	النوع	الوصف
asset_id	سلسلة	المعرّف الفريد لمادة العرض
snapshot_id	سلسلة	المعرّف الفريد للّقطة التي جمعت مادة العرض هذه
asset_type	سلسلة	التصنيف الرئيسي لمادة العرض القيم الصالحة هي ASSET_CLASS_ROAD_SIGN وASSET_CLASS_UTILITY_POLE وASSET_CLASS_MAINTENANCE_COVER.
location	STRUCT	بنية تحتوي على إحداثيات خطوط العرض/الطول كأرقام عائمة تمثّل الموقع الجغرافي التقريبي لمادة العرض.
detection_time	طابع زمني	أحدث ملاحظة capture_time لمادة العرض المحدّدة طابع زمني بتنسيق ISO 8601، مثل 2019-09-25 17:26:27.757171 UTC.

pano_observations_all

يوفّر الجدول pano_observations_all ملاحظات بانورامية (للمشهد الكامل) من جميع اللقطات. على عكس عمليات رصد مواد العرض، تحتوي عمليات الرصد البانورامية على بيانات وصفية للكاميرا على مستوى اللقطة واتجاه مكاني لأحداث التقاط الصور بزاوية 360 درجة بدلاً من عمليات رصد مواد العرض المترجَمة. يمكنك استخدام هذا الجدول لرصد الاختلافات في الملاحظات البانورامية بين اللقطات.

اسم العمود	النوع	الوصف
capture_id	سلسلة	معرّف فريد يمثّل حدث التقاط بانورامي واحد
observation_id	سلسلة	المعرّف الفريد لإطار صورة فردي يشكّل جزءًا واحدًا من لقطة بانورامية بزاوية 360 درجة.
snapshot_id	سلسلة	المعرّف الفريد للّقطة التي جمعت هذه الملاحظة
capture_location	STRUCT	بنية تحتوي على إحداثيات خط العرض/خط الطول كأرقام عائمة تمثّل النقطة المركزية للمركبة عند تسجيل الملاحظة
capture_time	طابع زمني	الطابع الزمني لوقت تسجيل الملاحظة طابع زمني بتنسيق ISO 8601، مثل 2019-09-25 17:26:27.757171 UTC.
camera_pose	STRUCT	موضع الكاميرا LLA وزوايا أويلر بنية تحتوي على قيم عائمة لخط العرض/خط الطول والارتفاع (بالأمتار) والميل والاتجاه والالتفاف (بالدرجات).
gcs_uri	سلسلة	معرّف الموارد المنتظم (URI) لخدمة Google Cloud Storage حيث تتم استضافة الصورة
map_url	سلسلة	عنوان URL في "خرائط Google" يعرض الموقع الجغرافي الذي تم فيه التقاط الصورة.
pano_id	سلسلة	المعرّف الفريد لصورة بانورامية مجمّعة بزاوية 360 درجة يمكن أن تكون هذه القيمة فارغة، وقد لا تكون متوفّرة. وإذا كان موجودًا، يمكن استخدامه كمفتاح وصول مع Google Maps Street View Static API.

pano_observations_latest

يوفّر جدول pano_observations_latest ملاحظات بانورامية (مشهد كامل) من أحدث لقطة فقط.

اسم العمود	النوع	الوصف
capture_id	سلسلة	معرّف فريد يمثّل حدث التقاط بانورامي واحد
observation_id	سلسلة	المعرّف الفريد لإطار صورة فردي يشكّل جزءًا واحدًا من لقطة بانورامية بزاوية 360 درجة.
snapshot_id	سلسلة	المعرّف الفريد للّقطة التي جمعت هذه الملاحظة
capture_location	STRUCT	بنية تحتوي على إحداثيات خط العرض/خط الطول كأرقام عائمة تمثّل النقطة المركزية للمركبة عند تسجيل الملاحظة
capture_time	طابع زمني	الطابع الزمني لوقت تسجيل الملاحظة طابع زمني بتنسيق ISO 8601، مثل 2019-09-25 17:26:27.757171 UTC.
camera_pose	STRUCT	موضع الكاميرا LLA وزوايا أويلر بنية تحتوي على قيم عائمة لخط العرض/خط الطول والارتفاع (بالأمتار) والميل والاتجاه والالتفاف (بالدرجات).
gcs_uri	سلسلة	معرّف الموارد المنتظم (URI) لخدمة Google Cloud Storage حيث تتم استضافة الصورة
map_url	سلسلة	عنوان URL في "خرائط Google" يعرض الموقع الجغرافي الذي تم فيه التقاط الصورة.
pano_id	سلسلة	المعرّف الفريد لصورة بانورامية مجمّعة بزاوية 360 درجة يمكن أن تكون هذه القيمة فارغة، وقد لا تكون متوفّرة. وإذا كان موجودًا، يمكن استخدامه كمفتاح وصول مع Google Maps Street View Static API.

الجداول المتوقّفة نهائيًا

ملاحظة: تم إيقاف الجداول all_observations وlatest_observations وall_assets وlatest_assets نهائيًا وستتم إزالتها في إصدار مستقبلي. استخدِم بدلاً من ذلك الجداول الخاصة بكل منتج والموضّحة في هذه الصفحة.