פורמט הקישור למכירת כרטיסים

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

שם השדה פרטים
from_ticketing_stop_time_id

(ניתן לחזור על המאפיין) מזהה התחנה שבה מתחיל קטע הנסיעה.

עבור שעת עצירה מסוימת, זהו הערך של stop_id של תחנת היציאה.
to_ticketing_stop_time_id

(חוזר) מזהה התחנה שבה מסתיים קטע הנסיעה.

עבור שעת עצירה מסוימת, זהו הערך של stop_id של תחנת היעד.
service_date

‫(Date, Repeatable) תאריך השירות בנסיעה.

השדה הזה מפורמט כמערך JSON, שמכיל את התאריך עם מחרוזת הפורמט הבאה:

YYYYMMDD
boarding_time

‫(ISO 8601, ניתן לחזור עליו) התאריך והשעה של ההמראה (departure_time) של עצירת הביניים שבה מתחיל קטע הנסיעה.

ערך השעה בשדה הזה תואם לתקן ISO 8601, עם מחרוזת הפורמט הבאה:

YYYY-MM-DDThh:mm:ss±hh:mm
arrival_time

‫(ISO 8601, ניתן לחזור עליו) התאריך והשעה של ההגעה (arrival_time) של עצירת הביניים שבה מסתיים קטע הנסיעה.

ערך השעה בשדה הזה תואם לתקן ISO 8601, עם מחרוזת הפורמט הבאה:

YYYY-MM-DDThh:mm:ss±hh:mm
booking_token

‫(String) שדה אופציונלי שמשמש להוספת נתונים נוספים. הערך הזה מגיע מהתגובה של Travel Transport API ומוסף לקישור העומק למכירת כרטיסים.

האורך המקסימלי של booking_token הוא 100 תווים.

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

(IETF BCP 47, אופציונלי) שדה שמשמש לציון השפה שנבחרה באתר ההזמנות.

הערך בשדה הזה תואם ל-IETF BCP 47, למשל en-US.

אם השפה שנבחרה לא זמינה או שהשדה לא מועבר, האתר להזמנת תורים צריך להשתמש בשפת ברירת מחדל.
cur

(ISO 4217, אופציונלי) שדה שמשמש לציון המטבע שבו המחירים צריכים להיות מוצגים.

הערך בשדה הזה תואם לתקן ISO 4217, למשל USD.

אם אי אפשר להציג את המטבע שנבחר או אם השדה לא מועבר, באתר ההזמנות צריך להשתמש במטבע חלופי.
utm_source

‫(String, אופציונלי) שדה שמשמש לציון האתר ברמה העליונה ששלח את התנועה.

הערכים האפשריים הם google_search ו-google_maps.

כל הפרמטרים שניתן לחזור עליהם מוגדרים כמערך JSON, שבו ערכים מרובים מציינים עצירות במהלך ההעברה. דוגמאות לקידוד כתובות URL מופיעות בדוגמאות של התוסף Google Transit Ticketing Extension.