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

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

נתוני הכבישים המצטברים מוצגים כנתונים של סדרת זמנים, שכוללים:

הגדרת BigQuery

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

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

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

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

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

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

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 Hub). כדי לגשת לנתונים, צריך להירשם ל-data exchange וליצור מערך נתונים מקושר בפרויקט ב-Google Cloud.

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

טבלה של historical_travel_time

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

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

התנהגויות ועובדות בטבלה

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

טבלה של 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) משך המסלול בהתאם לתנועה. הושמט (NULL) כאשר has_road_closure הוא true.
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 מרובה ערכים רשומה מרווחים של קריאת מהירות שמבוססים על היסט ומייצגים את צפיפות התנועה לאורך המסלול. כל מרווח תחום על ידי היסט המרחק מתחילת המסלול. השדה מושמט כשהערך של has_road_closure הוא true. למידע על מרווחי הזמן של קריאת המהירות
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)
has_road_closure יכול להיות ריק בוליאני אם יש סגירת כביש מלאה במסלול. כאשר true, duration_in_seconds ו-speed_reading_offsets מושמטים כי המסלול לא עביר. הערך NULL מציין שאין מידע על סגירת הכביש.

התנהגויות ועובדות בטבלה

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

טבלה של routes_status

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

שם מצב סוג תיאור
selected_route_id יכול להיות ריק מחרוזת selected_route_id מהמסלול
השם_המוצג יכול להיות ריק מחרוזת השם המוצג של המסלול
status* יכול להיות ריק מחרוזת סטטוס המסלול
validation_error יכול להיות ריק מחרוזת שגיאת אימות של המסלול
low_road_usage_start_time יכול להיות ריק חותמת זמן השעה שבה זוהה לראשונה שימוש מועט בנתיב במהלך האימות מחדש. היא משויכת ל-VALIDATION_ERROR_LOW_ROAD_USAGE.
route_attributes יכול להיות ריק מחרוזת מאפיינים מותאמים אישית של המסלול שנבחר
dynamic_routing יכול להיות ריק בוליאני מציין אם המסלול דינמי (true) או קבוע (false). מידע נוסף זמין במאמר dynamicRouting.
origin יכול להיות ריק GEOGRAPHY נקודת המוצא של המסלול
destination יכול להיות ריק GEOGRAPHY נקודת הציון של היעד במסלול
חומרי ביניים מרובה ערכים GEOGRAPHY נקודות ציון ביניים במסלול
static_route_geometry יכול להיות ריק GEOGRAPHY הגיאומטריה של הקו הפוליגוני של המסלול הסטטי, שמחושב בלי תנועה בזמן אמת מנקודות הדרך
road_segment_ids מרובה ערכים מחרוזת קטעי הכביש לאורך המסלול הסטטי שחושב בלי תנועה בזמן אמת, מיוצגים כמזהי מקומות

התנהגויות ועובדות בטבלה

  • הטבלה הזו כוללת רק נתיבים בסטטוס STATUS_RUNNING או STATUS_INVALID.
  • הסטטוס והמטא-נתונים של המסלולים מתעדכנים כל שעה, ללא הפסקה.
  • אחרי שיוצרים מסלול חדש ב-Roads Selection API, צריך להמתין עד שעה כדי לראות את המסלול זמין בטבלה הזו.
  • אחרי שמוחקים מסלול מ-Roads Selection API, צריך להמתין עד שעה כדי לראות שהמסלול שנבחר הוסר מהטבלה הזו.
  • במסלולים קבועים (dynamic_routing: false), מזהי המקומות ב-road_segment_ids מתעדכנים באופן אוטומטי כדי לשקף שינויים ברשת הכבישים של Google, ועדיין מייצגים את אותו מסלול. בנתיבים דינמיים (dynamic_routing: true), השדה road_segment_ids לא מתעדכן.