مرجع

این صفحه راهنمایی برای جدول‌های BigQuery مورداستفاده برای آموزش مدل‌ها ارائه می‌دهد، ازجمله طرح‌واره‌ها و شرح فیلدهای آن‌ها. همچنین تفکیکی از مفاهیم اصلی (عکس‌های آنی، دارایی‌ها، و مشاهدات) که داده‌ها را ساختار می‌دهند، به‌همراه جزئیاتی درباره نحوه استفاده از جدول‌ها در موارد مرتبط، پیدا خواهید کرد.

نام جدول‌ها با پیشوند نوع محصول (cropped_، full_frame_، یا pano_) شروع می‌شود و فقط جدول‌های مربوط به محصولات موجود در اشتراک‌هایتان در مجموعه داده شما وجود دارد. جدول‌هایی که به _all ختم می‌شوند شامل داده‌های همه عکس‌های آنی هستند و جدول‌هایی که به _latest ختم می‌شوند فقط شامل داده‌های جدیدترین عکس آنی هستند.

مفاهیم اصلی

• عکس آنی: نسخه‌ای ثابت و غیرقابل‌تغییر از مجموعه داده در لحظه‌ای خاص از زمان.
• دارایی: شیئی در دنیای واقعی، مثل تابلو راهنمایی یا تیر برق. دارایی‌ها برای محصولات برش‌خورده و تمام‌قاب دردسترس است.
• مشاهده: سابقه تصویری از رویداد ضبط. برای محصولات برش‌خورده و تمام‌قاب، مشاهده به‌معنای تشخیص دارایی است و حاوی فراداده‌های مربوط به آن تشخیص است، مانند زمان ثبت تصویر و موقعیت دوربین. برای محصول تمام‌نما، مشاهده عبارت است از قاب تصویر تکی از عکس ۳۶۰ درجه، و با دارایی مرتبط نیست.

snapshots

عکس آنی نسخه‌ای ثابت و غیرقابل‌تغییر از مجموعه داده در لحظه‌ای خاص از زمان است. جدول عکس آنی ابرداده‌های مرتبط با عکس‌های آنی را ارائه می‌دهد تا بتوانید وضعیت زمانی داده‌ها را در سطح بالا درک کنید.

نام ستون	نوع	شرح
snapshot_id	رشته	شناسه یکتای عکس آنی. به‌عنوان کلیدی برای پیوستن به جدول‌ها استفاده می‌شود.
subscription_id	رشته	شناسه یکتای اشتراک.
creation_time	مُهر زمان	مُهر زمان ایجاد عکس آنی. مهر زمان با قالب ISO 8601، مثلاً 2019-09-25 17:26:27.757171 UTC.
product_types	ARRAY<STRING>	انواع محصول مرتبط با عکس آنی.‫ مقادیر معتبر عبارت‌اند از 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	رشته	شناسه یکتا برای تصویر تمام‌نمای ۳۶۰ درجه به‌هم‌پیوسته. این مقدار می‌تواند تهی باشد؛ ممکن است وجود نداشته باشد. درصورت وجود، می‌توان از آن به‌عنوان کلید دسترسی با Google Maps Street View Static API استفاده کرد.
gcs_uri	رشته	Google Cloud Storage URI که تصویر در آن میزبانی می‌شود.
map_url	رشته	نشانی وب Google Maps که مکان دارایی را نشان می‌دهد.

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	رشته	شناسه یکتا برای تصویر تمام‌نمای ۳۶۰ درجه به‌هم‌پیوسته. این مقدار می‌تواند تهی باشد؛ ممکن است وجود نداشته باشد. درصورت وجود، می‌توان از آن به‌عنوان کلید دسترسی با Google Maps Street View Static API استفاده کرد.
gcs_uri	رشته	Google Cloud Storage URI که تصویر در آن میزبانی می‌شود.
map_url	رشته	نشانی وب Google Maps که مکان دارایی را نشان می‌دهد.

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	رشته	شناسه یکتا برای تصویر تمام‌نمای ۳۶۰ درجه به‌هم‌پیوسته. این مقدار می‌تواند تهی باشد؛ ممکن است وجود نداشته باشد. درصورت وجود، می‌توان از آن به‌عنوان کلید دسترسی با Google Maps Street View Static API استفاده کرد.
gcs_uri	رشته	Google Cloud Storage URI که تصویر در آن میزبانی می‌شود.
map_url	رشته	نشانی وب Google Maps که مکان دارایی را نشان می‌دهد.

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	رشته	شناسه یکتا برای تصویر تمام‌نمای ۳۶۰ درجه به‌هم‌پیوسته. این مقدار می‌تواند تهی باشد؛ ممکن است وجود نداشته باشد. درصورت وجود، می‌توان از آن به‌عنوان کلید دسترسی با Google Maps Street View Static API استفاده کرد.
gcs_uri	رشته	Google Cloud Storage URI که تصویر در آن میزبانی می‌شود.
map_url	رشته	نشانی وب Google Maps که مکان دارایی را نشان می‌دهد.

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 مشاهدات تمام‌نما (صحنه کامل) را از همه عکس‌های آنی ارائه می‌دهد. برخلاف مشاهدات دارایی، مشاهدات تمام‌نما حاوی فراداده دوربین در سطح قاب و جهت فضایی برای رویدادهای ضبط ۳۶۰ درجه است، نه تشخیص‌های دارایی محلی‌شده. می‌توانید از این جدول برای تشخیص تفاوت‌های مشاهدات پانورامایی بین عکس‌های آنی استفاده کنید.

