مرجع جدول GTFS للنقل العام من Google والاختلافات

ملاحظة: للاطّلاع على المواصفات الرسمية المتعارف عليها لمواصفات الخلاصة العامة للنقل العام (GTFS)، انتقِل إلى gtfs.org. تم تعديل هذه الصفحة لتتضمّن المواصفات الرسمية اعتبارًا من 21 كانون الأول (ديسمبر) 2022. ولا يمكن استخدام الإصدارات الأحدث من هذا التاريخ.

توضّح هذه الصفحة الاختلافات الرئيسية بين الجدول الزمني الرسمي لنظام GTFS وتطبيق Google Transit للمواصفات في الجوانب التالية:

• المواصفات الرسمية التي تم تجاهلها: هذه الحقول هي جزء من ملف GTFS الرسمي. تُستخدَم هذه البيانات في تطبيق "النقل العام من Google" بدون أي خطأ، ولكن لا يتم استخدامها بشكل استباقي.

• تفسير مختلف: تتضمّن هذه الحقول أجزاءً من ملف GTFS الرسمي يفسّرها تطبيق "النقل العام في Google" بشكلٍ مختلف عن تعريف GTFS لهذه الأجزاء.

• الميزات التجريبية: هذه الحقول تجريبية في عملية تنفيذ "النقل العام من Google". إذا كنت تريد تنفيذ حقل تجريبي جديد، يُرجى التواصل مع فريق Google Transit.

• إضافة متوافقة مع "النقل العام من Google": لا تشكّل هذه الإضافة جزءًا من مواصفات GTFS الرسمية. تتضمّن الإضافة المتوافقة مع "النقل العام" كلّ من الإضافات العامة والإضافات الخاصة بخدمة "النقل العام من Google". يمكن لأي شريك إرسال هذه المعلومات إلى Transit في خلاصته.

معلومات النقل العام الثابتة

توثّق الأقسام التالية الاختلافات الرئيسية بين تنسيق GTFS الرسمي وطريقة Google Transit في تنفيذ الخلاصة الثابتة.

ملاحظة: يشير الموقع الإلكتروني الرسمي لـ GTFS (gtfs.org) إلى مواصفات النقل العام الثابتة باسم "جدول GTFS". على الموقع الإلكتروني للمطوّرين في "النقل العام في Google"، نستخدم مصطلح "النقل العام الثابت" للتمييز بينه وبين "النقل العام في الوقت الفعلي".

المواصفات الرسمية التي تم تجاهلها في الخلاصات الثابتة

بعض المواصفات الرسمية التي يتجاهلها تطبيق 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	التعداد
feed_info.txt	default_lang	رمز اللغة
feed_info.txt	feed_publisher_name	نص
pathways.txt	max_slope	عدد عائم
routes.txt	continuous_drop_off	التعداد
routes.txt	continuous_pickup	التعداد
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	التعداد

تفسير مختلف في الخلاصات الثابتة

على الرغم من أنّ Transit تقبل بعض الحقول المحدّدة في GTFS، إلا أنّها تفسّرها بطريقة مختلفة عن GTFS.

يعرض الجدول 3 الحقول في الخلاصات الثابتة التي تنفّذها Transit بشكل مختلف عن الوصف الواردة في GTFS.

الجدول 3: حقول الخلاصة الثابتة التي تم تنفيذها بشكل مختلف

