نمای کلی
اگر شما ارائهدهندهی فیدهای GTFS برای نقشههای گوگل نیستید، ادغام شما فقط برای ایستگاهها است. برای این ادغام، باید بفهمیم که چگونه ایستگاههای مختلف قطار یا اتوبوس را شناسایی میکنید.
مشخصات عمومی خوراک
هنگام شروع ادغام، ما برای هر ادغام یک شناسه منحصر به فرد ایجاد میکنیم، برای مثال: ch_google_test (کد کشور، نام شریک، ادغام) یا eu_google (کد منطقه، نام شریک).
شرکا فایلی حاوی فایلهای متنی با فرمت CSV ارائه میدهند که برای هر ادغام اعمال میشوند. هر فایل CSV باید حاوی یک ردیف سربرگ با نام ستونهایی باشد که با «نام فیلد» مشخص شده در جدول مشخصات فید مربوطه مطابقت دارند.
برای اینکه همکار بتواند نسخههای جدیدی از فایلهای استاپها و مارکتها را آپلود کند، تیم ما جزئیات دراپباکس SFTP را، برای هر نوع فایل، در طول فرآیند پذیرش، به اشتراک خواهد گذاشت.
مشخصات توقف تغذیه (الزامی)
فایل توقف باید شامل ستونهای زیر باشد:
| نام فیلد | نوع (به GTFS مراجعه کنید) | توضیحات |
|---|---|---|
stop_id | شناسه (الزامی) | شناسه منحصر به فردی که یک ایستگاه یا توقفگاه را مشخص میکند. ایستگاههای بزرگتر فقط باید شامل یک ورودی باشند. این شناسه هنگام برقراری تماس با API سرور همکار شما و در لینکهای عمیق فروش بلیط استفاده میشود. |
stop_name | متن (الزامی) | یک نام قابل خواندن توسط انسان برای اشکالزدایی نگاشت توقف، پر کردن حافظه پنهان و دادههای دقت قیمت. |
stop_lat | عرض جغرافیایی (الزامی) | عرض جغرافیایی توقف. |
stop_lon | طول جغرافیایی (الزامی) | طول جغرافیایی محل توقف. |
ما از یک فرآیند خودکار دریافت اطلاعات استفاده خواهیم کرد که در آن شرکا میتوانند به طور مداوم فایلهای فشرده بهروزرسانیشده را در صورت تغییر اطلاعات موجود در آنها ارائه دهند. به عنوان مثال، یک شریک میتواند با گسترش لیست توقفها، موجودی ارائه شده را گسترش دهد. با این حال، مشابه GTFS، stop_ids باید پایدار باشند.
مشخصات تغذیه تنظیم بازار (اختیاری)
با استفاده از حد ضررهای نگاشت شده، مجموعه بازار را برای این ادغام ایجاد میکنیم (لیستی شامل جفتهای مبدا/مقصد محبوب). از آنجا، شما میتوانید با ایجاد یک منبع تغذیه برای مجموعه بازار، این مجموعه بازارها را کاهش دهید.
مجموعه بازار به عنوان یک لیست مجاز برای سرویس پر کردن حافظه پنهان ما عمل میکند. به طور پیشفرض، اگر هیچ مجموعه بازاری ارائه نشود، همه بازارها فعال هستند. اگر یک مجموعه بازار ارائه دهید، فقط بازارهایی که در لیست قرار دارند، مورد پرسش قرار میگیرند. اگر کاربران بازارهایی خارج از این لیست مجاز را جستجو کنند، سیستمهای ما همچنان یک پرسوجوی زنده برای بازار خاص و تاریخ درخواستی ارسال میکنند، اما ما سعی نخواهیم کرد آن را به صورت فعال ذخیره کنیم.
فایل مجموعه بازار باید شامل ستونهای زیر باشد:
| نام فیلد | نوع (به GTFS مراجعه کنید) | توضیحات |
|---|---|---|
origin_stop_id | شناسه (الزامی) | stop_id مبدا بازار. |
destination_stop_id | شناسه (الزامی) | stop_id مقصد بازار. |
پیکربندی شریک
هنگام استفاده از یکپارچهسازی فقط-متوقف، به اطلاعات اضافی برای پیکربندی شریک استاتیک، همانطور که در بخش پیکربندی شریک ذکر شده است، نیاز داریم.
مشخصات لینکهای ارجاعی
قالب و پارامترهای لینک رزرو (که به آن Ticketing link نیز گفته میشود) در لینکهای بلیط فروشی تعریف شدهاند.
پارامترهای API شریک
پارامترهای SegmentKeys برای API شریک ( GetBulkTripOptionsRequest ) بر اساس مشخصات لینک عمیق هستند. ما از SegmentKeys استفاده میکنیم که فقط شامل from_ticketing_stop_time_id ، to_ticketing_stop_time_id ، service_date ، boarding_time و arrival_time میشود و ticketing_trip_id خالی میگذاریم. ما با تعیین چندین SegmentKey، یکی برای هر بخش، مسیر را به طور کامل شامل همه انتقالها مشخص خواهیم کرد.