مرجع و تفاوت‌های زمان‌بندی Google Transit GTFS

این صفحه تفاوت های عمده بین برنامه رسمی GTFS و اجرای Google Transit از مشخصات را در زمینه های زیر شرح می دهد:

  • مشخصات رسمی نادیده گرفته شده: این فیلدها بخشی از GTFS رسمی هستند. Google Transit این داده‌ها را بدون خطا دریافت می‌کند، اما به‌طور پیشگیرانه از داده‌ها استفاده نمی‌کند.

  • تفسیر متفاوت: این فیلدها شامل بخش‌هایی از GTFS رسمی است که Google Transit آن‌ها را متفاوت از تعریف GTFS آن قسمت‌ها تفسیر می‌کند.

  • پشتیبانی آزمایشی: این فیلدها در اجرای Google Transit آزمایشی هستند. اگر می‌خواهید یک زمینه آزمایشی جدید پیاده‌سازی کنید، با تیم Google Transit تماس بگیرید.

  • برنامه افزودنی پشتیبانی شده توسط Google Transit: این برنامه افزودنی بخشی از GTFS رسمی نیست . برنامه افزودنی پشتیبانی شده توسط Transit هم شامل برنامه‌های افزودنی عمومی و هم برنامه‌های افزودنی ویژه Google Transit می‌شود. هر شریکی می‌تواند این اطلاعات را در فید خود به Transit ارسال کند.

ترانزیت استاتیک

بخش‌های زیر تفاوت‌های عمده بین GTFS رسمی و اجرای Google Transit از فید استاتیک را نشان می‌دهد.

مشخصات رسمی در فیدهای استاتیک نادیده گرفته شده است

برخی از مشخصات رسمی که توسط Transit نادیده گرفته شده اند، آزمایشی هستند. برای کسب اطلاعات بیشتر، به gtfs.org بروید.

جدول 1 فایل های GTFS را فهرست می کند که توسط Transit در فیدهای ایستا پشتیبانی نمی شوند. همچنین هیچ یک از فیلدهایی که در این فایل ها تعریف شده اند توسط Transit پشتیبانی نمی شوند.

جدول 1. فایل های GTFS پشتیبانی نشده در فیدهای ایستا
areas.txt
fare_leg_rules.txt
fare_products.txt
fare_transfer_rules.txt
levels.txt
stop_areas.txt

جدول 2 تمام فیلدهای تعریف شده توسط GTFS را که توسط Transit در فیدهای ایستا نادیده گرفته می شوند، فهرست می کند.

جدول 2. فیلدهای GTFS در فیدهای ایستا نادیده گرفته شده است
نام فایل فیلد نادیده گرفته شده در GTFS تعریف شده است نوع میدان
fare_attributes.txt payment_method Enum
feed_info.txt default_lang کد زبان
feed_info.txt feed_publisher_name متن
pathways.txt max_slope شناور
routes.txt continuous_drop_off Enum
routes.txt continuous_pickup Enum
routes.txt network_id شناسه
routes.txt route_desc متن
routes.txt route_sort_order عدد صحیح غیر منفی
stops.txt level_id شناسه
stops.txt stop_desc متن
stops.txt stop_url URL
stops.txt tts_stop_name متن
trips.txt bikes_allowed Enum

تفسیرهای مختلف در فیدهای استاتیک

اگرچه Transit فیلدهای تعریف شده توسط GTFS را می پذیرد، Transit آنها را متفاوت از GTFS تفسیر می کند.

جدول 3 فیلدهایی را در فیدهای ایستا نشان می دهد که Transit متفاوت از آنچه در GTFS توضیح داده شده است پیاده سازی می کند.

جدول 3. فیلدهای فید ایستا متفاوت پیاده سازی شده است
نام فایل فیلد تعریف شده در GTFS نوع میدان توسط Google Transit مورد نیاز است؟ جزئیات پیاده سازی Google Transit
fare_attributes.txt transfers Enum ضروری

پسوند Google Transit.

GTFS عمومی مقادیر را به محدوده ای از 0 تا 2 محدود می کند. Google Transit مقادیر 0 تا 5 را می پذیرد.