نام ستون	نوع	شرح
capture_id	رشته	شناسه یکتایی که نشان‌دهنده یک رویداد ثبت سراسرنما است.
observation_id	رشته	شناسه یکتا برای قاب تصویر تکی که بخش واحدی از عکس تمام‌نمای ۳۶۰ درجه را تشکیل می‌دهد.
snapshot_id	رشته	شناسه یکتای عکس آنی که این مشاهده را جمع‌آوری کرده است.
capture_location	STRUCT	ساختاری حاوی مختصات عرض جغرافیایی/طول جغرافیایی به‌صورت اعداد اعشاری که نشان‌دهنده مرکز ثقل خودرو در زمان ثبت مشاهده است.
capture_time	مُهر زمان	مُهر زمان مربوط به وقتی که مشاهده ثبت شده است. مهر زمان با قالب ISO 8601، مثلاً 2019-09-25 17:26:27.757171 UTC.
camera_pose	STRUCT	موقعیت LLA دوربین و زاویه‌های اویلر. ساختار حاوی اعداد اعشاری برای عرض/طول جغرافیایی، ارتفاع (به متر)، زاویه عمودی، جهت، و زاویه افقی (به درجه).
gcs_uri	رشته	Google Cloud Storage URI که تصویر در آن میزبانی می‌شود.
map_url	رشته	نشانی وب Google Maps که مکان ثبت مشاهده را نشان می‌دهد.
pano_id	رشته	شناسه یکتا برای تصویر تمام‌نمای ۳۶۰ درجه به‌هم‌پیوسته. این مقدار می‌تواند تهی باشد؛ ممکن است وجود نداشته باشد. درصورت وجود، می‌توان از آن به‌عنوان کلید دسترسی با Google Maps Street View Static API استفاده کرد.

pano_observations_latest

جدول pano_observations_latest مشاهدات تمام‌نما (صحنه کامل) را فقط از جدیدترین عکس آنی ارائه می‌دهد.

نام ستون	نوع	شرح
capture_id	رشته	شناسه یکتایی که نشان‌دهنده یک رویداد ثبت سراسرنما است.
observation_id	رشته	شناسه یکتا برای قاب تصویر تکی که بخش واحدی از عکس تمام‌نمای ۳۶۰ درجه را تشکیل می‌دهد.
snapshot_id	رشته	شناسه یکتای عکس آنی که این مشاهده را جمع‌آوری کرده است.
capture_location	STRUCT	ساختاری حاوی مختصات عرض جغرافیایی/طول جغرافیایی به‌صورت اعداد اعشاری که نشان‌دهنده مرکز ثقل خودرو در زمان ثبت مشاهده است.
capture_time	مُهر زمان	مُهر زمان مربوط به وقتی که مشاهده ثبت شده است. مهر زمان با قالب ISO 8601، مثلاً 2019-09-25 17:26:27.757171 UTC.
camera_pose	STRUCT	موقعیت LLA دوربین و زاویه‌های اویلر. ساختار حاوی اعداد اعشاری برای عرض/طول جغرافیایی، ارتفاع (به متر)، زاویه عمودی، جهت، و زاویه افقی (به درجه).
gcs_uri	رشته	Google Cloud Storage URI که تصویر در آن میزبانی می‌شود.
map_url	رشته	نشانی وب Google Maps که مکان ثبت مشاهده را نشان می‌دهد.
pano_id	رشته	شناسه یکتا برای تصویر تمام‌نمای ۳۶۰ درجه به‌هم‌پیوسته. این مقدار می‌تواند تهی باشد؛ ممکن است وجود نداشته باشد. درصورت وجود، می‌توان از آن به‌عنوان کلید دسترسی با Google Maps Street View Static API استفاده کرد.

جدول‌های منسوخ‌شده

توجه: جدول‌های all_observations، latest_observations، all_assets، و latest_assets منسوخ شده‌اند و در نسخه پخش آتی برداشته خواهند شد. درعوض، از جدول‌های هر محصول که در این صفحه شرح داده شده است استفاده کنید.