البيانات والوقت
المصادر#
| البيانات | المصدر | كم مرة يحدّثها iBus |
|---|---|---|
| الجدول: المحطات والمسارات والرحلات والتقويم | وزارة المواصلات، GTFS | كل ليلة نحو الساعة 04:00 بتوقيت إسرائيل؛ يتغيّر getStopsVersion عند نشر جدول جديد |
| البيانات المباشرة: المركبات المقتربة من المحطات | وزارة المواصلات، SIRI | يُسأل المصدر كل بضع ثوانٍ؛ ترسل المركبة موقعها تقريبًا كل 20 إلى 60 ثانية |
| تنبيهات الخدمة | وزارة المواصلات | تقريبًا كل 5 دقائق |
يعالج iBus البيانات (المطابقة والحداثة والأسماء بثلاث لغات). وهو ليس خدمة رسمية للوزارة.
الجدول والبيانات المباشرة ردّان مختلفان#
- عمليات الجدول (
getStopDayScheduleوgetLineDaySchedule) تجيب عمّا هو مخطط ليوم خدمة. ولا تعرف شيئًا عن التأخيرات. - البيانات المباشرة (
getStopArrivals) تجيب بما تبلغ عنه المركبات الآن، صفًا صفًا، معfreshness. - الصف المباشر الذي ملاحظته قديمة يُعرض بوقت الجدول فقط إذا أكّد الجدول أن هذه الرحلة تتوقف في هذه المحطة في يوم الخدمة هذا (
scheduled_confirmed). وإلا يبقىstale_observation.
قواعد الحداثة#
تأتي العتبات من getFreshnessContract (الإصدار 1):
| القاعدة | القيمة |
|---|---|
| ملاحظة المركبة مباشرة | ليست أقدم من 120 ثانية |
| لا يُعرض موعد الوصول من ملاحظة قديمة كوقت | أقدم من 1,800 ثانية (eta_hidden) |
| تُعدّ التنبيهات متأخرة | أقدم من 900 ثانية |
| لا يُوثق بملاحظة مؤرخة في المستقبل | أكثر من 300 ثانية إلى الأمام |
تُحسب الأعمار حسب ساعة الخادم (server_now_utc في الرد)، لا حسب وقت طلبك.
يوم الخدمة والأوقات بعد منتصف الليل#
يوم الخدمة (date=YYYYMMDD) هو يوم التشغيل الذي تنتمي إليه الرحلة. أوقات الجدول نصوص GTFS بصيغة HH:MM:SS حسب ساعة إسرائيل في يوم الخدمة، وقد تكون 24:00:00 أو بعدها: 25:04:48 في يوم الخدمة 2026-10-21 تعني 01:04:48 يوم 22 أكتوبر، والرحلة ما زالت تنتمي إلى 21 أكتوبر.
- رتّب صفوف الجدول حسب النص كما هو:
24:10:00تأتي بعد23:50:00. - للحصول على وقت تقويمي، انقل الساعات الزائدة على 24 إلى اليوم التالي.
- من دون
dateيُستخدم يوم الخدمة الحالي في إسرائيل. التاريخ بصيغة أخرى يعيد قائمة فارغة لا خطأ. - يغطي الجدول المنشور نحو شهر إلى الأمام. تبيّن
getServiceDayما إذا كان التاريخ داخله (feed.fromوfeed.to) وما إذا كان يختلف عن يوم عادي من اليوم نفسه في الأسبوع (الأعياد).
تغيير الساعة. تكتب الوزارة أوقات الجدول حسب الساعة حتى في ليالي تغيير الساعة (تم التحقق في 19.10.2026 على 1,534 من 1,559 رحلة ليلية في 25.10.2026). أما أوقات UTC التي يحسبها iBus من الجدول (gtfs_scheduled_*_utc وfreshness.scheduled_arrival_utc وfirst_departure_utc) فما زالت تُحسب وفق قاعدة GTFS «الظهر ناقص 12 ساعة»: للرحلات قبل 02:00 في يوم التغيير (25.10.2026 و26.03.2027) قد تختلف بساعة. اعتمد على الصفوف المباشرة في تلك الليالي.
حقول الوقت#
- الحقول المنتهية بـ
_utcهي بتوقيت UTC بصيغة ISO 8601 معZ، مثل2026-10-21T14:17:00Z. updatedAtفي غلاف مواعيد الوصول هو بتوقيت إسرائيل المحلي مع الفارق، مثل2026-10-21T17:16:22+03:00.- تحتوي
dateRangesفي التنبيهات على ثوانٍ بنظام Unix (startوend) ونصوص UTC معًا.
المعرّفات#
| الحقل | ما هو |
|---|---|
stop_code | الرمز العام للمحطة، الرقم المكتوب على اللافتة. استخدمه في المسارات. |
stop_id | المعرّف الداخلي في GTFS. ليس الرمز العام. |
route_id (line_ref في البيانات المباشرة) | اتجاه واحد أو تفرّع واحد من الخط. تجده عبر searchLines. |
route_short_name | رقم الخط العام. ليس فريدًا: الخط 1 موجود في مدن كثيرة. |
agency_id | المشغّل. الأسماء في listAgencies. |
makat | معرّف الخط لدى الوزارة، مشترك بين اتجاهات الخط. |
dated_vehicle_journey_ref | معرّف الرحلة لدى المصدر. ليس trip_id في GTFS. |
gtfs_trip_id | رحلة GTFS، فقط عندما تتطابق رحلة واحدة بالضبط. |
vehicle_ref | اسم مستعار يومي للمركبة. يتغيّر كل يوم بتوقيت UTC ولا يكون أبدًا رقم اللوحة. |
direction_ref | الاتجاه لدى المصدر (1 أو 2). ليس direction_id في GTFS (0 أو 1). |
الإحداثيات والوحدات#
- الإحداثيات بنظام WGS 84 بالدرجات العشرية.
coordsلشكل المسار أزواج[lon, lat](بترتيب GeoJSON)؛ وshapeيكرّر النقاط على شكل{lat, lon}. - المسافات بالأمتار (
dist_mوdistance_from_stop_m)، والسرعة بالكيلومتر في الساعة (velocity)، والاتجاه بالدرجات من الشمال (bearing). - العمر بالثواني (
age_sec)، والانتظار بالدقائق الكاملة (expected_in_min)، والتعرفة بالشيكل (tariff).
لغات الأسماء#
يختار المعامل lang لغة أسماء المحطات والوجهات: en (وكذلك ru) يعطي الأسماء الإنجليزية من جدول الوزارة، وar يعطي العربية، وأي قيمة أخرى تعطي العبرية الأصلية. لا توجد أسماء روسية في المصدر. يحتوي الحقلان names وdest_names على العبرية والإنجليزية والعربية معًا. نصوص التنبيهات تنشرها الوزارة، وغالبًا بالعبرية.
التخزين المؤقت#
يبيّن كل رد في Cache-Control مدة الاحتفاظ به: البيانات المباشرة والجداول no-store، والبيانات المرجعية public من 60 ثانية إلى ساعة. مع Accept-Encoding: gzip تُضغط الردود: جدول اليوم لمحطة مزدحمة نحو 580 KB بصيغة JSON ونحو 27 KB مضغوطًا.