General Transit Feed Specification (GTFS) הוא פורמט קיים ללוחות זמנים של תחבורה ציבורית ולמידע גיאוגרפי קשור. השילוב שמבוסס על GTFS משתמש ב-GTFS ובהרחבות של Google Transit Ticketing כדי לבצע את שלב 1 בשילוב של נתוני תחבורה בנסיעות – אספקת פיד של נתונים סטטיים.
ה-Partner Server API ישתמש במזהים כמו ticketing_trip_id שמסופקים על ידי GTFS, ולכן צריך שיהיה פיד GTFS תקין לפני שמשתמשים ב-API.
כדי לספק פיד GTFS תקין, צריך לפעול לפי השלבים הבאים.
יצירת פיד GTFS סטטי
כדי לאפשר למשתמשים לחפש ולמצוא מסלולים ולוחות זמנים לנסיעות בין עירוניות באמצעות השילוב שמבוסס על GTFS, נדרש פיד GTFS מהשותפים. נתוני הפיד של GTFS יכללו מידע סטטי על לוחות זמנים, מסלולים ומידע על כרטיסים, שמשמש את Google להתחבר ל-API של השותף.
1. יצירת חשבון Transit
אם עדיין לא עשיתם זאת, אתם צריכים לעבור אל תחילת העבודה עם Google Transit ולמלא את הטופס כדי לבקש חשבון. בסיום הבדיקה, ייווצר חשבון ומרכז הבקרה של GTFS יהיה זמין. פרטים על גישה למרכז הבקרה והגדרתו זמינים במאמר גישה למרכז הבקרה לשותפים ב-Google Transit.
2. יצירת פיד GTFS עם תוספים
יוצרים פיד GTFS שכולל את הקטעים הנדרשים של התוספים של Google Transit Ticketing (פרטים נוספים זמינים בקטע בנושא תוספי GTFS). כדי להבטיח את חוויית המשתמש הטובה ביותר, חשוב לקרוא את הדרישות והשיטות המומלצות לאיכות נתוני GTFS ולפעול לפיהן.
3. מתן שם לפיד
מוסכמת מתן השמות המומלצת לפיד היא:
agency-region-country_code, למשל gbus-ca-us, או
agency-country_code אם לא נדרש אזור, למשל gbus-br. מומלץ לתת לפידים לבדיקה שמות לפי המוסכמה הבאה:
test-agency-country_code, למשל test-gbus-ca-us או test-gbus-br.
4. העלאה ועדכון של הפיד
כדי להעלות ולעדכן את נתוני ה-GTFS, פועלים לפי ההוראות במאמר פרסום פיד המידע על תחבורה ציבורית (GTFS). בכל פעם שמעלים את הנתונים, הם עוברים תהליך אימות אוטומטי (שנמשך עד 30 דקות) ונוצר דוח אימות. צריך לתקן את השגיאות לפני שעוברים לשלב הבא.
5. בקשה של סביבת תצוגה מקדימה
אחרי שנתוני ה-GTFS עוברים את האימות בהצלחה, פועלים לפי ההוראות במאמר בדיקת נתוני הפיד באמצעות תצוגה מקדימה פרטית כדי להפעיל את סביבת התצוגה המקדימה. אחרי ההפעלה, נתוני הפיד שהועלו יהיו גלויים במפות Google למשתמשים מורשים. בשלב הזה, אפשר להשתמש בנתוני GTFS גם לבדיקה באמצעות שרת ה-API.
6. שליחת בקשה לבדיקת QA לפני השקה
אחרי שמטפלים באזהרות הבעייתיות ובבעיות באיכות הנתונים בסביבת התצוגה המקדימה, צריך לעבור בדיקת QA סופית של Google לפני ההשקה לציבור. בעיות שמתגלות בתהליך הבדיקה של בקרת האיכות מוצגות במרכז הבקרה. אחרי שפותרים את כל הבעיות, קובץ ה-GTFS מוכן להפעלה.
7. הפעלת הפיד
במאמר הפעלת הפיד מוסבר איך להפוך את הפיד לזמין לציבור.