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

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

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

הגדרת BigQuery

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

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

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

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

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

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

historical_roads_data_PROJECT_NUMBER.

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

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

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

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

טבלה של recent_roads_data

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

בניגוד לטבלה historical_travel_time, הטבלה הזו מכילה גם נתונים של SpeedReadingInterval. זו הסכימה ב-BigQuery:

שם מצב סוג תיאור
selected_route_id יכול להיות ריק מחרוזת selected_route_id של המסלול
השם_המוצג יכול להיות ריק מחרוזת השם המוצג של המסלול
record_time יכול להיות ריק חותמת זמן חותמת הזמן שבה מחושבים נתוני המסלול
duration_in_seconds יכול להיות ריק מספר ממשי (float) משך המסלול עם התחשבות בעומסי התנועה
static_duration_in_seconds יכול להיות ריק מספר ממשי (float) משך המסלול בלי להתחשב בעומס התנועה
route_geometry יכול להיות ריק GEOGRAPHY הגיאומטריה של הקו הפוליגוני של המסלול, שמתעדכנת בהתאם לתנועה
speed_reading_intervals מרובה ערכים רשומה מרווחים שמייצגים את צפיפות התנועה לאורך המסלול. אפשר לראות את ההגדרה המקורית ב-Routes API
speed_reading_intervals.interval_coordinates מרובה ערכים GEOGRAPHY הגיאומטריה של המרווח הזה
speed_reading_intervals.speed יכול להיות ריק מחרוזת הסיווג של המהירות במרווח הזה. ערכים אפשריים: NORMAL, ‏ SLOW, ‏ TRAFFIC_JAM

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

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

טבלה של routes_status

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

שם מצב סוג תיאור
selected_route_id יכול להיות ריק מחרוזת selected_route_id של המסלול
השם_המוצג יכול להיות ריק מחרוזת השם המוצג של המסלול
סטטוס* יכול להיות ריק מחרוזת סטטוס המסלול
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, צריך להמתין עד שעה עד שהמסלול שנבחר יוסר מהטבלה הזו.