الإضافات

الإضافات

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

عندما يرغب مطوّر برامج في تمديد مواصفات مواصفات الخلاصة العامة للنقل العام في الوقت الفعلي، عليه التواصل مع القائمة البريدية للإصدار 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-time-partner-support@google.com إشعارات النقل العام في "خرائط Google" مباشرةً
1003 OVapi gtfs-rt عند ovpi.nl http://gtfs.ovapi.nl
1004 ميترا ويليام آشباو w.l.ashbaugh@gmail.com
1005 مترو شمال سكك حديدية جون لارسن
1006 ريال سيتي دافيد فارغا http://realcity.io
1007 رابط قطار نيوساوث ويلز غريغوري نيكولز مناقشة المجموعة
1008 سبتمبر - هيئة النقل في جنوب شرق بنسلفانيا غريغوري أبيسوس https://github.com/septadev
1009 تذكرة سريعة mike@goswift.ly مناقشة جماعية
1010 مجموعة IBI عائم الحرب اقتراح GitHub للطوابع الزمنية الجديدة في "تنبيهات الخدمة"