חומרי עזר

במאמר הזה מפורטות הטבלאות ב-BigQuery שמשמשות לאימון מודלים, כולל הסכימות ותיאורי השדות שלהן. בנוסף, תמצאו פירוט של המושגים המרכזיים – תמונות מצב, נכסים ותצפיות – שלפיהם הנתונים מאורגנים, וגם פרטים על אופן השימוש בטבלאות במקומות הרלוונטיים.

שמות הטבלאות מתחילים בסוג המוצר (cropped_,‏ full_frame_ או pano_), ורק הטבלאות של המוצרים שכלולים במינויים שלכם מופיעות במערך הנתונים. טבלאות שמסתיימות ב-_all כוללות נתונים מכל תמונות המצב, וטבלאות שמסתיימות ב-_latest כוללות נתונים רק מתמונת המצב האחרונה.

מושגי ליבה

• תמונת מצב: עותק קבוע שלא ניתן לשינוי של קבוצת נתונים בנקודת זמן מסוימת.
• נכס: אובייקט בעולם האמיתי, כמו תמרור או עמוד חשמל. הנכסים זמינים למוצרים חתוכים ולמוצרים בפריים מלא.
• תצפית: רשומת תמונה מאירוע צילום. במוצרים עם תמונות חתוכות ותמונות בפריים מלא, תצפית היא זיהוי של נכס, והיא מכילה מטא-נתונים לזיהוי הזה, כמו השעה שבה התמונה צולמה ומיקום המצלמה. במוצר הפנורמי, תצפית היא פריים של תמונה בודדת בצילום של 360 מעלות, והיא לא משויכת לנכס.

snapshots

"תמונת מצב" היא עותק קבוע שלא ניתן לשינוי של קבוצת נתונים בנקודת זמן מסוימת. בטבלה של תמונת המצב מופיעים מטא-נתונים שמשויכים לסיכומי Snapshot כאלה, כדי שתוכלו להבין מה המצב הזמני של הנתונים ברמה גבוהה.

שם העמודה	סוג	תיאור
snapshot_id	STRING	מזהה ייחודי של תמונת המצב. משמש כמפתח שמאחד בין הטבלאות.
subscription_id	STRING	המזהה הייחודי של המינוי.
creation_time	חותמת זמן	חותמת הזמן של מועד יצירת קובץ ה-snapshot. חותמת זמן בפורמט 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	רכיב של של Structs שמכילים את קואורדינטות ה-x/y שמתאימות לתיבה התוחמת של הנכס.
camera_pose	STRUCT	מיקום המצלמה – קווי אורך ורוחב, גובה וזוויות אוילר. רכיב שמכיל מספרים ממשיים לציון קו רוחב/קו אורך, גובה (במטרים), הטיה, כיוון וגלגול (במעלות).
capture_time	חותמת זמן	חותמת הזמן של מועד התצפית. חותמת זמן בפורמט ISO 8601, למשל 2019-09-25 17:26:27.757171 UTC.
pano_id	מחרוזת	מזהה ייחודי של תמונה פנורמית ב-360 מעלות. הערך הזה יכול להיות null, כלומר יכול להיות שהוא לא יופיע. אם הוא קיים, אפשר להשתמש בו כמפתח גישה באמצעות Google Maps Street View Static API.
gcs_uri	מחרוזת	ה-URI של Google Cloud Storage שבו התמונה מתארחת.
map_url	מחרוזת	כתובת URL במפות Google שמראה את המיקום של הנכס.

cropped_assets_all

בטבלה cropped_assets_all מוצגים נכסים חתוכים מכל תמונות המצב. אתם יכולים להיעזר בטבלה הזו כדי לזהות הבדלים בנכסים בין תמונות המצב.

שם העמודה	סוג	תיאור
asset_id	STRING	המזהה הייחודי של הנכס.
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	רכיב של של Structs שמכילים את קואורדינטות ה-x/y שמתאימות לתיבה התוחמת של הנכס.
camera_pose	STRUCT	מיקום המצלמה – קווי אורך ורוחב, גובה וזוויות אוילר. רכיב שמכיל מספרים ממשיים לציון קו רוחב/קו אורך, גובה (במטרים), הטיה, כיוון וגלגול (במעלות).
capture_time	חותמת זמן	חותמת הזמן של מועד התצפית. חותמת זמן בפורמט ISO 8601, למשל 2019-09-25 17:26:27.757171 UTC.
pano_id	מחרוזת	מזהה ייחודי של תמונה פנורמית ב-360 מעלות. הערך הזה יכול להיות null, כלומר יכול להיות שהוא לא יופיע. אם הוא קיים, אפשר להשתמש בו כמפתח גישה באמצעות Google Maps Street View Static API.
gcs_uri	מחרוזת	ה-URI של Google Cloud Storage שבו התמונה מתארחת.
map_url	מחרוזת	כתובת URL במפות Google שמראה את המיקום של הנכס.

