مرجع الجدول الزمني الخاص بـ GTFS في Google والاختلافات بينهما

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

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

  • تفسير مختلف: تشمل هذه الحقول أجزاء المقالة الرسمية مواصفات الخلاصة العامة للنقل العام (GTFS) التي تفسرها Google Transit بشكل مختلف عن تعريف GTFS تلك الأجزاء.

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

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

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

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

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

يُرجى العِلم أنّ بعض المواصفات الرسمية التي يتجاهلها النقل العام لا تزال تجريبية. إلى لمزيد من المعلومات، يُرجى الانتقال إلى gtfs.org.

يسرد الجدول 1 ملفات GTFS غير المتوافقة مع ميزة 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

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

على الرغم من أنّ ميزة "النقل العام" تقبل حقول معيّنة محدّدة في 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 الذي يتيح استخدام النقل العام. إذا كانت قيمة trip_direction_name وstop_direction_name يكون الحقلان فارغين، وبالتالي تتركهما جهة استيراد النقل العام فارغَين. ضِمن في هذه الحالة، يمكن للشركاء استخدام السمة stop_headsign أو trip_headsign بدلاً من ذلك. قيم تمت تسوية حالة الحقل stop_direction_name.
stops.txt signposted_as النص اختياري

إضافة Google Transit.

يحتوي الحقل signposted_as على النص المكتوب حرفيًا على لافتة المنصة الأمثلة هي "نحو المنطقة المركزية" أو "الجانب الشرقي بروكلين".

حقل GTFS platform_code والسياسة المتوافقة مع النقل العام يمكن ضبط حقل 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 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) المقصود يُستخدم للربط بصفحات معينة في Android.
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 يحتوي على معرّف من مواصفات الخلاصة العامة للنقل العام stops.txt.
ticketing_identifiers.txt ticketing_stop_id رقم التعريف مطلوب

إضافة تذاكر في Google Transit

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

يشير هذا الحقل إلى الرحلات الاستثنائية. إنهم يعملون خارج جدول مواعيد منتظم أو أنها انحرفت عن المسار المعتاد بسبب الأحداث أو الاضطرابات المخطَّط لها (مثل مهام التتبع، وما إلى ذلك).

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

  • 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 وتستخدم ميزة النقل العام هذه القيمة عند توفّرها.

لتحديد ترجمة عبارة، استخدِم السمة 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.