اسم الملف	الحقل المحدّد في GTFS	نوع الحقل	هل هذا مطلوب من خلال "النقل العام من Google"؟	تفاصيل تنفيذ "النقل العام من Google"
fare_attributes.txt	transfers	التعداد	مطلوب	إضافة Google Transit يحدّ الإصدار العام من GTFS القيم بنطاق يتراوح بين 0 2. تقبل خدمة "النقل العام من Google" القيم من 0 إلى 5. استخدِم هذا الحقل لضبط الحد الأقصى لعدد عمليات النقل المسموح بها باستخدام الأجرة. ولا يشمل ذلك عمليات نقل الوحدات، والتي تُعرف أيضًا باسم عمليات نقل المقاعد. إذا كنت لا تريد وضع حدود لعدد عمليات النقل لرحلة معيّنة، اترك الحقل transfers فارغًا.
pathways.txt	pathway_mode	التعداد	اختياري	عند تحديد الحقل pathway_mode، إذا تم تركه فارغًا، يقبل محرّك بحث Google Transit هذا الحقل ويتعامل معه على أنّه غير معروف.
stop_times.txt	arrival_time	الوقت	مطلوبة بشروط	تقتصر ساعات العمل على القيم من 00 إلى 99، وهي أكثر من كافية للرحلات التي تستغرق ثلاثة أيام.
transfers.txt	transfer_type	التعداد	مطلوب	لا يُسمح بقيم 4 و5 ويتم تجاهلها. تتيح خدمة Google Transit القيم 0 و1 2 و3.
trips.txt	block_id	رقم التعريف	اختياري	لمزيد من المعلومات، يُرجى الاطّلاع على مثال على حظر عملية النقل.

إتاحة ميزة تجريبية في الخلاصات الثابتة

إذا كنت بحاجة إلى دعم لدمج حقول تجريبية جديدة في هذه الفئة، يُرجى التواصل مع Google Transit.

الإضافات المتوافقة مع "النقل العام من Google" في الخلاصات الثابتة

يوفّر الجدول 4 معلومات عن إضافات "النقل العام من Google". هذه الحقول ليست جزءًا من معيار GTFS الرسمي.

الجدول 4: إضافات الخلاصات الثابتة المتوافقة

