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

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

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

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

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

  • إضافة متوافقة مع "النقل العام من Google": لا تشكّل هذه الإضافة جزءًا من مواصفات GTFS الرسمية. تتضمّن الإضافة المتوافقة مع "النقل العام" كلّ من الإضافات العامة والإضافات الخاصة بخدمة "النقل العام من Google". يمكن لأي شريك إرسال هذه المعلومات إلى 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، إلا أنّها تفسّرها بطريقة مختلفة عن GTFS.

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

الجدول 3: حقول الخلاصة الثابتة التي تم تنفيذها بشكل مختلف
اسم الملف الحقل المحدّد في GTFS نوع الحقل هل هذا مطلوب من Google Transit؟ تفاصيل تنفيذ Google Transit
fare_attributes.txt transfers Enum مطلوب

إضافة Google Transit

يحدّ الإصدار العام من GTFS القيم بنطاق يتراوح بين 0 2. تقبل خدمة "النقل العام من Google" القيم من 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" في الخلاصات الثابتة

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

الجدول 4: إضافات الخلاصات الثابتة المتوافقة
اسم الملف الحقل نوع الحقل هل هذا مطلوب من Google Transit؟ تفاصيل تنفيذ Google Transit
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 Enum مطلوب

إضافة Google Transit

للتعرّف على كيفية توسيع نطاق خيارات قيمة route_type المقبولة في GTFS، يمكنك الاطّلاع على أنواع مسارات 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 Enum اختياري

إضافة بيع التذاكر في "النقل العام من 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 على رقم التعريف من ملف GTFS stops.txt.
ticketing_identifiers.txt ticketing_stop_id رقم التعريف مطلوب

إضافة بيع التذاكر في "النقل العام من Google"

يحتوي الحقل ticketing_stop_id على معرّف التذاكر الذي يتم تطبيقه على المحطة. يمكن للوكالة اختياريًا التأكّد من صحة رقم التعريف.
trips.txt exceptional Enum اختياري

يشير هذا الحقل إلى الرحلات الاستثنائية. تعمل هذه الخدمات خارج الجدول الزمني المعتاد أو يتم تحويلها عن المسار المعتاد بسبب أحداث خاصة أو انقطاعات مخططة (مثل أعمال صيانة السكك الحديدية وما إلى ذلك).

تقبل Google خيارات القيمة التالية:

  • 0. الخدمات العادية
  • 1. استثناء الخدمة على سبيل المثال، الخدمات التي تتم إضافتها بسبب أحداث خاصة أو خدمات تم تحويلها بعيدًا عن المسار المعتاد بسبب انقطاعات مخطّط لها.
trips.txt ticketing_trip_id رقم التعريف اختياري

إضافة بيع التذاكر في "النقل العام من Google"

إذا كان حقل ticketing_trip_id متوفّرًا، تُلغي قيمته حقل trip_id لتحديد الرحلة التي يتم شراء تذاكرها باستخدام الروابط لصفحات في التطبيق.
trips.txt ticketing_type Enum اختياري

إضافة بيع التذاكر في "النقل العام من 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 Enum اختياري

إضافة Google Transit

لتحديد ما إذا كانت مكيّفات الهواء متوفّرة.

تقبل Google القيم التالية:

  • 0: الإعداد التلقائي. غير معروف.
  • 1: تتوفّر هذه الميزة في أي مكان وفي أي وقت.
  • 2: غير متاح.
vehicle_amenities.txt toilet_availability Enum اختياري

إضافة Google Transit

لتحديد ما إذا كان هناك مرحاض داخل المركبة

تقبل Google القيم التالية:

  • 0: الإعداد التلقائي. غير معروف.
  • 1: تتوفّر هذه الميزة في أي مكان وفي أي وقت.
  • 2: غير متاح.
vehicle_amenities.txt gender_accessibility Enum اختياري

إضافة Google Transit

لتحديد ما إذا كانت القيود المتعلّقة بالجنس تنطبق.

تقبل Google القيم التالية:

  • 0: الإعداد التلقائي. غير معروف.
  • 1. ما مِن قيود على الجنس.
  • 2: للنساء فقط.
  • 3: متاح للرجال فقط.
vehicle_amenities.txt seat_type Enum اختياري

إضافة Google Transit

لتحديد نوع المقعد

تقبل Google القيم التالية:

  • 0: الإعداد التلقائي. المقعد (غير قابل للطي، وقد يكون قابلاً للإمالة)
  • 1. سرير ثابت (لا يمكن إمالاؤه للخلف كمقعد)
  • 2. مقعد قابل للميل
vehicle_amenities.txt service_class Enum اختياري

إضافة 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 Enum اختياري

إضافة 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 Enum اختياري

إضافة Google Transit

لتحديد ما إذا كانت الصفوف تتضمّن مساحة إضافية للأرجل.

تقبل Google القيم التالية:

  • 0: الإعداد التلقائي. غير معروف / لا ينطبق
  • 1. مساحة عادية للأرجل
  • 2. مساحة إضافية للساقَين
vehicle_category_amenities.txt vehicle_category_id رقم التعريف مطلوب

إضافة Google Transit

تُحدِّد فئة المركبة. يمكن أن تحتوي فئة المركبات نفسها على عدة مجموعات من وسائل الراحة من خلال تكرار قيمة هذا الحقل في عدة صفوف. يكون ذلك مفيدًا عادةً عندما تحتوي فئة المركبات على فئات خدمة مختلفة.
vehicle_category_amenities.txt vehicle_amenity_id رقم التعريف مطلوب

إضافة Google Transit

تُحدِّد مجموعة من وسائل الراحة المتاحة لجميع الركاب في فئة المركبات.