الإضافات

الإضافات

لتسهيل اختبار الميزات الجديدة والسماح للمطوّرين بإضافة معلومات إضافية إلى خلاصة GTFS في الوقت الفعلي، سنستفيد من ميزة الإضافات في مخزن البروتوكولات المؤقت. تسمح لنا الإضافات بتحديد مساحة اسم في رسالة مخزن البروتوكول المؤقت حيث يمكن لمطوّري البرامج التابعين لجهات خارجية تحديد حقول إضافية بدون الحاجة إلى تعديل تعريف النموذج الأولي الأصلي.

وعندما يهتم أحد المطوّرين بتمديد مواصفات GTFS في الوقت الفعلي، عليه التواصل مع القائمة البريدية لـ GTFS في الوقت الفعلي وسنعيّن له معرّف الإضافة التالي المتاح، والذي يتم اختياره تدريجيًا من قائمة الأرقام التي تبدأ من 1000 والأعلى منها وتوثيقها في قسم سجلّ الإضافات الموجود أدناه.

تتوافق أرقام تعريف الإضافات التي تم تخصيصها مع أرقام تعريف العلامات المتاحة في مساحة الاسم extension لكل تعريف رسالة في الوقت الفعلي من خلال GTFS. والآن بعد أن تم تخصيص رقم تعريف الإضافة لمطوّر البرامج، سيستخدم هذا المعرّف عند توسيع أي من رسائل GTFS في الوقت الفعلي. وحتى إذا كان المطوّر يخطط فقط لتوسيع رسالة واحدة، سيتم الاحتفاظ بمعرّف الإضافة التي تم تعيينها لجميع الرسائل.

وبالنسبة إلى المطوّر الذي يوسّع المواصفات، بدلاً من إضافة حقل واحد مثل string أو int32 باستخدام رقم تعريف الإضافة، فإنّ النموذج المفضّل هو تحديد رسالة جديدة مثل MyTripDescriptorExtension، وتوسيع رسالة GTFS في الوقت الفعلي باستخدام رسالتك الجديدة، ثم إضافة جميع الحقول الجديدة فيها. وتتميّز هذه الميزة بخاصية رائعة تتيح لك إدارة الحقول داخل رسالة الإضافة بالطريقة التي تريدها، بدون الحاجة إلى حجز معرّف إضافة جديد من القائمة الأساسية.

message MyTripDescriptorExtension {
  optional string some_string = 1;
  optional bool some_bool = 2;
  ...
}
extend transit_realtime.TripDescriptor {
  optional MyTripDescriptorExtension my_trip_descriptor = YOUR_EXTENSION_ID;
}

سجلّ الإضافات

رقم تعريف الإضافة المطوّر جهة اتصال التفاصيل
1,000 OneBusAway onebusaway-developers https://github.com/OneBusAway/onebusaway/wiki/GTFS-Realtime-Resources
1001 هيئة النقل العام في مدينة نيويورك موارد تطوير البرامج (mtadeveloperresources) http://mta.info/developers/
1002 Google transit-realtime-partner-support@google.com إشعارات ميزة "النقل العام المباشر" في "خرائط Google"
1003 OVapi gtfs-rt at ovapi.nl http://gtfs.ovapi.nl
1004 مترو ويليام أشباغ w.l.ashbaugh@gmail.com
1005 سكة الحديد المركزية الشمالية جون لارسن
1006 realCity ديفيد فارغا http://realcity.io
1007 رابط القطار في "نيو ساوث ويلز" غريغوري نيكولز مناقشة جماعية
1008 SEPTA - هيئة النقل في جنوب شرق بنسلفانيا غريغوري أبيسوس https://github.com/septadev
1009 بسرعة mike@goswift.ly مناقشة جماعية
1010 مجموعة IBI ريتيش ورد اقتراح GitHub للطوابع الزمنية الجديدة في تنبيهات الخدمة