הבדלים ומסמך עזר בנושא GTFS Realtime של Google Transit

בדף הזה מתוארים ההבדלים העיקריים בין ההטמעה הרשמית של GTFS בזמן אמת לבין ההטמעה של Google Transit של המפרט בתחומים הבאים:

  • מפרטים רשמיים שנדחו: השדות האלה הם חלק מה-GTFS הרשמי. מערכת Google Transit מטמיעה את הנתונים האלה ללא שגיאות, אבל לא משתמשת בהם באופן יזום.

  • פרשנות שונה: השדות האלה כוללים את החלקים של ה-GTFS הרשמי שמערכת Google Transit מפרשת בצורה שונה מההגדרה של החלקים האלה ב-GTFS.

  • תמיכה ניסיונית: השדות האלה הם ניסיוניים בהטמעה של Google Transit. אם אתם רוצים להטמיע שדה ניסיוני חדש, תוכלו לפנות אל צוות התחבורה הציבורית של Google.

  • תוסף נתמך של Google Transit: התוסף הזה לא נכלל ב-GTFS הרשמי. התוסף שתומך בתחבורה הציבורית כולל גם תוספים ציבוריים וגם תוספים ספציפיים ל-Google Transit. כל שותף יכול לשלוח את המידע הזה אל Transit בפיד שלו.

תחבורה ציבורית בזמן אמת

בקטעים הבאים מפורטים ההבדלים העיקריים בין ההטמעה הרשמית של GTFS לבין ההטמעה של Google Transit של פיד התחבורה הציבורית בזמן אמת.

התעלמות ממפרטים רשמיים בפיד בזמן אמת

חלק מהמפרטים שנדחים הם ניסיוניים. מידע נוסף זמין באתר gtfs.org.

בטבלה 1 מפורטים השדות שמוגדרים ב-GTFS ותחבורה ציבורית מתעלמת מהם בפידים בזמן אמת.

טבלה 1. שדות רשמיים שהמערכת מתעלמת מהם בפידים בזמן אמת
הודעה שדה מוגדר ב-GTFS שאנחנו מתעלמים ממנו סוג שדה
message Alert image TranslatedImage
message Alert image_alternative_text TranslatedString
message Alert severity_level Enum
message Alert tts_description_text אב
message Alert tts_header_text אב
message CarriageDetails id מחרוזת
message CarriageDetails occupancy_percentage int32
message Position bearing מספר ממשי (float)
message Position odometer כפול
message Position speed מספר ממשי (float)
message Shape encoded_polyline מחרוזת
message Shape shape_id מחרוזת
message StopTimeUpdate (ב-TripUpdate) arrival.uncertainty int32
message StopTimeUpdate (ב-TripUpdate) stop_time_properties אב
message TripUpdate trip_properties אב
message TripUpdate vehicle VehicleDescriptor
message VehicleDescriptor license_plate מחרוזת
message VehicleDescriptor wheelchair_accessible WheelchairAccessible
message VehiclePosition congestion_level Enum
message VehiclePosition current_status VehicleStopStatus
message VehiclePosition current_stop_sequence uint32
message VehiclePosition multi_carriage_details.id מחרוזת
message VehiclePosition occupancy_percentage uint32
message VehiclePosition stop_id מחרוזת

פרשנות שונה בפיד בזמן אמת

אמנם Transit מקבל שדות מסוימים של GTFS, אבל הוא מפרש אותם באופן שונה מ-GTFS.

בטבלה 2 מפורטים שדות שהוגדרו על ידי GTFS בפידים בזמן אמת, שיכולים להיות אופציונליים או נדרשים באופן מותנה על ידי Transit. בשדות האופציונליים, בטבלה מצוין אם Transit תומך בערכי ה-enum או לא.

טבלה 2. שדות של פידים בזמן אמת שפורשים בצורה שונה
שם קובץ שדה שמוגדר ב-GTFS סוג שדה האם נדרש ל-Google Transit? פרטי ההטמעה של Google Transit
message StopTimeUpdate (ב-TripUpdate) stop_id מחרוזת נדרש באופן מותנה

כשמציינים מחרוזת stop_id, היא צריכה לעמוד באחד מהתנאים הבאים:

  • מחרוזת stop_id חייבת להיות זהה למחרוזת בקובץ stops.txt בפיד GTFS המתאים.
  • אם משתמשים במחרוזת stop_id שונה, המחרוזת stop_id שצוינה צריכה להיות אחות או בת של המחרוזת stop_id המקורית שצוינה ב-GTFS הסטטי. צריך לספק גם את השדה stop_sequence התואם.
message StopTimeUpdate schedule_relationship Enum אופציונלי

ב-Google Transit יש תמיכה בערכי enum הבאים:

  • SCHEDULED
  • SKIPPED
  • NO_DATA
message TripDescriptor schedule_relationship Enum אופציונלי

מערכת Google Transit לא תומכת בערכי enum הבאים:

  • DUPLICATED
  • CANCELED – כשהיא לא לצורך תיעוד ב-TripUpdate

Google תומכת בערכי enum הבאים:

  • SCHEDULED
  • UNSCHEDULED
  • ADDED
  • CANCELED – יש תמיכה רק ברשומות TripUpdate

תמיכה ניסיונית בפידים בזמן אמת

אם אתם צריכים עזרה בשילוב של שדות ניסיוניים חדשים, תוכלו לפנות אל Google Transit.

תוספי Google Transit נתמכים בפיד בזמן אמת

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