از این قسمت برای تعیین حداکثر تعداد نقل و انتقالات مجاز با کرایه استفاده کنید. این شامل نقل و انتقالات بلوکی که به عنوان انتقال درون صندلی نیز شناخته می شود، نمی شود. اگر نمی‌خواهید محدودیتی برای تعداد نقل و انتقالات برای کرایه تعیین کنید، قسمت transfers را خالی بگذارید.

pathways.txt pathway_mode Enum اختیاری وقتی فیلد pathway_mode مشخص شد، اگر خالی بماند، Google Transit آن را می‌پذیرد و آن را ناشناخته تلقی می‌کند.
stop_times.txt arrival_time زمان مشروط مورد نیاز است ساعات کاری محدود به مقادیر 00 تا 99 است که برای سفرهای سه روزه کافی است.
transfers.txt transfer_type Enum ضروری

مقادیر 4 و 5 پشتیبانی نمی شوند و نادیده گرفته می شوند.

Google Transit از مقادیر 0 , 1 , 2 و 3 پشتیبانی می کند.

trips.txt block_id شناسه اختیاری برای کسب اطلاعات بیشتر، نمونه انتقال بلوک را ببینید.

پشتیبانی تجربی در فیدهای استاتیک

اگر برای ادغام زمینه‌های آزمایشی جدید در این دسته به پشتیبانی نیاز دارید، با Google Transit تماس بگیرید.

افزونه های پشتیبانی شده توسط Google Transit در فیدهای ثابت

جدول 4 اطلاعاتی درباره برنامه های افزودنی Google Transit ارائه می دهد. این فیلدها بخشی از GTFS رسمی نیستند.

جدول 4. پسوندهای فید ایستا پشتیبانی می شود
نام فایل رشته نوع میدان توسط Google Transit مورد نیاز است؟ جزئیات پیاده سازی Google Transit
fare_attributes.txt ic_price شناور اختیاری

این افزونه Google Transit فقط برای شرکای ژاپنی در دسترس است.

قسمت ic_price نشان دهنده مبلغ تخفیفی است که باید برای این کرایه با کارت هوشمند پرداخت شود. اگر هیچ تخفیفی برای این کرایه ارائه نشده است، یا کارت هوشمند پشتیبانی نمی‌شود، مقدار فیلد ic_price باید -1 باشد.

fare_rules.txt contains_route_id شناسه اختیاری

پسوند Google Transit.

این کرایه فقط برای سفرهایی اعمال می‌شود که از مجموعه دقیقی از مسیرهایی که با مقدار route_id در همه ردیف‌ها برای این ترکیب از ستون‌های fare_id ، origin_id ، و destination_id شناسایی شده‌اند، استفاده می‌شود.

اگر ستون contains_route_id وجود نداشته باشد، یا تمام مقادیر آن برای این کرایه خالی باشد، کرایه در این پارامتر محدود نمی‌شود. اگر فیلد contains_route_id برای کرایه داده شود، فیلد route_id باید خالی باشد.

routes.txt checkin_duration عدد صحیح اختیاری

پسوند Google Transit.

فیلد checkin_duration مشخص می‌کند که چند ثانیه زودتر به مسافر توصیه می‌شود قبل از حرکت برنامه‌ریزی‌شده برای بررسی و سوار شدن به مقصد برسد.

اگر مسافر با ترانسفر به مبدا وصل شود، هر زمان انتقال تعریف شده بر مقدار checkin_duration لغو می شود.

مقدار checkin_duration تنها توصیه ای است که معمولاً توسط اپراتور حمل و نقل ارائه می شود. ممکن است آخرین لحظه ممکن را که یک مسافر می تواند از راه برسد و همچنان سوار وسیله نقلیه شود منعکس نمی کند.

routes.txt route_type Enum ضروری

پسوند Google Transit.

برای آشنایی با نحوه گسترش Google Transit گزینه‌های مقدار route_type مورد قبول GTFS، به انواع مسیرهای GTFS توسعه یافته مراجعه کنید.

stop_times.txt stop_direction_name متن اختیاری

پسوند Google Transit.

قسمت stop_direction_name مسیر سفر را به مسافران مشخص می کند. جهت به عنوان مقدار direction_name خروج از این توقف ذخیره می شود.

