סקירה כללית
אם אתם לא הספק של פידים של GTFS למפות Google, השילוב שלכם הוא Stop-only. כדי להשתמש בשילוב הזה, אנחנו צריכים להבין איך אתם מזהים את תחנות הרכבת או האוטובוס השונות.
מפרט פיד כללי
כשמתחילים את ההטמעה, אנחנו יוצרים מזהה ייחודי לכל הטמעה, לדוגמה: ch_google_test (קוד מדינה, שם שותף, הטמעה) או eu_google (קוד אזור, שם שותף).
שותפים מספקים קובץ שמכיל קובצי טקסט בפורמט CSV, שמוחל על כל שילוב. כל קובץ CSV צריך לכלול שורת כותרת עם שמות עמודות שתואמים ל'שם השדה' שצוין בטבלת מפרט הפיד המתאימה.
כדי לאפשר לשותף להעלות גרסאות חדשות של קבצי התחנות והשווקים, הצוות שלנו ישתף פרטים של תיבת דואר נכנס ב-SFTP, אחת לכל סוג קובץ, במהלך תהליך ההצטרפות.
מפרט פיד עצירות (חובה)
קובץ העצירה צריך לכלול את העמודות הבאות:
| שם השדה | סוג (ראו GTFS) | תיאור |
|---|---|---|
stop_id |
מזהה (חובה) | המזהה הייחודי שמזהה תחנה או תחנה. תחנות גדולות יותר צריכות להכיל רק רשומה אחת. הוא משמש כשמבצעים קריאות ל-API של שרת השותף ובקישורי עומק לכרטיסים. |
stop_name |
טקסטים (חובה) | שם קריא (לבני אדם) למיפוי עצירה של ניפוי באגים, למילוי מטמון ולנתוני דיוק מחירים. |
stop_lat |
קו רוחב (חובה) | קו הרוחב של התחנה. |
stop_lon |
קו אורך (חובה) | קו האורך של התחנה. |
נשתמש בתהליך אוטומטי להעברת נתונים, שבו שותפים יכולים לספק באופן רציף קובצי ZIP מעודכנים כשהמידע שכלול בהם משתנה. לדוגמה, שותף יכול להרחיב את מלאי שטחי הפרסום שהוא מספק על ידי הרחבת רשימת התחנות. עם זאת, בדומה ל-GTFS, מזהי התחנות (stop_ids) צריכים להיות יציבים.
מפרט פיד של קבוצת שווקים (אופציונלי)
בעזרת התחנות הממופות, אנחנו יוצרים את קבוצת השוק לשילוב הזה (רשימה שמכילה זוגות פופולריים של נקודות מוצא ויעד). אחרי כן, תוכלו להקטין את קבוצת השווקים הזו על ידי הוספת פיד של קבוצת שווקים.
הגדרת השוק פועלת כרשימת היתרים לשירות למילוי המטמון שלנו. כברירת מחדל, אם לא מציינים קבוצת שווקים, כל השווקים מופעלים. אם תספקו קבוצת שווקים, המערכת תבצע שאילתות רק בשווקים שכלולים ברשימה. אם משתמשים יחפשו נתונים על שווקים שלא מופיעים ברשימת ההיתרים הזו, המערכות שלנו עדיין ישלחו שאילתה בזמן אמת לגבי השוק והתאריך הספציפיים שביקשו, אבל לא ננסה לשמור את הנתונים במטמון באופן יזום.
קובץ הגדרת השוק צריך לכלול את העמודות הבאות:
| שם השדה | סוג (ראו GTFS) | תיאור |
|---|---|---|
origin_stop_id |
מזהה (חובה) | מקור השוק stop_id. |
destination_stop_id |
מזהה (חובה) | יעד השוק stop_id. |
הגדרות השותף
כשמשתמשים בשילוב מסוג עצירה בלבד, צריך לספק מידע נוסף להגדרת השותף הסטטית, כפי שמתואר בקטע בנושא הגדרת השותף.
מפרט של קישורי הפניה
הפורמט והפרמטרים של הקישור להזמנה (שנקרא גם Ticketing link) מוגדרים במאמר קישורים למכירת כרטיסים
פרמטרים של Partner API
הפרמטרים SegmentKeys של Partner API (GetBulkTripOptionsRequest) מבוססים על מפרט קישור העומק. אנחנו משתמשים ב-SegmentKeys, כולל רק from_ticketing_stop_time_id, to_ticketing_stop_time_id, service_date, boarding_time ו-arrival_time, ומשאירים את ticketing_trip_id ריק. אנחנו נציין את המסלול באופן מלא, כולל כל ההעברות, על ידי ציון של כמה SegmentKey, אחד לכל פלח.