סקירה כללית
אם אתם לא הספקים של פידים של GTFS למפות Google, השילוב שלכם הוא עצירות בלבד. כדי לבצע את השילוב הזה, אנחנו צריכים להבין איך אתם מזהים את התחנות השונות של האוטובוסים או הרכבות.
מפרטי פידים כלליים
כשמתחילים את השילוב, אנחנו יוצרים מזהה ייחודי לכל שילוב, לדוגמה: ch_google_test (קוד המדינה, שם השותף, השילוב) או eu_google (קוד האזור, שם השותף).
שותפים יכולים לספק קובץ zip שמכיל קובצי טקסט בפורמט CSV, שיוחלו באופן גלובלי או לכל שילוב בנפרד:
דוגמה 1:
- ch_google_test_stops.txt
- ch_google_test_markets.txt
דוגמה 2:
- stops.txt (חל על כל השילובים)
- eu_google_integration1_markets.txt
- eu_google_integration2_markets.txt
מפרט פיד עצירה (חובה)
קובץ העצירות צריך להכיל את העמודות הבאות:
| שם השדה | סוג (ראו GTFS) | תיאור |
|---|---|---|
stop_id |
מזהה (חובה) | המזהה הייחודי שמזהה תחנה או עצירה. תחנות גדולות יותר צריכות להכיל רק רשומה אחת. הוא משמש בקריאות ל-Partner Server API ובקישורי העומק של מכירת הכרטיסים. |
stop_name |
טקסטים (חובה) | שם שקריא לאנשים לניפוי באגים של מיפוי עצירות, מילוי מטמון ונתוני דיוק מחירים. |
stop_lat |
קו הרוחב (חובה) | קו הרוחב של התחנה. |
stop_lon |
קו האורך (חובה) | קו האורך של התחנה. |
נשתמש בתהליך הטמעה אוטומטי, שבו השותפים יוכלו לספק קובצי ZIP מעודכנים באופן שוטף כשהמידע שבהם ישתנה. לדוגמה, שותף יכול להרחיב את מלאי שטחי הפרסום שהוא מספק על ידי הרחבת רשימת התחנות. עם זאת, בדומה ל-GTFS, השדות stop_ids צריכים להיות יציבים.
מפרט פיד של קבוצת שווק (אופציונלי)
בעזרת התחנות הממופות, אנחנו יוצרים את קבוצת השווקים של השילוב הזה (רשימת צמדי מקור / יעד פופולריים). לאחר מכן, תוכלו לצמצם את קבוצת השווקים הזו על ידי הצגת פיד של קבוצת שווקים.
קבוצת השווקים פועלת כרשימה לבדיקת הרשאות: אם לא מציינים קבוצת שווקים, כל השווקים מופעלים בשילוב. אם מציינים קבוצת שווקים, כל שוק שלא מופיע ברשימה יושבת.
קובץ קבוצת השווקים צריך לכלול את העמודות הבאות:
| שם השדה | סוג (ראו GTFS) | תיאור |
|---|---|---|
origin_stop_id |
מזהה (חובה) | המקור stop_id של השוק. |
destination_stop_id |
מזהה (חובה) | היעד stop_id של השוק. |
הגדרות השותף
כשמשתמשים בשילוב של עצירות בלבד, נדרשים פרטים נוספים להגדרה הסטטית של השותף, כפי שמתואר בקטע 'הגדרת שותף'.
קישורי עומק למכירת כרטיסים
הפורמט והפרמטרים של קישור עומק מוגדרים בקטע קישורי מכירת כרטיסים
פרמטרים של 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, אחד לכל פלח.