הבדלים בין לוחות הזמנים של Google Transit ב-GTFS לבין לוחות הזמנים הרגילים

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

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

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

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

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

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

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

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

חלק מהמפרטים הרשמיים ש-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 שפונקציית Transit מתעלמת מהם בפיד הסטטי.

טבלה 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 טקסט
trips.txt bikes_allowed Enum

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

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

בטבלה 3 מוצגים השדות בפיד סטטי שמערכת 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 חסרה או שכל הערכים שלה למחיר הזה הם null, אז המחיר לא מוגבל בפרמטר הזה. אם השדה contains_route_id מצוין עבור מחיר, השדה route_id חייב להיות ריק.
routes.txt checkin_duration מספר שלם אופציונלי

תוסף Google Transit.

השדה checkin_duration מציין כמה שניות לפני מועד היציאה המתוכנן מומלץ להגיע כדי לבצע צ'ק-אין ולעלות למטוס.

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

הערך של checkin_duration הוא רק המלצה, שבדרך כלל ניתנת על ידי מפעיל התחבורה הציבורית. ייתכן שהיא לא תשקף את הרגע האחרון האפשרי שבו נוסע יכול להגיע ולעלות לרכב.
routes.txt route_type Enum חובה

תוסף Google Transit.

במאמר סוגי מסלולים מורחבים ב-GTFS מוסבר איך Google Transit מרחיבה את אפשרויות הערך של route_type שמקובלות ב-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 מכיל את הטקסט המילולי שכתוב על השלט של הפלטפורמה. לדוגמה, 'לכיוון מרכז העיר' ו'מזרח העיר וברוקלין'.

אפשר להגדיר בו-זמנית את השדה 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 נגזרים מהתקן של קבוצת המומחים בפרוטוקולי תחבורה באירופה (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.

אם השדה ticketing_stop_time_id מופיע בקובץ stop_times.txt, הוא מבטל את המזהה שמייצג את שעת העצירה למכירת כרטיסים באמצעות קישורי עומק.
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 מכיל את המזהה מקובץ GTFS‏ agency.txt.
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 מותאמים ל-case normalization.
trips.txt vehicle_category_id מזהה אופציונלי

תוסף Google Transit.

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

תוסף Google Transit.

זיהוי קטגוריית רכב.
vehicle_categories.txt vehicle_amenity_id מזהה אופציונלי

תוסף Google Transit.

מזהה קבוצה של שירותים זמינים לכל הנוסעים בקטגוריית הרכב. לחלופין, אפשר לעיין בקטע vehicle_category_amenities.txt כדי לבדוק מתי זמינות חבילות שירות שונות באותה קטגוריית רכב.
vehicle_amenities.txt vehicle_amenity_id מזהה חובה

תוסף Google Transit.

מזהה קבוצה של שירותים.
vehicle_amenities.txt ac_availability Enum אופציונלי

תוסף Google Transit.

האפשרות הזו קובעת אם יש מיזוג אוויר.

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

  • 0. ברירת המחדל. לא ידוע.
  • 1. זמין בכל מקום ובכל זמן.
  • 2. לא זמין.
vehicle_amenities.txt toilet_availability Enum אופציונלי

תוסף Google Transit.

מגדיר אם יש שירותים ברכב.

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

  • 0. ברירת המחדל. לא ידוע.
  • 1. זמין בכל מקום ובכל זמן.
  • 2. לא זמין.
vehicle_amenities.txt gender_accessibility Enum אופציונלי

תוסף Google Transit.

מגדיר אם חלות הגבלות מגדר.

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

  • 0. ברירת המחדל. לא ידוע.
  • 1. אין הגבלות מגדר.
  • 2. מוגבל לנשים בלבד.
  • 3. מוגבל לגברים בלבד.
vehicle_amenities.txt seat_type Enum אופציונלי

תוסף Google Transit.

הגדרת סוג המושב.

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

  • 0. ברירת המחדל. מושב (לא מתקפל, יכול להיות עם אפשרות להטיה לאחור).
  • 1. מיטה קבועה (לא ניתן להטות אותה לאחור כספה).
  • 2. מושב מתכוונן לאחור.
vehicle_amenities.txt service_class Enum אופציונלי

תוסף Google Transit.

מגדיר את מחלקת המושב.

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

  • 0. ברירת המחדל. לא ידוע.
  • 1. מחלקה ראשונה.
  • 2. מחלקה שנייה.
  • 3. מחלקה שלישית.
  • 4. עסק.
  • 5. מחלקת תיירים פלוס.
  • 6. משלוח בסיסי.
vehicle_amenities.txt service_class_code מחרוזת אופציונלי

תוסף Google Transit.

הגדרת קוד סיווג קצר (למשל 1A למחלקה ראשונה עם מיזוג אוויר). השדה הזה הוא גרסה ספציפית יותר של השדה class, שבו אפשר לציין את הכיתות שלא זמינות ב-enum של הכיתה.
vehicle_amenities.txt seat_plug Enum אופציונלי

תוסף Google Transit.

ההגדרה קובעת אם יש שקע חשמלי או שקע USB (מכל סוג) בספסל.

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

  • 0. ברירת המחדל. לא ידוע.
  • 1. זמין בכל המושבים.
  • 2. לא זמין.
vehicle_amenities.txt row_layout_summary מחרוזת אופציונלי

תוסף Google Transit.

הגדרת מספר המושבים או המיטות בשורה אחת ברכב. לדוגמה: '2' (2 מושבים בשורה, אבל לא ידוע אם הם מופרדים או זה לצד זה), '1+1' (2 מושבים נפרדים בשורה), '2+2' (4 מושבים בשורה עם הפרדה באמצע).
vehicle_amenities.txt row_leg_space Enum אופציונלי

תוסף Google Transit.

מגדיר אם יש בשורות מקום נוסף לרגליים.

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

  • 0. ברירת המחדל. לא ידוע / לא רלוונטי.
  • 1. מרחב רגליים רגיל.
  • 2. מקום נוסף לרגליים.
vehicle_category_amenities.txt vehicle_category_id מזהה חובה

תוסף Google Transit.

משמש לזיהוי קטגוריית הרכב. אפשר לחזור על הערך של השדה הזה בכמה שורות כדי לשייך לאותה קטגוריית רכב כמה קבוצות של שירותים. האפשרות הזו שימושית בדרך כלל כשקטגוריית רכב מסוימת כוללת סיווגים שונים של שירות.
vehicle_category_amenities.txt vehicle_amenity_id מזהה חובה

תוסף Google Transit.

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