מידע על לוח זמנים של GTFS ב-Google Transit והבדלים

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

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

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

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

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

תחבורה ציבורית סטטית

בקטעים הבאים מתואר ההבדלים העיקריים בין עדכון המידע הסטטיסטי (GTFS) הרשמי לבין ההטמעה של הפיד הסטטי ב-Google Transit.

המערכת מתעלמת ממפרטים רשמיים בפידים סטטיים

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

בטבלה 1 מפורטים קובצי GTFS שלא נתמכים ב-Transit בפידים סטטיים. כמו כן, אף אחד מהשדות שמוגדרים בקבצים האלה לא נתמך על ידי Transit.

טבלה 1. קובצי GTFS שאינם נתמכים בפידים סטטיים
areas.txt
fare_leg_rules.txt
fare_products.txt
fare_transfer_rules.txt
levels.txt
stop_areas.txt

בטבלה 2 מפורטים כל השדות שמוגדרים על ידי GTFS שהפידים הסטטיים מתעלמים מהם.

טבלה 2. שדות GTFS שהתעלמו מהם בפידים סטטיים
שם קובץ שדה שמוגדר ב-GTFS והמערכת מתעלמת ממנו סוג שדה
fare_attributes.txt payment_method טיפוסים בני מנייה (enum)
feed_info.txt default_lang קוד שפה
feed_info.txt feed_publisher_name טקסט
pathways.txt max_slope Float
routes.txt continuous_drop_off טיפוסים בני מנייה (enum)
routes.txt continuous_pickup טיפוסים בני מנייה (enum)
routes.txt network_id מזהה
routes.txt route_desc טקסט
routes.txt route_sort_order מספר שלם לא שלילי
stops.txt level_id מזהה
stops.txt stop_desc טקסט
stops.txt stop_url כתובת URL
stops.txt tts_stop_name טקסט
stops.txt bikes_allowed טיפוסים בני מנייה (enum)

פרשנות שונה בפידים סטטיים

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

בטבלה 3 מוצגים השדות בפידים סטטיים ש-Google Transit מטמיע באופן שונה ממה שמתואר בפיד המידע על תחבורה ציבורית (GTFS).

טבלה 3. שדות פיד סטטיים שהוטמעו באופן שונה
שם קובץ שדה שמוגדר ב-GTFS סוג שדה נדרש על ידי Google Transit? פרטי ההטמעה של Google Transit
fare_attributes.txt transfers טיפוסים בני מנייה (enum) נדרש

תוסף Google Transit.

ה-GTFS הציבורי מגביל ערכים ל-0 עד 2. ב-Google Transit מקבלים ערכים מ-0 עד 5.

בשדה הזה מגדירים את המספר המרבי של העברות מותרות עם מחיר הכרטיס. לא מדובר בהעברת בלוקים, שמכונים גם העברות בתוך המושבים. אם לא רוצים להגדיר מגבלות על מספר ההעברות של כרטיס מסוים, משאירים את השדה transfers ריק.
pathways.txt pathway_mode טיפוסים בני מנייה (enum) אופציונלי אם מציינים את השדה pathway_mode, אם הוא נשאר ריק, מערכת Google Transit מקבלת את הערך הזה ומתייחסת אליו כאל פריט לא ידוע.
stop_times.txt arrival_time שעה חובה לפי תנאים השעות מוגבלות לערכים מ-00 עד 99, וזה יותר ממספיק לנסיעות של שלושה ימים.
transfers.txt transfer_type טיפוסים בני מנייה (enum) נדרש

הערכים של 4 ושל 5 לא נתמכים והמערכת מתעלמת מהם.

Google Transit תומך בערכים 0, 1, 2 ו-3.
trips.txt block_id מזהה אופציונלי מידע נוסף זמין במאמר חסימת הדוגמה להעברה.

תמיכה ניסיונית בפידים סטטיים

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

תוספים שנתמכים על ידי Google Transit בפידים סטטיים

טבלה 4 מספקת מידע על התוספים של Google Transit. השדות האלה לא חלק מ-GTFS הרשמי.

טבלה 4. תוספי פיד סטטיים נתמכים
שם קובץ שדה סוג שדה נדרש על ידי Google Transit? פרטי ההטמעה של Google Transit
fare_attributes.txt ic_price Float אופציונלי

התוסף הזה של Google Transit זמין רק לשותפים ביפן.

השדה ic_price מייצג את סכום הכסף המוזל שיש לשלם על הכרטיס הזה באמצעות כרטיס חכם. אם לא סופקו הנחות למחיר הזה, או אם אין תמיכה בכרטיס החכם, הערך בשדה ic_price צריך להיות -1.
fare_rules.txt contains_route_id מזהה אופציונלי

תוסף Google Transit.

מחיר זה חל רק על נסיעות עם קבוצה מדויקת של מסלולים המזוהים על ידי הערך route_id בכל השורות עבור השילוב הזה של העמודות fare_id, origin_id ו-destination_id.

