نمای کلی
اگر شما ارائهدهنده فیدهای GTFS برای Google Maps نیستید، ادغام شما فقط Stop-on است. برای این ادغام، باید بدانیم که چگونه ایستگاههای قطار یا اتوبوس مختلف را شناسایی میکنید.
مشخصات عمومی خوراک
هنگام شروع ادغام، یک شناسه منحصر به فرد برای هر ادغام ایجاد می کنیم، به عنوان مثال: ch_google_test
(کد کشور، نام شریک، ادغام) یا eu_google
(کد منطقه، نام شریک).
شرکا می توانند یک فایل فشرده حاوی فایل های متنی در قالب 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 | شناسه (الزامی) | شناسه منحصر به فرد که یک ایستگاه یا ایستگاه را مشخص می کند. ایستگاه های بزرگتر باید فقط یک ورودی داشته باشند. این مورد هنگام برقراری تماس با API سرور شریک شما و در پیوندهای عمیق تهیه بلیط استفاده می شود. |
stop_name | متن (الزامی) | نامی قابل خواندن برای انسان برای اشکال زدایی نقشه توقف، پر کردن حافظه پنهان و داده های دقت قیمت. |
stop_lat | عرض جغرافیایی (الزامی) | عرض جغرافیایی ایستگاه. |
stop_lon | طول جغرافیایی (الزامی) | طول ایست. |
ما از یک فرآیند جذب خودکار استفاده خواهیم کرد که در آن شرکا می توانند به طور مداوم فایل های فشرده به روز شده را در صورت تغییر اطلاعات موجود در آن ارائه دهند. به عنوان مثال، یک شریک ممکن است موجودی ارائه شده را با گسترش فهرست توقف ها گسترش دهد. با این حال، مانند GTFS، stop_ids باید پایدار باشد.
مشخصات خوراک مجموعه بازار (اختیاری)
با توقف های نقشه برداری شده، مجموعه بازار را برای این ادغام ایجاد می کنیم (لیستی حاوی جفت های مبدا/مقصد محبوب). از آنجا، شما می توانید این مجموعه از بازارها را با اثبات خوراک مجموعه بازار کاهش دهید.
مجموعه بازار به عنوان یک لیست مجاز عمل می کند: اگر مجموعه ای از بازار ارائه نشود، همه بازارها در یکپارچه سازی فعال می شوند. اگر مجموعه بازار ارائه شود، هر مارکتی که در لیست نباشد غیرفعال می شود.
فایل مجموعه بازار باید شامل ستون های زیر باشد:
نام فیلد | نوع (به GTFS مراجعه کنید) | توضیحات |
---|---|---|
origin_stop_id | شناسه (الزامی) | مبدا stop_id بازار. |
destination_stop_id | شناسه (الزامی) | مقصد stop_id بازار. |
پیکربندی شریک
هنگام استفاده از ادغام فقط توقف، به اطلاعات بیشتری برای پیکربندی شریک استاتیک همانطور که در بخش پیکربندی شریک ذکر شده است نیاز داریم.
تهیه بلیت لینک های عمیق
قالب و پارامترهای یک لینک عمیق در لینک های بلیط تعریف شده است
پارامترهای 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
خالی میگذاریم. ما با تعیین چندین SegmentKeys، یکی در هر بخش، مسیر را به طور کامل شامل تمام انتقالات مشخص می کنیم.