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

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

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

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

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

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

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

‫(Date, ניתן לחזרה) יום השירות בנסיעה.

השדה הזה הוא במערך 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 למכירת כרטיסים.