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

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

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

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

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

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

העברה סטטית

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

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

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

בטבלה 1 מפורטים קובצי GTFS שלא נתמכים על ידי 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 טקסט
trips.txt bikes_allowed Enum

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

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

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

כאן מוסבר איך Google Transit מרחיבה את שירות GTFS שאושר על ידי 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 נגזרים מ-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 מייצג את ה-Intent URI שמשמשת לקישורי עומק ב-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 מכיל את המזהה מ- ה-GTFS קובץ stops.txt.
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 'תחבורה ציבורית' משתמשת בערך הזה כאשר הוא קיים.

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