اگر فیلد stop_direction_name خالی باشد، به جای آن از فیلد trip_direction_name پشتیبانی شده توسط Transit استفاده می‌شود. اگر فیلدهای trip_direction_name و stop_direction_name هر دو خالی باشند، واردکننده ترانزیت آنها را خالی می‌گذارد. در آن صورت، شرکا می توانند به جای آن از مقدار stop_headsign یا trip_headsign استفاده کنند. مقادیر فیلد stop_direction_name به حروف عادی تبدیل می‌شوند.

stops.txt signposted_as متن اختیاری

پسوند Google Transit.

فیلد signposted_as حاوی متنی است که بر روی تابلوی پلت فرم نوشته شده است. به عنوان مثال «به سمت مرکزی» و «سمت شرقی و بروکلین» هستند.

فیلد platform_code GTFS و قسمت signposted_as با پشتیبانی از Transit را می توان به طور همزمان تنظیم کرد.

تفاوت بین فیلدهای platform_code و signposted_as شامل موارد زیر است:

  • طول. فیلد platform_code معمولا حاوی عدد یا حرفی مانند 2 یا C است.
  • زبان. فیلد platform_code زبان ندارد، اما مقادیر signposted_as می‌توانند ترجمه داشته باشند.
  • ثبات. فیلد platform_code خیلی کمتر از قسمت signposted_as تغییر می کند.
stops.txt vehicle_type عدد صحیح اختیاری

پسوند Google Transit.

قسمت vehicle_type نوع وسایل نقلیه ای را که در یک توقف استفاده می شوند را مشخص می کند. این فیلد انواع مسیرهای نوع خودرو سلسله مراتبی (HVT) را می پذیرد. مقادیر HVT از استاندارد گروه کارشناسان پروتکل حمل و نقل اروپا (TPEG) مشتق شده است.

agency.txt ticketing_deep_link_id شناسه اختیاری

افزونه فروش بلیت Google Transit.

در فایل agency.txt ، قسمت ticketing_deep_link_id نشان دهنده پیوند عمیقی است که برای بلیط سفرهای این آژانس استفاده می شود.

routes.txt ticketing_deep_link_id شناسه اختیاری

افزونه فروش بلیت Google Transit.

در فایل routes.txt ، قسمت ticketing_deep_link_id پیوند عمیقی را نشان می دهد که برای بلیط سفرهای این مسیر استفاده می شود.

stop_times.txt ticketing_stop_time_id شناسه اختیاری

افزونه فروش بلیت Google Transit.

اگر در فایل stop_times.txt وجود داشته باشد، فیلد ticketing_stop_time_id شناسه ای را که نشان دهنده زمان توقف برای تهیه بلیط با پیوندهای عمیق است، لغو می کند.

stop_times.txt ticketing_type Enum اختیاری

افزونه فروش بلیت Google Transit.

قسمت ticketing_type نوع بلیطی را که برای این زمان توقف اعمال می شود مشخص می کند.

Google Transit مقادیر زیر را می پذیرد:

  • Empty . پیش فرض - همانطور که توسط سفر تعریف شده است.
  • 0 . فقط در صورتی در دسترس است که آژانس یا مسیر دارای پیوند عمیق خرید بلیط باشد که فعال باشد.
  • 1 . غیر قابل دسترسی.
ticketing_deep_links.txt android_intent_uri URI اختیاری

افزونه فروش بلیت Google Transit.

فیلد android_intent_uri نشان دهنده URI قصدی است که برای پیوند عمیق در اندروید استفاده می شود.

ticketing_deep_links.txt ios_universal_link_url URL اختیاری

افزونه فروش بلیط Google Transit.

فیلد ios_universal_link_url نشان دهنده URL پیوند جهانی است که برای پیوند عمیق در iOS استفاده می شود.

ticketing_deep_links.txt ticketing_deep_link_id شناسه ضروری

افزونه فروش بلیط Google Transit.

فیلد ticketing_deep_link_id نشان دهنده شناسه پیوند عمیق است.

ticketing_deep_links.txt web_url URL اختیاری

افزونه فروش بلیط Google Transit.

فیلد web_url نشان دهنده URL است که برای پیوند عمیق در وب استفاده می شود.

ticketing_identifiers.txt agency_id شناسه ضروری

افزونه فروش بلیط Google Transit.

