פורמט קישור לחיפוש

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

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

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

הערכים של stop_ids של תחנות היציאה.
to_stop_id

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

הערכים של stop_ids של תחנות היעד.
search_date

‫(Date) יום השירות בטיול.

השדה הזה מכיל את התאריך בפורמט הבא:

YYYYMMDD
lang

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

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

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

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

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

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

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

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

כל הפרמטרים שניתנים לחזרה מצוינים כמערך JSON. במקרה של from_stop_id ו-to_stop_id, כמה ערכים מייצגים כמה תחנות ביישוב המוצא וביישוב היעד.

דוגמאות

בדוגמה הזו, המשתמש מחפש רכבות מlocality1 אל locality2:

  • ‫locality1 ממופה לתחנות עם stop_id f1 ו-f2.
  • ‫locality2 ממופה לתחנות עם stop_id t1 ו-t2.
  • תאריך השירות הוא 20190716.

בדוגמה הזו, כתובת ה-URL הבסיסית היא https://example.com.

בהתבסס על כל המידע הזה, צריך להשתמש בערכים הבאים לפרמטרים:

שם השדה פרטים
from_stop_id ["f1", "f2"]
to_stop_id ["t1", "t2"]
service_date 20190716

זה ה-URI הסופי אחרי הקידוד:

https://example.com?from_stop_id=%5B%22f1%22,%22f2%22%5D&to_stop_id=%5B%22t1%22,%22t2%22%5D&search_date=20190716

בדף הנחיתה, המשתמש יוכל לראות מסלולי נסיעה שיוצאים מתחנות f1 וf2 בתאריך 20190716 ומגיעים לתחנות t1 וt2. כל השילובים של תחנות נתמכים:

  • מ-f1 עד t1
  • מ-f1 עד t2
  • מ-f2 עד t1
  • מ-f2 עד t2