תחילת העבודה

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

  • יש שתי אפשרויות להעברת נתונים סטטיים:
    • שילוב מבוסס GTFS: אספקת פיד GTFS עם תוספים למכירת כרטיסים, במקרים שבהם אתם הספק של נתוני לוחות הזמנים. יש לנו דרישות נוספות לשילוב שמבוסס על GTFS.
    • שילוב של עצירות בלבד: העברת רשימה של עצירות בלבד, במקרים שבהם Google כבר קיבלה את נתוני לוחות הזמנים ממקור אחר.
  • מפרט של Partner API להעברת נתונים דינמיים:

שלבים לשילוב עם 'תחבורה' ב-Travel

בהמשך מופיעה סקירה כללית של השלבים הנדרשים כדי ליצור ולבדוק מערכת מקצה לקצה לתמיכה בתכונות ההעברה של Google. תהליך השילוב כולל שלושה שלבים עיקריים:

  1. בודקים את הדרישות להשתתפות.
  2. שליחת פיד של נתונים סטטיים ל-Google.
  3. תמיכה ב-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 של Partner Server.

3.1. איך מטמיעים את Partner Server API

פרטים על הטמעה של Partner Server API זמינים בהפניה ל-API ובמדריך ל-Partner Server. ה-API מאפשר ל-Google לקבל מהשותפים את נתוני המחירים והזמינות העדכניים ביותר, ו-Google תשתמש בו כדי:

  1. יצירת מטמון כדי להחזיר מחירים במהירות.
  2. לקבל את המחירים העדכניים ביותר כשמשתמש מחפש מסלול בתאריך מסוים שבו מסלולי הנסיעה במטמון שלנו לא כוללים מחיר.

הטמעה של Partner Server API נדרשת אם השותף רוצה ש-Google תציג את המחירים.

3.2. אימות ובדיקה של API

אחרי שההטמעה של ה-API תהיה כמעט מוכנה והשירות שמטמיע אותו יפעל, צריך לפנות לכתובת transport-help@google.com ולשלוח את פרטי השרת כדי שנוכל להתחיל לאמת את ההטמעה.

בעתיד, אנחנו מתכננים להציע כלים אוטומטיים לאימות ההטמעה של ה-API, אבל הם עדיין לא זמינים.