برای تعیین آژانس توقفی که فیلد پیش‌فرض ticketing_stop_id برای آن تعریف شده است، فیلد agency_id حاوی شناسه فایل GTFS agency.txt است.

ticketing_identifiers.txt stop_id شناسه ضروری

افزونه فروش بلیط Google Transit.

برای تعیین توقفی که فیلد پیش‌فرض ticketing_stop_id برای آن تعریف شده است، فیلد stop_id حاوی شناسه فایل GTFS stops.txt است.

ticketing_identifiers.txt ticketing_stop_id شناسه ضروری

افزونه فروش بلیط Google Transit.

فیلد ticketing_stop_id حاوی شناسه بلیط است که برای توقف اعمال می شود. به صورت اختیاری، یک آژانس شناسه را واجد شرایط می کند.

trips.txt exceptional Enum اختیاری

این قسمت نشان دهنده سفرهای استثنایی است. آنها خارج از برنامه منظم عمل می کنند یا به دلیل رویدادهای خاص یا اختلالات برنامه ریزی شده (مانند اجرای مسیر و غیره) از مسیر معمول منحرف می شوند.

گوگل گزینه های ارزش زیر را می پذیرد:

  • 0 . خدمات منظم
  • 1 . استثنا خدمات به عنوان مثال، خدماتی که به دلیل رویدادهای خاص اضافه می شوند یا خدماتی که به دلیل اختلالات برنامه ریزی شده از مسیر معمولی منحرف شده اند.
trips.txt ticketing_trip_id شناسه اختیاری

افزونه فروش بلیط Google Transit.

اگر فیلد ticketing_trip_id وجود داشته باشد، مقدار آن بر فیلد trip_id غلبه می‌کند تا سفر برای تهیه بلیط با پیوندهای عمیق شناسایی شود.

trips.txt ticketing_type Enum اختیاری

افزونه فروش بلیط Google Transit.

قسمت ticketing_type نوع بلیطی که برای این سفر اعمال می شود را مشخص می کند.

Google Transit مقادیر زیر را می پذیرد:

  • 0 . پیش فرض فقط در صورتی در دسترس است که آژانس یا مسیر دارای پیوند عمیق خرید بلیط باشد که فعال باشد.
  • 1 . غیر قابل دسترسی.
translations.txt lang کد زبان اختیاری

پسوند Google Transit.

فیلد lang بخشی از GTFS رسمی نیست، اما Google Transit در صورت وجود از این مقدار استفاده می‌کند.

برای تعیین ترجمه یک عبارت، از فیلد lang استفاده کنید. مقدار آن نباید خالی یا und (زبان تعریف نشده) باشد.

translations.txt trans_id شناسه اختیاری

پسوند Google Transit.

فیلد trans_id بخشی از GTFS رسمی نیست، اما Google Transit در صورت وجود از این مقدار استفاده می‌کند.

برای تعیین شناسه عبارتی که ترجمه برای آن ارائه شده است، از فیلد trans_id استفاده کنید. هر ردیف از جدول translations.txt به این معنی است که در lang زبان، عبارت trans_id به translation ترجمه می شود.

trips.txt original_trip_id شناسه اختیاری

پسوند Google Transit.

اگر در فایل trips.txt وجود داشته باشد، مقدار original_trip_id برای استفاده توسط سیستم‌های دیگر، مقدار trip_id لغو می‌کند. یک مثال تطبیق بلادرنگ است.

trips.txt trip_direction_name متن اختیاری

پسوند Google Transit.

قسمت trip_direction_name جهت سفر را به مسافران مشخص می کند. مقدار در این قسمت به عنوان مقدار direction_name هر سفر ذخیره می شود.

اگر مقدار stop_direction_name در جدول stop_times در طول سفر تغییر کند، ممکن است مقدار trip_direction_name لغو کند.

مقادیر در فیلد trip_direction_name به حروف عادی تبدیل می شوند.

trips.txt vehicle_category_id شناسه اختیاری

پسوند Google Transit.

در فایل trips.txt ، قسمت vehicle_category_id وسیله نقلیه ای را که به این سفر اختصاص داده شده است، مشخص می کند. وقتی این فیلد در فایل trips.txt باشد، مقدار آن بر مقدار vehicle_category_id در فایل routes.txt غلبه می کند.