נתוני כבישים מצטברים

נתוני דרכים מצטברים הם נתונים שאפשר לבנות לאורך זמן עבור המסלולים שבחרתם. הנתונים מתחילים להתקבל אחרי שיוצרים מסלול באמצעות Roads Selection API. אפשר להשתמש בנתונים האלה לניתוח מעמיק, לתכנון אסטרטגי ולהבנת ההתנהגות של המסלולים לאורך זמן.

נתוני הכבישים המצטברים מסופקים כנתונים של פעולות על ציר הזמן, שכוללים:

• משך הנסיעה
• מרווחי זמן לקריאה מהירה (SRI)
• הגיאומטריה של המסלול

הגדרת BigQuery

כדי לגשת לנתוני הכבישים ב-BigQuery, צריך להגדיר את פרויקט Google Cloud ולהירשם ל-Data Exchange.

דרישות מוקדמות

מוודאים שהפרויקט והחשבון ב-Google Cloud מוגדרים באופן הבא:

1. מפעילים את BigQuery API. הוראות מפורטות זמינות במאמר בנושא הפעלת שאילתה במערך נתונים ציבורי באמצעות מסוף Google Cloud.
2. מפעילים את Analytics Hub API. מידע נוסף על Analytics Hub API
3. הקצאת תפקידי IAM נדרשים. כדי לבצע משימות של מנויים וליצור מערכי נתונים, ודאו שבחשבון שלכם יש את התפקידים הבאים:
4. מנוי של Analytics Hub (roles/analyticshub.subscriber)
   • משתמש BigQuery (roles/bigquery.user)

הרשמה לחילופי הנתונים

הנתונים על הכבישים משותפים איתכם באמצעות חילופי נתונים פרטיים ב-BigQuery (מרכז Analytics). כדי לגשת לנתונים, תקבלו קישור ספציפי להרשמה מ-Google partner. מערך הנתונים הזה עומד במוסכמת השמות הבאה:

historical_roads_data_PROJECT_NUMBER.

כדי להירשם לנתונים:

1. לוחצים על קישור ההרשמה שסופק על ידי שותף Google. הקישור הזה יוביל אתכם ישירות לאוסף נתונים לשיתוף במסוף Google Cloud.
2. בודקים את פרטי חילופי הנתונים במסוף Google Cloud.
3. לוחצים על הלחצן הרשמה בתיבת הדו-שיח.
4. בסיום ההרשמה, מערך הנתונים המקושר מופיע בחלונית Explorer של BigQuery במסוף Google Cloud. עכשיו אתם יכולים להשתמש בשמות הטבלאות שמופיעים בחלונית Explorer כדי לגשת לנתונים בשאילתות SQL.

טבלאות ב-BigQuery

נתוני הדרכים שנצברו במסלולים שבחרתם מתארחים במערך נתונים מבודד ב-BigQuery, בפרויקט בענן שבבעלות Google. הנתונים משותפים איתכם באמצעות אוסף נתונים לשיתוף פרטי שנוצר במיוחד בשבילכם ב-BigQuery sharing (מרכז Analytics). כדי לגשת לנתונים, צריך להירשם ל-Data Exchange וליצור מערך נתונים מקושר בפרויקט בענן של Google Cloud.

מערך הנתונים המשותף ב-BigQuery כולל כמה טבלאות ב-BigQuery שמוגדרות ונוצרות על ידי Google. בהמשך מפורטים הפרטים של כל טבלה.

טבלה של historical_travel_time

זו הסכימה של טבלת BigQuery‏ historical_travel_time:

שם	מצב	סוג	תיאור
selected_route_id	יכול להיות ריק	מחרוזת	selected_route_id מהמסלול
השם_המוצג	יכול להיות ריק	מחרוזת	השם המוצג של המסלול
record_time	יכול להיות ריק	חותמת זמן	חותמת הזמן שבה מחושבים נתוני המסלול
duration_in_seconds	יכול להיות ריק	מספר ממשי (float)	משך המסלול בהתחשב בעומס התנועה
static_duration_in_seconds	יכול להיות ריק	מספר ממשי (float)	משך המסלול בלי להתחשב בתנועה
route_geometry	יכול להיות ריק	GEOGRAPHY	הגיאומטריה של הקו הפוליגוני של המסלול, שמתחשבת בתנועה
road_segment_ids	מרובה ערכים	מחרוזת	מקטעי הכביש לאורך המסלול, שמיוצגים כמזהי מקומות