اسم الملف	الحقل	نوع الحقل	هل هذا مطلوب من خلال "النقل العام من Google"؟	تفاصيل تنفيذ "النقل العام من Google"
fare_attributes.txt	ic_price	عدد عائم	اختياري	لا تتوفّر إضافة "النقل العام" من Google إلا للشركاء المقيمين في اليابان. يمثّل الحقل 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	التعداد	مطلوب	إضافة Google Transit للتعرّف على كيفية توسيع نطاق خيارات قيمة route_type المقبولة في GTFS من خلال "النقل العام من Google"، اطّلِع على أنواع مسارات GTFS الموسّعة.
stop_times.txt	stop_direction_name	نص	اختياري	إضافة Google Transit يحدِّد الحقل stop_direction_name اتجاه الرحلة للمسافرين. يتم تخزين الاتجاه كقيمة direction_name لمغادرة هذه المحطة. إذا كان حقل stop_direction_name فارغًا، يتم استخدام الحقل Transit-supported trip_direction_name بدلاً من ذلك. إذا كان حقلَا trip_direction_name وstop_direction_name فارغَين، يتركهما مستورِد السلع العابرة فارغَين. في هذه الحالة، يمكن للشركاء استخدام القيمة stop_headsign أو trip_headsign بدلاً من ذلك. يتم توحيد حالة أحرف قيم الحقل stop_direction_name.
stops.txt	signposted_as	نص	اختياري	إضافة Google Transit يحتوي الحقل signposted_as على النص الحرفي المكتوب على لوحة العرض الخاصة بالمنصة. تشمل الأمثلة "نحو وسط المدينة" و "الجانب الشرقي وبروكلينغ". يمكن ضبط حقل GTFS platform_code وحقل Transit-supported signposted_as في الوقت نفسه. تشمل الاختلافات بين الحقلين 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" في ملف agency.txt، يمثّل الحقل ticketing_deep_link_id الرابط لصفحة في التطبيق الذي يُستخدَم لحجز تذاكر الرحلات التي تقدّمها هذه الوكالة.
routes.txt	ticketing_deep_link_id	رقم التعريف	اختياري	إضافة بيع التذاكر في "النقل العام من Google" في ملف routes.txt، يمثّل الحقل ticketing_deep_link_id الرابط لصفحة في التطبيق الذي يُستخدَم لحجز الرحلات في مسار هذا.
stop_times.txt	ticketing_stop_time_id	رقم التعريف	اختياري	إضافة بيع التذاكر في "النقل العام من Google" إذا كان الحقل ticketing_stop_time_id متوفّرًا في ملف stop_times.txt، سيحلّ محل المعرّف الذي يمثّل وقت إيقاف بيع التذاكر باستخدام الروابط لصفحات في التطبيق.
stop_times.txt	ticketing_type	التعداد	اختياري	إضافة بيع التذاكر في "النقل العام من Google" يحدِّد حقل ticketing_type نوع التذاكر التي تنطبق على وقت التوقف هذا. تقبل خدمة "النقل العام" من Google القيم التالية: Empty. الإعداد التلقائي: كما هو محدّد في الرحلة. 0: لا يتوفّر هذا الخيار إلا إذا كانت الوكالة أو المسار يتضمّنان رابطًا لصفحة معيّنة في التطبيق تم تفعيله لحجز التذاكر. 1: غير متاح.
ticketing_deep_links.txt	android_intent_uri	معرّف الموارد المنتظم (URI)	اختياري	إضافة بيع التذاكر في "النقل العام من Google" يمثّل الحقل android_intent_uri معرّف الموارد المنتظم للهدف الذي يُستخدَم لإنشاء روابط لصفحات في التطبيق على Android.
ticketing_deep_links.txt	ios_universal_link_url	عنوان URL	اختياري	إضافة بيع التذاكر في "النقل العام من Google" يمثّل الحقل ios_universal_link_url عنوان URL لرابط عالمي يتم استخدامه للربط بصفحة معيّنة في التطبيق على نظام التشغيل iOS.
ticketing_deep_links.txt	ticketing_deep_link_id	رقم التعريف	مطلوب	إضافة بيع التذاكر في "النقل العام من Google" يمثّل الحقل ticketing_deep_link_id المعرّف للرابط لصفحة معيّنة في التطبيق.
ticketing_deep_links.txt	web_url	عنوان URL	اختياري	إضافة بيع التذاكر في "النقل العام من Google" يمثّل الحقل web_url عنوان URL المستخدَم لربط صفحة معيّنة على الويب.
ticketing_identifiers.txt	agency_id	رقم التعريف	مطلوب	إضافة بيع التذاكر في "النقل العام من Google" لتحديد وكالة المحطة التي تم تحديد الحقل التلقائي ticketing_stop_id لها، يحتوي الحقل agency_id على المعرّف من ملف GTFS agency.txt.
ticketing_identifiers.txt	stop_id	رقم التعريف	مطلوب	إضافة بيع التذاكر في "النقل العام من Google" لتحديد المحطة التي تم تحديد الحقل التلقائي ticketing_stop_id لها، يحتوي الحقل stop_id على رقم التعريف من ملف stops.txt الخاص بمواصفات GTFS.
ticketing_identifiers.txt	ticketing_stop_id	رقم التعريف	مطلوب	إضافة بيع التذاكر في "النقل العام من Google" يحتوي الحقل ticketing_stop_id على معرّف التذاكر الذي يتم تطبيقه على المحطة. يمكن للوكالة تحديد مدى أهلية المستند التعريفي، وذلك اختياريًا.
trips.txt	exceptional	التعداد	اختياري	يشير هذا الحقل إلى الرحلات الاستثنائية. تعمل هذه الخدمات خارج الجدول الزمني العادي أو يتم تحويلها عن المسار المعتاد بسبب أحداث خاصة أو انقطاعات مخطط لها (مثل أعمال صيانة السكك الحديدية وما إلى ذلك). تقبل Google خيارات القيمة التالية: 0. الخدمات العادية 1. استثناء الخدمة على سبيل المثال، الخدمات التي تتم إضافتها بسبب أحداث خاصة أو خدمات يتم توجيهها بعيدًا عن المسار المعتاد بسبب انقطاعات مخطّط لها.
trips.txt	ticketing_trip_id	رقم التعريف	اختياري	إضافة بيع التذاكر في "النقل العام من Google" إذا كان حقل ticketing_trip_id متوفّرًا، تُلغي قيمته حقل trip_id لتحديد الرحلة التي يتم شراء تذاكرها باستخدام الروابط لصفحات في التطبيق.
trips.txt	ticketing_type	التعداد	اختياري	إضافة بيع التذاكر في "النقل العام من Google" يحدّد حقل ticketing_type نوع التذاكر السارية لهذه الرحلة. تقبل خدمة "النقل العام" من Google القيم التالية: 0: الإعداد التلقائي. لا يتوفّر هذا الخيار إلا إذا كانت الوكالة أو المسار يتضمّنان رابطًا لصفحة شراء التذاكر مفعّلاً. 1: غير متاح.
translations.txt	lang	رمز اللغة	اختياري	إضافة Google Transit لا يُعدّ الحقل lang جزءًا من معيار GTFS الرسمي، ولكن تستخدم منصة Google Transit هذه القيمة عند توفّرها. لتحديد ترجمة عبارة، استخدِم الحقل lang. يجب ألّا تكون قيمته فارغة أو und (لغة غير محدّدة).
translations.txt	trans_id	رقم التعريف	اختياري	إضافة Google Transit لا يُعدّ الحقل trans_id جزءًا من معيار GTFS الرسمي، ولكن تستخدم خدمة "النقل العام من Google" هذه القيمة عند توفّرها. لتحديد رمز تعريف العبارة التي يتم تقديم الترجمة لها، استخدِم الحقل trans_id. يشير كل صف من جدول translations.txt إلى أنّه في اللغة lang، تتم ترجمة العبارة trans_id إلى translation.
trips.txt	original_trip_id	رقم التعريف	اختياري	إضافة Google Transit إذا كانت القيمة original_trip_id متوفّرة في ملف trips.txt، سيتم إلغاء القيمة 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.
vehicle_categories.txt	vehicle_category_id	رقم التعريف	مطلوب	إضافة Google Transit تُحدِّد فئة المركبة.
vehicle_categories.txt	vehicle_amenity_id	رقم التعريف	اختياري	إضافة Google Transit تُحدِّد مجموعة من وسائل الراحة المتاحة لجميع الركاب في فئة المركبات. بدلاً من ذلك، يمكنك الاطّلاع على vehicle_category_amenities.txt لمعرفة الحالات التي تتوفّر فيها مجموعات مختلفة من وسائل الراحة في فئة المركبات نفسها.
vehicle_amenities.txt	vehicle_amenity_id	رقم التعريف	مطلوب	إضافة Google Transit يحدِّد مجموعة من وسائل الراحة.
vehicle_amenities.txt	ac_availability	التعداد	اختياري	إضافة Google Transit لتحديد ما إذا كانت مكيّفات الهواء متوفّرة. تقبل Google القيم التالية: 0: الإعداد التلقائي. غير معروف. 1: تتوفّر هذه الميزة في أي مكان وفي أي وقت. 2: غير متاح.
vehicle_amenities.txt	wifi_availability	التعداد	اختياري	إضافة Google Transit يحدِّد ما إذا كانت شبكة Wi-Fi متاحة على متن الطائرة. تقبل Google القيم التالية: 0: الإعداد التلقائي. غير معروف. 1: تتوفّر هذه الميزة في أي مكان وفي أي وقت. 2: غير متاح.
vehicle_amenities.txt	toilet_availability	التعداد	اختياري	إضافة Google Transit لتحديد ما إذا كان هناك مرحاض داخل المركبة تقبل Google القيم التالية: 0: الإعداد التلقائي. غير معروف. 1: تتوفّر هذه الميزة في أي مكان وفي أي وقت. 2: غير متاح.
vehicle_amenities.txt	gender_accessibility	التعداد	اختياري	إضافة Google Transit لتحديد ما إذا كانت القيود المتعلّقة بالجنس تنطبق. تقبل Google القيم التالية: 0: الإعداد التلقائي. غير معروف. 1. ما مِن قيود على الجنس. 2: للنساء فقط 3: متاح للرجال فقط.
vehicle_amenities.txt	seat_type	التعداد	اختياري	إضافة Google Transit لتحديد نوع المقعد تقبل Google القيم التالية: 0: الإعداد التلقائي. المقعد (غير قابل للطي، وقد يكون قابلاً للإمالة) 1. سرير ثابت (لا يمكن إمالاؤه للخلف كمقعد) 2. مقعد قابل للميل
vehicle_amenities.txt	service_class	التعداد	اختياري	إضافة Google Transit لتحديد فئة المقعد تقبل Google القيم التالية: 0: الإعداد التلقائي. غير معروف. 1. الدرجة الأولى. 2. الدرجة الثانية 3. الفئة الثالثة 4. Business 5. الدرجة الاقتصادية المميزة 6. الدرجة الاقتصادية
vehicle_amenities.txt	service_class_code	سلسلة	اختياري	إضافة Google Transit لتحديد رمز فئة قصير (مثل 1A للدرجة الأولى المزوّدة بمكيّف هواء) هذا الحقل هو نسخة أكثر تحديدًا من حقل الفئة، حيث يمكن تحديد الفئات غير المتوفّرة في قائمة القيم المحدّدة للفئة.
vehicle_amenities.txt	seat_plug	التعداد	اختياري	إضافة Google Transit يحدِّد ما إذا كان هناك مقبس كهربائي أو مقبس USB (من أي نوع) متوفّرًا في المقعد. تقبل Google القيم التالية: 0: الإعداد التلقائي. غير معروف. 1: متاح في جميع المقاعد. 2: غير متاح.
vehicle_amenities.txt	row_layout_summary	سلسلة	اختياري	إضافة Google Transit تحدِّد هذه السمة عدد المقاعد أو الأسرّة في صف واحد من المركبة. في ما يلي بعض الأمثلة: "2" (مقعدان في صف واحد، ولكن لا يُعرف ما إذا كانا منفصلَين أو بجانب بعضهما)، و"1+1" (مقعدان فرديان في صف واحد)، و"2+2" (4 مقاعد في صف واحد مع فواصل في المنتصف).
vehicle_amenities.txt	row_leg_space	التعداد	اختياري	إضافة Google Transit لتحديد ما إذا كانت الصفوف تتضمّن مساحة إضافية للأرجل. تقبل Google القيم التالية: 0: الإعداد التلقائي. غير معروف / لا ينطبق 1. مساحة عادية للأرجل 2. مساحة إضافية للساقَين
vehicle_category_amenities.txt	vehicle_category_id	رقم التعريف	مطلوب	إضافة Google Transit تُحدِّد فئة المركبة. يمكن أن تحتوي فئة المركبات نفسها على عدة مجموعات من وسائل الراحة من خلال تكرار قيمة هذا الحقل في عدة صفوف. يكون ذلك مفيدًا عادةً عندما تحتوي فئة المركبات على فئات خدمة مختلفة.
vehicle_category_amenities.txt	vehicle_amenity_id	رقم التعريف	مطلوب	إضافة Google Transit تُحدِّد مجموعة من وسائل الراحة المتاحة لجميع الركاب في فئة المركبات.

ملاحظة: لمزيد من المعلومات عن الاختلافات بين استخدام GTFS Realtime وGoogle Transit، يمكنك الرجوع إلى هذه المقالة.