שילוב של עצירה בלבד

סקירה כללית

אם אתם לא הספק של פידים של 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.

הגדרת שותף

כשמשתמשים בשילוב מסוג stop-only, אנחנו דורשים מידע נוסף להגדרת השותף הסטטית, כפי שמפורט בקטע 'הגדרת השותף'.

מפרט של קישורים מפנים

הפורמט והפרמטרים של הקישור להזמנה (שנקרא גם 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, אחד לכל קטע.