התנהגויות ועובדות שקשורות לטבלאות

• הטבלה מחולקת למחיצות לפי יום, ומוגדרת לכל מחיצה תקופת תפוגה של 10 שנים.
• הטבלה מתעדכנת מדי שעה עם נתוני התנועה האחרונים שנכתבים בחבילות.
• אחרי שיוצרים מסלול חדש ב-Roads Selection API, צריך להמתין עד שעה כדי לראות את הנתונים שזמינים בטבלה הזו.
• אחרי שמסלול נמחק מ-Roads Selection API, לא נכתבים נתונים חדשים בטבלה הזו לגבי המסלול. עם זאת, הנתונים ההיסטוריים נשארים עד לתפוגה.
• קטעי הכביש לאורך המסלול מסודרים לפי סדר טופולוגי ותמיד מחוברים.

טבלה של recent_roads_data

הערה: הטבלה הזו זמינה רק אם החוזה שלכם כולל נתוני כבישים בזמן אמת.

בניגוד ל-historical_travel_time, הטבלה הזו מכילה גם מרווחי קריאת מהירות מבוססי-היסט (speed_reading_offsets) ומרווחי קריאת מהירות מבוססי-קואורדינטות מדור קודם (speed_reading_intervals). זו הסכימה ב-BigQuery:

שם	מצב	סוג	תיאור
selected_route_id	יכול להיות ריק	מחרוזת	selected_route_id מהמסלול
השם_המוצג	יכול להיות ריק	מחרוזת	השם המוצג של המסלול
record_time	יכול להיות ריק	חותמת זמן	חותמת הזמן שבה מחושבים נתוני המסלול
duration_in_seconds	יכול להיות ריק	מספר ממשי (float)	משך המסלול בהתחשב בעומס התנועה
static_duration_in_seconds	יכול להיות ריק	מספר ממשי (float)	משך המסלול בלי להתחשב בתנועה
route_geometry	יכול להיות ריק	GEOGRAPHY	הגיאומטריה של הקו הפוליגוני של המסלול, שמתחשבת בתנועה
speed_reading_intervals	מרובה ערכים	רשומה	מרווחי קריאת מהירות מבוססי-קואורדינטות מהדור הקודם. יכול להיות שהנתונים לא ימשיכו להתעדכן החל מ-9 בנובמבר 2026. במקום זאת, אתם צריכים להשתמש ב-speed_reading_offsets. למידע על מרווחי קריאת מהירות
speed_reading_intervals.interval_coordinates	מרובה ערכים	GEOGRAPHY	גרסה קודמת. יכול להיות שהנתונים לא ימשיכו להתעדכן החל מ-9 בנובמבר 2026. במקום זאת, אתם צריכים להשתמש ב-speed_reading_offsets. הגאומטריה של המרווח הזה
speed_reading_intervals.speed	יכול להיות ריק	מחרוזת	מדור קודם. יכול להיות שהשדה יפסיק להתמלא ב-9 בנובמבר 2026 או אחרי התאריך הזה. במקום זאת, אתם צריכים להשתמש ב-speed_reading_offsets. הסיווג של המהירות במרווח הזה. ערכים אפשריים: NORMAL, ‏ SLOW, ‏ TRAFFIC_JAM. בשדה הקודם הזה, עומסי תנועה כבדים (אדום כהה) מדווחים גם בתור TRAFFIC_JAM, והערך TRAFFIC_JAM_HEAVY לא נמצא בשימוש אף פעם.
road_segment_ids	מרובה ערכים	מחרוזת	מקטעי הכביש לאורך המסלול, שמיוצגים כמזהי מקומות
speed_reading_offsets	מרובה ערכים	רשומה	מרווחי זמן לקריאת מהירות שמבוססים על היסט ומייצגים את צפיפות התנועה לאורך המסלול. כל מרווח מסומן על ידי היסט המרחק מנקודת ההתחלה של המסלול. מידע על מרווחי זמן של קריאה מהירה
speed_reading_offsets.start_offset	יכול להיות ריק	מספר שלם	המרחק מתחילת המסלול במטרים עד לתחילת המקטע (כולל)
speed_reading_offsets.end_offset	יכול להיות ריק	מספר שלם	ההיסט של המרחק מנקודת ההתחלה של המסלול במטרים לסוף המרווח (לא כולל; שווה ל-start_offset של המרווח הבא)
speed_reading_offsets.speed	יכול להיות ריק	מחרוזת	הסיווג של המהירות במרווח הזה, בהתאם לצבעים בשכבת התנועה במפות Google. ערכים אפשריים: NORMAL (ירוק), SLOW (צהוב), TRAFFIC_JAM (אדום), TRAFFIC_JAM_HEAVY (אדום כהה, זמין החל מ-8 באוקטובר 2026)

