מילון מונחים

במילון המונחים הזה מוגדרים מונחי מפתח שמופיעים במסמכי השילוב של שותפי תחבורה.

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

מיפוי JSON קנוני: קבוצה ספציפית של כללים שהוגדרו על ידי Protocol Buffers להמרה של הודעת proto לאובייקט JSON. כדי שהבקשות והתשובות יהיו בפורמט הנכון, צריך להשתמש במיפוי הזה עם אפשרויות ספציפיות.

‫GTFS (General Transit Feed Specification): פורמט נתונים סטנדרטי שחברות תחבורה ציבורית משתמשות בו כדי לספק לנוסעים מידע על לוחות זמנים, מסלולים ותעריפים. באינטגרציה הזו, זו אחת משתי הדרכים לספק נתונים סטטיים ל-Google.

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

‫known_itineraries: אפשרות בהגדרות השותף שמאפשרת לשותפים לקבל מ-Google רשימה של מסלולי נסיעה מוכרים כדי לייעל את התגובה שלהם.

קבוצת שווקים: (לשילוב מסוג עצירה בלבד) פיד אופציונלי שהשותף מספק כדי להגדיר רשימה ספציפית של זוגות מוצא-יעד (שווקים) שבהם הוא יספק תמחור. אם מציינים כתובות, הן משמשות כרשימת היתרים.

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

בדיקת איכות המחירים: תהליך מתמשך שבו סורקי Google דוגמים מסלולי נסיעה באתר השותף כדי לוודא שהמחירים שמוצגים למשתמשים זהים למחירים שסופקו דרך Partner API.

QPS (Queries Per Second): The average rate at which Google sends requests (one query is one request) to the Partner API server. הקצב הזה עשוי להשתנות, עם תקופות של תנועה גבוהה או נמוכה יותר.

‫SegmentKey: אובייקט שמשמש ב-Partner API כדי לזהות באופן ייחודי מקטע יחיד של מסלול, כולל נקודת המוצא, היעד ותאריכי ושעות השירות.

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

שילוב מסוג Stop-only: שיטת שילוב לשותפים שלא מספקים את נתוני לוח הזמנים. התג הזה משמש כש-Google כבר מקבלת את לוחות הזמנים של חברת התעופה ממקור אחר. השותפים צריכים רק לספק רשימה של מספרי התחנות שלהם.

‫ticketing_stop_id: המזהה הייחודי של השותף לתחנה. המספר הזה מופיע בפיד הנתונים הסטטיים (GTFS או פיד עם נתונים על תחנות בלבד) ומשמש ב-Partner API ובקישורי עומק למכירת כרטיסים.

‫ticketing_trip_id: (בשילוב שמבוסס על GTFS) המזהה הייחודי של השותף לנסיעה ספציפית, שמופיע בקובץ trips.txt בפיד GTFS שלו. רק שילובים שמבוססים על GTFS.

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

‫TripOptionsErrorType: קבוצה ספציפית של סוגי שגיאות שיכולות לחזור ב-Partner API כדי לספק מידע מפורט יותר על הסיבה לכך שבקשה נכשלה.

UNSPECIFIED ערך enum: הערך הראשון שנדרש (עם ערך מספרי של 0) בכל הגדרת enum כשמשתמשים ב-Protocol Buffers. הערך הזה משמש כערך ברירת המחדל, ובדרך כלל צריך להתייחס אליו כשגיאה אם הוא מתקבל בבקשה.