cropped_assets_latest

בטבלה cropped_assets_latest מוצגים נכסים חתוכים רק מתמונת המצב העדכנית ביותר.

שם העמודה	סוג	תיאור
asset_id	STRING	המזהה הייחודי של הנכס.
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	רכיב של של Structs שמכילים את קואורדינטות ה-x/y שמתאימות לתיבה התוחמת של הנכס.
camera_pose	STRUCT	מיקום המצלמה – קווי אורך ורוחב, גובה וזוויות אוילר. רכיב שמכיל מספרים ממשיים לציון קו רוחב/קו אורך, גובה (במטרים), הטיה, כיוון וגלגול (במעלות).
capture_time	חותמת זמן	חותמת הזמן של מועד התצפית. חותמת זמן בפורמט ISO 8601, למשל 2019-09-25 17:26:27.757171 UTC.
pano_id	מחרוזת	מזהה ייחודי של תמונה פנורמית ב-360 מעלות. הערך הזה יכול להיות null, כלומר יכול להיות שהוא לא יופיע. אם הוא קיים, אפשר להשתמש בו כמפתח גישה באמצעות 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	STRING	המזהה הייחודי של הנכס.
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	רכיב של של Structs שמכילים את קואורדינטות ה-x/y שמתאימות לתיבה התוחמת של הנכס.
camera_pose	STRUCT	מיקום המצלמה – קווי אורך ורוחב, גובה וזוויות אוילר. רכיב שמכיל מספרים ממשיים לציון קו רוחב/קו אורך, גובה (במטרים), הטיה, כיוון וגלגול (במעלות).
capture_time	חותמת זמן	חותמת הזמן של מועד התצפית. חותמת זמן בפורמט ISO 8601, למשל 2019-09-25 17:26:27.757171 UTC.
pano_id	מחרוזת	מזהה ייחודי של תמונה פנורמית ב-360 מעלות. הערך הזה יכול להיות null, כלומר יכול להיות שהוא לא יופיע. אם הוא קיים, אפשר להשתמש בו כמפתח גישה באמצעות 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	STRING	המזהה הייחודי של הנכס.
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	מיקום המצלמה – קווי אורך ורוחב, גובה וזוויות אוילר. רכיב שמכיל מספרים ממשיים לציון קו רוחב/קו אורך, גובה (במטרים), הטיה, כיוון וגלגול (במעלות).
gcs_uri	מחרוזת	ה-URI של Google Cloud Storage שבו התמונה מתארחת.
map_url	מחרוזת	כתובת URL במפות Google שמראה את המיקום שבו צולמה התצפית.
pano_id	מחרוזת	מזהה ייחודי של תמונה פנורמית ב-360 מעלות. הערך הזה יכול להיות null, כלומר יכול להיות שהוא לא יופיע. אם הוא קיים, אפשר להשתמש בו כמפתח גישה באמצעות 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	מיקום המצלמה – קווי אורך ורוחב, גובה וזוויות אוילר. רכיב שמכיל מספרים ממשיים לציון קו רוחב/קו אורך, גובה (במטרים), הטיה, כיוון וגלגול (במעלות).
gcs_uri	מחרוזת	ה-URI של Google Cloud Storage שבו התמונה מתארחת.
map_url	מחרוזת	כתובת URL במפות Google שמראה את המיקום שבו צולמה התצפית.
pano_id	מחרוזת	מזהה ייחודי של תמונה פנורמית ב-360 מעלות. הערך הזה יכול להיות null, כלומר יכול להיות שהוא לא יופיע. אם הוא קיים, אפשר להשתמש בו כמפתח גישה באמצעות Google Maps Street View Static API.

טבלאות שהוצאו משימוש

הערה: הטבלאות all_observations,‏ latest_observations,‏ all_assets ו-latest_assets הוצאו משימוש ויוסרו בגרסה עתידית. במקום זאת, צריך להשתמש בטבלאות לכל מוצר שמתוארות בדף הזה.