GTFS Schedule מתאר את הצעת התחבורה המתוכננת. GTFS Realtime, שמכונה לעיתים GTFS-RT, מעביר מידע מעודכן על השירות. GBFS מתאר את שירותי הניידות המשותפת, כולל התחנות והרכבים הזמינים לפי הזרמים המתפרסמים. בחר את הפורמט בהתאם לשאלה שהאפליקציה שלך צריכה לפתור.
פורמטים אלה מארגנים את הנתונים; הם אינם מבטיחים את זמינותם בכל מקום או את איכות כל זרם.
GTFS להצגת ההצעה המתוכננת
סט GTFS Schedule כולל קבצי טבלאות המתארים בין היתר את המפעילים, התחנות, הקווים, הקורסים ומועדי העברתם. היומנים מציינים את הימים הרלוונטיים. הקבצים מקושרים באמצעות מזהים. התייחסות ל-GTFS Schedule.
הפורמט מאפשר לענות על שאלות כמו "איפה נמצאת התחנה הזו?" או "איזה מעבר מתוכנן עבור שירות זה?". כדי לנצל לוח זמנים, יש לפרש את היומן ואת הקשרים בין הקבצים.
קריאה של רשימת תחנות בלבד אינה מספיקה לשחזר את מועדי המעברים. מצד שני, מיקום תחנה יכול להיות שימושי גם ללא הצגת לוחות זמנים.
GTFS-RT לעדכון מידע שירות
GTFS Realtime יכול לספק עדכוני קורסים, מיקומי רכבים והתראות. עדכוני הקורסים כוללים בין היתר את מועדי המעבר והשינויים בשירות. הזרמים משתמשים ב-Protocol Buffers, פורמט סריאליזציה מובנה. הקדמה ל-GTFS Realtime.
מפיק יכול לפרסם קטגוריות מסוימות מבלי לספק את כל האחרות. נוכחות זרם מיקומים אינה מבטיחה הערכות לכל התחנות.
בממשק, יש להבחין בין המעבר המתוכנן לבין ההערכה המעודכנת. מדריך שלנו לוחות זמנים תיאורטיים וזמן אמת מסביר את ההבדל הזה מנקודת מבט המשתמש.
GBFS לניידות משותפת
GBFS משתמש בזרמי JSON לתיאור שירות ניידות משותפת. בהתאם למערכת והגרסה, הם יכולים לספק מידע על התחנות, מצבן, הרכבים ותכונות נוספות של השירות. התיעוד מבדיל בין מידע על תחנות וזמינות. תיעוד GBFS.
הפרד באפליקציה שלך בין מיקומים יחסית יציבים לבין מצבים שמשתנים במהירות. שמור את גרסת הפורמט ואת חותמת הזמן המתאימה בעת הפרשנות.
זרם הזמינות אינו API להזמנה או לפתיחת נעילה. הוא עוזר לגלות את ההצעה; פעולת ההשכרה נעשית דרך השירות המתאים.
השוואה לפי מקרה שימוש
| צורך | פורמט לבדיקה |
|---|---|
| לתאר את התחנות והקווים המתוכננים | GTFS Schedule |
| לפרש מועדי מעבר וימי שירות | GTFS Schedule |
| לעדכן מועדי מעבר או לקבל מידע שירות | GTFS-RT, בהתאם לזרמים המתפרסמים |
| לאתר תחנות או רכבי ניידות משותפת | GBFS, בהתאם לנתונים המתפרסמים |
דוגמת תכנון: מפה מציגה תחנות טרם ורכבי אופניים משותפים. משתמשת בנתונים מבניים למיקומים ובמצבים מעודכנים לזמינות האופניים. שתי השכבות דורשות מטמון ועדכונים שונים.
מצא את מגבלות כל מקור
בדוק גרסאות, שדות אופציונליים, כיסוי וזכויות שימוש. מזהה משמעותי רק בהקשר שלו: שני מפיקים יכולים להשתמש במחרוזות זהות לישויות שונות.
תכנן גם נתונים חסרים או מיושנים. רשימה ריקה מזרם שאינו זמין אינה משמעה היעדר שירות. המנע מהחלפת מידע לא ידוע באפס בלי הודעה.
שימוש בזרמים ישירות או דרך API
אינטגרציה ישירה מטילה עליך את האחריות לאיסוף, אימות ופרשנות המקורות. API יכול להציע חוזה משותף, אך תמיד קרא את הכיסוי, האזהרות והתנאים שלו.
למקרה שימוש ראשון ב-ROOTE, עיין ב- איך לחפש תחנות בקרבת מקום עם API. התחל בצורך של הממשק שלך, ואז בדוק את השדות הזמינים בפועל.
לקרוא קטעים ולבחור ארכיטקטורה
ב-GTFS Schedule, קטע מתוך stop_times.txt מקשר בין נסיעה, תחנה ועצירה מתוכננת. הדוגמה המצומצמת שלהלן חינוכית: היא אינה מהווה מערך GTFS מלא והמזהים שלה צריכים להיות מקושרים אל trips.txt, stops.txt וללוחות הזמנים.
כדי GTFS Realtime, חפשו את היישות השימושית: TripUpdate יכולה לעדכן עצירה, VehiclePosition מתארת מיקום, ו-Alert מעבירה מידע על שירות. מיקום של רכב אינו הערכה אוטומטית של הגעה. הפורמט המשודר הוא Protocol Buffers; ייצוג JSON עבור אבחון אינו הזרם הבינארי הראשי.
ב-GBFS, station_information מתאר את התחנות בעוד station_status מתאר את מצבן שפורסם. שמות כמה מונים וקבצים זמינים משתנים לפי גרסה. קטע JSON שלהלן ממחיש את GBFS 2.3 ושדות num_bikes_available ו-num_docks_available; בדקו את הגרסה לפני שימוש בדוגמה.
מפת מקומות יכולה להתחיל בנתונים מבניים. מסך של עצירות קרובות דורש עדכונים מתאימים ופתרון מגובה מתוכנן במפורש. מסך של אופניים זמינים צריך לנהל מונים, תנאי השכרה ותוקף זמני. שלושת המסכים הללו אינם משתפים באופן אוטומטי את אותה מדיניות מטמון.
# Extrait pédagogique de stop_times.txt
trip_id,arrival_time,departure_time,stop_id,stop_sequence
trip_demo,08:10:00,08:10:00,stop_demo,1
# Extrait pédagogique de station_status en GBFS 2.3
{
"station_id": "station_demo",
"num_bikes_available": 3,
"num_docks_available": 7,
"is_installed": true,
"is_renting": true,
"is_returning": true,
"last_reported": 1720000000
}לעצב זמינות אופניים ואת הרעננות שלה
שאלות נפוצות
האם GTFS כולל זמן אמת אוטומטית?
לא. GTFS Schedule מייצג את ההצעה המתוכננת; המידע המעודכן מגיע מזרמים נוספים, ובפרט GTFS-RT.
האם GBFS מאפשר לפתוח אופניים?
הוא מתאר את השירות ואת הנתונים הציבוריים שלו. ההשכרה מבוצעת דרך היכולות של המפעיל.
האם פורמט תקני מבטיח כיסוי מלא?
לא. הפורמט מגדיר מבנה; הכיסוי והמידע המתפרסם תלויים במקורות.