אם העמודה contains_route_id חסרה, או שכל הערכים שלה במאפיין הכרטיס הזה ריקים, מחיר הכרטיס לא מוגבל בפרמטר הזה. אם השדה contains_route_id צוין עבור מחיר, השדה route_id חייב להיות ריק.
routes.txt checkin_duration מספר שלם אופציונלי

תוסף Google Transit.

השדה checkin_duration מציין כמה שניות לפני הזמן אנחנו ממליצים לנוסע להגיע לפני מועד היציאה המתוכנן, כדי לעשות צ'ק-אין ועלייה למטוס.

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

הערך של checkin_duration הוא רק המלצה שמקבלים בדרך כלל על ידי חברת התחבורה הציבורית. זה לא תמיד משקף את הרגע האחרון האפשרי שבו נוסע יכול להגיע ועדיין לעלות על הרכב.
routes.txt route_type טיפוסים בני מנייה (enum) נדרש

תוסף Google Transit.

למידע נוסף על האופן שבו מערכת Google Transit מרחיבה את האפשרויות בנוגע לערכים המותרים של route_type GTFS, אפשר לעיין ב סוגי מסלולים מורחבים של GTFS.
stop_times.txt stop_direction_name טקסט אופציונלי

תוסף Google Transit.

השדה stop_direction_name מציין את כיוון הנסיעה לנוסעים. המסלול יישמר כערך direction_name של שעת היציאה מהתחנה הזו.

אם השדה stop_direction_name ריק, המערכת תשתמש בשדה trip_direction_name שנתמך בתחבורה ציבורית. אם השדות trip_direction_name ו-stop_direction_name ריקים, היבואן של התחבורה הציבורית ישאיר אותם ריקים. במקרה כזה, השותפים יכולים להשתמש בערך stop_headsign או trip_headsign במקום זאת. הערכים בשדה stop_direction_name מנורמלים באותיות רישיות.
stops.txt signposted_as טקסט אופציונלי

תוסף Google Transit.

השדה signposted_as מכיל את הטקסט המילולי שכתוב על לוח השלט של הפלטפורמה. הדוגמאות הן "Towards Central" ו-"East side & Brooklyn".

אפשר להגדיר בו-זמנית את השדה platform_code של כרטיס GTFS ואת השדה signposted_as שנתמך בתחבורה ציבורית.

ההבדלים בין השדה platform_code לבין השדה signposted_as כוללים:

  • אורך. השדה platform_code בדרך כלל מכיל מספר או אות כמו 2 או C.
  • שפה. בשדה platform_code אין שפה, אבל אפשר לתרגם ערכים בשדה signposted_as.
  • יציבות הערך בשדה platform_code משתנה הרבה פחות מאשר בשדה signposted_as.
stops.txt vehicle_type מספר שלם אופציונלי

תוסף Google Transit.

השדה vehicle_type מציין את סוג הרכבים שנעשה בהם שימוש בעצירה. בשדה הזה אפשר להזין את סוגי המסלולים של סוג הרכב ההיררכי (HVT). ערכי ה-HVT נגזרים מתקן European Transport Protocol Experts Group (TPEG).
agency.txt ticketing_deep_link_id מזהה אופציונלי

תוסף לרכישת כרטיסים של Google Transit.

בקובץ agency.txt, השדה ticketing_deep_link_id מייצג את קישור העומק המשמש לרכישת כרטיסי הנסיעה של הסוכנות הזו.
routes.txt ticketing_deep_link_id מזהה אופציונלי

תוסף לרכישת כרטיסים של Google Transit.

בקובץ routes.txt, השדה ticketing_deep_link_id מייצג את קישור העומק המשמש לרכישת הכרטיסים במסלול הזה.
stop_times.txt ticketing_stop_time_id מזהה אופציונלי

תוסף לרכישת כרטיסים של Google Transit.

אם קיים בקובץ stop_times.txt, השדה ticketing_stop_time_id מבטל את המזהה שמייצג את זמן הפסקת מכירת הכרטיסים באמצעות קישורי עומק.
stop_times.txt ticketing_type טיפוסים בני מנייה (enum) אופציונלי

תוסף לרכישת כרטיסים של Google Transit.

השדה ticketing_type מציין את סוג מכירת הכרטיסים שרלוונטי לשעת הפסקה הזו.

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

  • Empty. ברירת המחדל – כפי שמוגדר בנסיעה.
  • 0. האפשרות הזו זמינה רק אם לסוכנות או למסלול יש קישור עומק למכירת כרטיסים מופעל.
  • 1. לא זמין.
ticketing_deep_links.txt android_intent_uri URI אופציונלי

תוסף לרכישת כרטיסים של Google Transit.

השדה android_intent_uri מייצג את ה-URI של ה-Intent שמשמש ליצירת קישורי עומק ב-Android.
ticketing_deep_links.txt ios_universal_link_url כתובת URL אופציונלי

