مرجع Google Transit GTFS Realtime و تفاوت ها

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

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

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

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

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

حمل و نقل بلادرنگ

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

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

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

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

جدول 1. فیلدهای رسمی نادیده گرفته شده در فیدهای بلادرنگ
پیام فیلد نادیده گرفته شده در GTFS تعریف شده است نوع میدان
Alert پیام image تصویر ترجمه شده
Alert پیام image_alternative_text TranslatedString
Alert پیام severity_level Enum
Alert پیام tts_description_text پروتو
Alert پیام tts_header_text پروتو
پیام CarriageDetails id رشته
پیام CarriageDetails occupancy_percentage int32
Position پیام bearing شناور
Position پیام odometer دو برابر
Position پیام speed شناور
Shape پیام encoded_polyline رشته
Shape پیام shape_id رشته
پیام StopTimeUpdate (در TripUpdate ) arrival.uncertainty int32
پیام StopTimeUpdate (در TripUpdate ) stop_time_properties پروتو
TripUpdate پیام دهید trip_properties پروتو
TripUpdate پیام دهید vehicle VehicleDescriptor
پیام VehicleDescriptor license_plate رشته
پیام VehicleDescriptor wheelchair_accessible ویلچر قابل دسترسی
پیام VehiclePosition congestion_level Enum
پیام VehiclePosition current_status وضعیت توقف خودرو
پیام VehiclePosition current_stop_sequence uint32
پیام VehiclePosition multi_carriage_details.id رشته
پیام VehiclePosition occupancy_percentage uint32
پیام VehiclePosition stop_id رشته

تفسیرهای مختلف در فیدهای بیدرنگ

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

جدول 2 فیلدهای تعریف شده توسط GTFS را در فیدهای بلادرنگ فهرست می کند که یا اختیاری هستند یا به صورت مشروط توسط Transit مورد نیاز هستند. برای فیلدهای اختیاری، جدول نشان می دهد که آیا مقادیر enum توسط Transit پشتیبانی می شوند یا خیر.

جدول 2. تفاسیر متفاوت فیلدهای خوراک بیدرنگ
نام فایل فیلد تعریف شده در GTFS نوع میدان توسط Google Transit مورد نیاز است؟ جزئیات پیاده سازی Google Transit
پیام StopTimeUpdate (در TripUpdate ) stop_id رشته مشروط مورد نیاز است

هنگامی که یک رشته stop_id ارائه می شود، باید یکی از شرایط زیر را داشته باشد:

  • رشته stop_id باید مانند فایل stops.txt در فید GTFS مربوطه باشد.
  • اگر از یک رشته stop_id متفاوت استفاده شود، رشته stop_id ارائه شده باید یک رشته خواهر و برادر یا فرزند از رشته stop_id اصلی باشد که در GTFS ثابت ارائه شده است. فیلد stop_sequence مربوطه نیز باید ارائه شود.
پیام StopTimeUpdate schedule_relationship Enum اختیاری

Google Transit از مقادیر enum زیر پشتیبانی می کند:

  • SCHEDULED
  • SKIPPED
  • NO_DATA
پیام TripDescriptor schedule_relationship Enum اختیاری

Google Transit از مقادیر enum زیر پشتیبانی نمی کند:

  • DUPLICATED
  • CANCELED - زمانی که برای سوابق TripUpdate نباشد

گوگل از مقادیر enum زیر پشتیبانی می کند:

  • SCHEDULED
  • UNSCHEDULED
  • ADDED
  • CANCELED — فقط برای سوابق TripUpdate پشتیبانی می شود

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

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

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

    در زمان انتشار این مقاله، هیچ فیلدی به این دسته تعلق ندارد. اگر به کمک نیاز دارید، با Google Transit تماس بگیرید.