این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

مرجع و تفاوت‌های زمان‌بندی 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` غلبه می کند.