הבדלים בין לוחות הזמנים של 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 של Transit-supported.

ההבדלים בין השדות 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.