תוסף לרכישת כרטיסים של Google Transit.

השדה ios_universal_link_url מייצג את כתובת ה-URL האוניברסלית של הקישור, שמשמשת לקישורי עומק ב-iOS.
ticketing_deep_links.txt ticketing_deep_link_id מזהה נדרש

תוסף לרכישת כרטיסים של Google Transit.

השדה ticketing_deep_link_id מייצג את המזהה של קישור העומק.
ticketing_deep_links.txt web_url כתובת URL אופציונלי

תוסף לרכישת כרטיסים של Google Transit.

השדה web_url מייצג את כתובת ה-URL שמשמשת לקישורי עומק באינטרנט.
ticketing_identifiers.txt agency_id מזהה נדרש

תוסף לרכישת כרטיסים של Google Transit.

כדי לציין את הסוכנות שבה מוגדר השדה ticketing_stop_id כברירת המחדל, השדה agency_id מכיל את המזהה מהקובץ agency.txt של ה-GTFS.
ticketing_identifiers.txt stop_id מזהה נדרש

תוסף לרכישת כרטיסים של Google Transit.

כדי לציין את התחנה שעבורה מוגדר השדה ticketing_stop_id כברירת המחדל, השדה stop_id מכיל את המזהה מהקובץ stops.txt של ה-GTFS.
ticketing_identifiers.txt ticketing_stop_id מזהה נדרש

תוסף לרכישת כרטיסים של Google Transit.

השדה ticketing_stop_id מכיל את מזהה הכרטיס שמוחל על העצירה. לחלופין, סוכנות יכולה לאשר את המזהה.
trips.txt exceptional טיפוסים בני מנייה (enum) אופציונלי

השדה הזה מציין נסיעות יוצאות דופן. הם פועלים מחוץ ללוח הזמנים הרגיל או שהם מוטים מהמסלול הרגיל עקב אירועים מיוחדים או שיבושים מתוכננים (כמו עבודות מעקב וכו').

Google מקבלת את אפשרויות הערכים הבאות:

  • 0. שירותים רגילים
  • 1. חריגת שירות. לדוגמה, שירותים שנוספו עקב אירועים או שירותים מיוחדים הוחרגו מהמסלול הרגיל עקב שיבושים מתוכננים.
trips.txt ticketing_trip_id מזהה אופציונלי

תוסף לרכישת כרטיסים של Google Transit.

אם השדה ticketing_trip_id קיים, הערך שלו מבטל את השדה trip_id כדי לזהות את הנסיעה למכירת כרטיסים באמצעות קישורי עומק.
trips.txt ticketing_type טיפוסים בני מנייה (enum) אופציונלי

תוסף לרכישת כרטיסים של Google Transit.

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

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

  • 0. ברירת מחדל. האפשרות הזו זמינה רק אם לסוכנות או למסלול יש קישור עומק של מכירת כרטיסים מופעל.
  • 1. לא זמין.
translations.txt lang קוד שפה אופציונלי

תוסף Google Transit.

השדה lang הוא לא חלק מה-GTFS הרשמי, אבל Google Transit משתמש בערך הזה אם הוא קיים.

כדי לציין את התרגום של ביטוי, משתמשים בשדה lang. הערך לא יכול להיות ריק או und (שפה לא מוגדרת).
translations.txt trans_id מזהה אופציונלי

תוסף Google Transit.

השדה trans_id הוא לא חלק מה-GTFS הרשמי, אבל המערכת של Google Transit משתמשת בערך הזה אם הוא קיים.

כדי לציין את האסימון המזהה של הביטוי שעבורו סופק התרגום, משתמשים בשדה trans_id. כל שורה בטבלה translations.txt מציינת שבשפה lang, הביטוי trans_id מתורגם לtranslation.
trips.txt original_trip_id מזהה אופציונלי

תוסף Google Transit.

אם הוא נמצא בקובץ trips.txt, הערך של original_trip_id מבטל את הערך של trip_id שישמש מערכות אחרות. דוגמה לכך היא התאמה בזמן אמת.
trips.txt trip_direction_name טקסט אופציונלי

תוסף Google Transit.

השדה trip_direction_name מציין את כיוון הנסיעה לנוסעים. הערך בשדה הזה יאוחסן כערך direction_name של כל נסיעה.

אם הערך stop_direction_name בטבלה stop_times ישתנה לאורך הנסיעה, הוא עשוי לשנות את הערך trip_direction_name.

הערכים בשדה trip_direction_name מנורמלים לפי אותיות רישיות.
trips.txt vehicle_category_id מזהה אופציונלי

תוסף Google Transit.

בקובץ trips.txt, השדה vehicle_category_id מזהה את הרכב שהוקצה לנסיעה הזו. כשהשדה הזה נמצא בקובץ trips.txt, הערך שלו מבטל את הערך של vehicle_category_id שבקובץ routes.txt.