התנהגויות ועובדות שקשורות לטבלאות

• הטבלה מחולקת למחיצות לפי יום, ולכל מחיצה מוגדר תאריך תפוגה של 60 יום.
• הטבלה מתעדכנת כל שעה עם נתוני התנועה האחרונים שנכתבו באצווה.
• אחרי שיוצרים נתיב חדש ב-Roads Selection API, יכול להיות שיעבור עד שעה עד שהנתונים יהיו זמינים בטבלה הזו.
• אחרי שמסלול נמחק מ-Roads Selection API, לא ייכתבו נתונים חדשים בטבלה הזו לגבי המסלול. עם זאת, הנתונים ההיסטוריים נשמרים עד שהם פגים.
• קטעי הכביש לאורך המסלול מסודרים בסדר טופולוגי והם תמיד מחוברים.
• הנתונים בעמודה speed_reading_offsets מוצגים בשורות שמתייחסות להקלטות שבוצעו ב-8 באוקטובר 2026 או אחריו. בשורה הקודמת יש מערכים ריקים.
• יכול להיות שהעמודה הקודמת speed_reading_intervals תפסיק להתאכלס ב-9 בנובמבר 2026 או אחרי התאריך הזה. במקום זאת, אתם צריכים להשתמש ב-speed_reading_offsets.

טבלה של routes_status

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

שם	מצב	סוג	תיאור
selected_route_id	יכול להיות ריק	מחרוזת	selected_route_id מהמסלול
השם_המוצג	יכול להיות ריק	מחרוזת	השם המוצג של המסלול
status*	יכול להיות ריק	מחרוזת	סטטוס המסלול
validation_error	יכול להיות ריק	מחרוזת	שגיאת אימות של המסלול
low_road_usage_start_time	יכול להיות ריק	חותמת זמן	השעה שבה נצפה לראשונה שימוש נמוך בנתיב במהלך אימות מחדש. היא משויכת ל-VALIDATION_ERROR_LOW_ROAD_USAGE.
route_attributes	יכול להיות ריק	מחרוזת	מאפיינים מותאמים אישית של המסלול שנבחר

*סטטוס המסלול בטבלה הזו מתחיל ב-STATUS_ במקום ב-STATE_. חוץ מזה, הוא תואם ל-Roads Selection API.

התנהגויות ועובדות שקשורות לטבלאות

• בטבלה הזו נכללים רק מסלולים עם הסטטוס STATUS_RUNNING או STATUS_INVALID.
• המטא-נתונים והסטטוס של המסלולים מתעדכנים כל שעה, ללא הפסקה.
• אחרי שיוצרים נתיב חדש ב-Roads Selection API, צריך לחכות עד שעה עד שהנתיב יופיע בטבלה הזו.
• אחרי שמסלול נמחק מ-Roads Selection API, צריך להמתין עד שעה אחת עד שהמסלול שנבחר יוסר מהטבלה הזו.