במדריך הזה מוסבר איך לבצע שילוב עם Google כדי לספק למשתמשים חוויית חיפוש חלקה של תחבורה בפלטפורמות שונות של Google, כולל מפות Google וחיפוש Google. באופן כללי, המפרטים העיקריים של השילוב כוללים:
- יש שתי אפשרויות להעברת נתונים סטטיים:
- שילוב מבוסס GTFS: אספקת פיד GTFS עם תוספים למכירת כרטיסים, במקרים שבהם אתם הספק של נתוני לוחות הזמנים. יש לנו דרישות נוספות לשילוב שמבוסס על GTFS.
- שילוב של עצירות בלבד: העברת רשימה של עצירות בלבד, במקרים שבהם Google כבר קיבלה את נתוני לוחות הזמנים ממקור אחר.
- מפרט של Partner API להעברת נתונים דינמיים:
- הגדרת השותף: מציינים את פרטי השותף, כמו מיתוג ופרטים ליצירת קשר.
- שרת השותף: שרתים שמטמיעים תמיכה בממשקי ה-API של שרת השותף.
שלבים לשילוב עם Travel Transport
בהמשך מופיעה סקירה כללית של השלבים הנדרשים כדי ליצור ולבדוק מערכת מקצה לקצה לתמיכה בתכונות ההעברה של Google. תהליך השילוב כולל שלושה שלבים עיקריים:
- בודקים את הדרישות להשתתפות.
- שליחת פיד של נתונים סטטיים ל-Google.
- תמיכה ב-Travel Transport API כדי לאפשר שאילתות דינמיות של נתונים שמשתנים במהירות, כמו מחירים וזמינות. ה-API משתמש במזהים שסופקו על ידי פיד הנתונים הסטטי משלב 1, לדוגמה
ticketing_stop_id, כדי לזהות תחנות.
1. דרישות ההשתתפות
ביחידת התכונות לתחבורה של Google מוצגים מסלולי נסיעה ואפשרויות הזמנה עם מחירים. כדי שהמבצע יוצג ברשימה, צריך לציין קישור באיכות טובה ומחיר סופי תואם. פרטים נוספים זמינים בדרישות להשתתפות.
2. אספקת פיד של נתונים סטטיים
יש שתי אפשרויות להוספת נתונים סטטיים, וכל אחת מהן מתאימה לנסיבות ספציפיות. הקריטריון העיקרי להחלטה באיזו אפשרות להשתמש הוא אם אתם הספק של נתוני לוחות הזמנים של חיבורי התחבורה שאתם רוצים להציע להם פונקציונליות של הזמנות. הדרך הכי פשוטה לבדוק אם ל-Google כבר יש נתוני לוחות זמנים היא לנסות למצוא קישורים למפעיל מסוים ב-Google Maps.
| תכונה | שילוב מבוסס GTFS | שילוב של עצירה בלבד |
|---|---|---|
| תרחיש לדוגמה | אתם כבר מספקים את פיד GTFS עם לוחות זמנים ופרטי כרטיסים. | ל-Google כבר יש את נתוני לוח הזמנים של המפעיל ממקור אחר. |
| הנתונים הנדרשים | מזהי GTFS. | רשימה של מזהי התחנות, עם הקואורדינטות הגיאוגרפיות שלהן. |
| מאמץ | נמוכה | בינונית |
אפשרות 1 רלוונטית אם אתם הספק של פיד GTFS עבור מפעיל. במקרה כזה, צריך גם להגדיר פיד GTFS כדי לספק ל-Google את פרטי לוחות הזמנים. לאחר מכן פועלים לפי ההוראות שבקטע שילוב מבוסס GTFS.
אפשרות 2 רלוונטית אם Google כבר מקבלת נתוני לוחות זמנים של המפעיל ממקור אחר. במקרה כזה, אנחנו לא צריכים את כל פרטי לוח הזמנים, אבל אנחנו עדיין צריכים רשימה של מזהי התחנות שאפשר להשתמש בהם ב-Travel Transport API (ראו בהמשך). כדי לספק את רשימת התחנות, פועלים לפי ההוראות שבקטע הטמעה של תחנות בלבד.
3. תמיכה ב-Travel Transport API
כדי להופיע כשותף הזמנות עם מחירים ביחידת התחבורה, Google צריכה להיות מסוגלת לאחזר מהשותפים את המידע העדכני ביותר לגבי המחירים והזמינות. כדי להפעיל את האפשרות הזו, השותפים צריכים לספק שירות שמטמיע את ממשקי ה-API של שרת השותפים.
3.1. איך מטמיעים את Partner Server API
פרטים על הטמעה של Partner Server API זמינים בהפניה ל-API ובמדריך ל-Partner Server. ה-API מאפשר ל-Google לקבל מהשותפים את נתוני המחירים והזמינות העדכניים ביותר, ו-Google תשתמש בו כדי:
- יצירת מטמון כדי להחזיר מחירים במהירות.
- להציג את המחיר העדכני ביותר כשמשתמש לוחץ על מסלול נסיעה ספציפי.
אם השותף רוצה ש-Google תציג את המחירים שלו, הוא צריך להטמיע את Partner Server API.
3.2. אימות ובדיקה של API
כשההטמעה של ה-API קרובה לסיום והשירות שמטמיע אותו פועל, צריך לפנות לכתובת transport-help@google.com ולשלוח את פרטי השרת כדי שנוכל להתחיל לאמת את ההטמעה.
בעתיד, אנחנו מתכננים להציע כלים אוטומטיים לאימות ההטמעה של ה-API, אבל הם עדיין לא זמינים.