واجهة iBus البرمجية للنقل العام
المحطات والخطوط والجداول ومواعيد الوصول المباشرة والرسائل الرسمية عن تغييرات الحركة في المواصلات العامة في إسرائيل، بصيغة JSON عبر HTTPS. البيانات نفسها التي يستخدمها تطبيق iBus، للمشاريع ذات الطلب المقبول.
- 271جادة يروشلايم/خليج شلومومباشر אגדالآن
- 42ת.רק''ל הקוממיות/דרך בגיןحسب الجدول דן17:01
عرض JSON لهذه الاستجابة
{
"stopId": "21472",
"updatedAt": "2026-10-21T17:16:22+03:00",
"stale": false,
"arrivals": [
{
"vehicle_ref": "AVEexampleVehicle01",
"line_ref": "9877",
"route_short_name": "271",
"agency_id": "3",
"agency_name": "אגד",
"stop_point_ref": "21472",
"direction_ref": "1",
"dated_vehicle_journey_ref": "9719820",
"data_frame_ref": "2026-10-21",
"item_identifier": "1433250322",
"confidence_level": "probablyReliable",
"call_order": 17,
"distance_from_stop_m": 6887,
"latitude": 32.0769,
"longitude": 34.792049,
"bearing": 206.0,
"velocity": 0.0,
"motion": "stopped",
"destination_name": "Yerushalayim Boulevard/Mifrats Shlomo",
"destination_ref": "35810",
"direction_text": null,
"current_stop_name": null,
"current_stop_code": "21472",
"origin_aimed_departure_utc": "2026-10-21T13:45:00Z",
"expected_arrival_utc": "2026-10-21T14:17:00Z",
"aimed_arrival_utc": null,
"recorded_at_utc": "2026-10-21T14:16:05Z",
"expected_in_min": 0,
"wheelchair_accessible": 1,
"stops_remaining": 16,
"freshness": {
"state": "live",
"age_sec": 17,
"observed_at_utc": "2026-10-21T14:16:05Z"
},
"observation_age_sec": 17,
"gtfs_trip_id": "8947270_211026",
"gtfs_stop_sequence": 17,
"dest_code": "35810",
"dest_names": {
"he": "שדרות ירושלים/מפרץ שלמה",
"en": "Yerushalayim Boulevard/Mifrats Shlomo",
"ar": "جادة يروشلايم/خليج شلومو"
},
"trust": {
"v": 1,
"observed_at_utc": "2026-10-21T14:16:05Z",
"received_at_utc": "2026-10-21T14:16:22Z",
"age_sec": 17,
"freshness": "live",
"identity": "exact",
"position": "ok",
"checks": {
"motion": "ok",
"time": "ok",
"geometry": "unknown",
"direction": "unknown"
},
"issues": [],
"forecast": "source",
"verdict": "live"
},
"vtok": "EXAMPLEpass1"
},
{
"vehicle_ref": "AVEexampleVehicle02",
"line_ref": "2454",
"route_short_name": "42",
"agency_id": "5",
"agency_name": "דן",
"stop_point_ref": "21472",
"direction_ref": "1",
"dated_vehicle_journey_ref": "3019375",
"data_frame_ref": "2026-10-21",
"item_identifier": "1433250318",
"confidence_level": "probablyReliable",
"call_order": 24,
"distance_from_stop_m": 8190,
"latitude": 32.080585,
"longitude": 34.79604,
"bearing": 248.0,
"velocity": 0.0,
"motion": "stopped",
"destination_name": "ת.רק''ל הקוממיות/דרך בגין",
"destination_ref": "36108",
"direction_text": null,
"current_stop_name": null,
"current_stop_code": "21472",
"origin_aimed_departure_utc": "2026-10-21T13:35:00Z",
"expected_arrival_utc": "2026-10-21T14:17:00Z",
"aimed_arrival_utc": null,
"recorded_at_utc": "2026-10-21T14:14:15Z",
"expected_in_min": 0,
"wheelchair_accessible": 1,
"stops_remaining": 23,
"freshness": {
"state": "scheduled_confirmed",
"age_sec": 127,
"observed_at_utc": "2026-10-21T14:14:15Z",
"basis": "gtfs_confirmed_stale_observation",
"scheduled_arrival_utc": "2026-10-21T14:01:54Z"
},
"observation_age_sec": 127,
"stale_observation": true,
"schedule_confirmed": true,
"gtfs_trip_id": "3019266_211026",
"gtfs_stop_sequence": 24,
"gtfs_scheduled_arrival_utc": "2026-10-21T14:01:54Z",
"gtfs_scheduled_departure_utc": "2026-10-21T14:01:54Z",
"dest_code": "36108",
"dest_names": {
"he": "ת.רק''ל הקוממיות/דרך בגין",
"en": "ת.רק''ל הקוממיות/דרך בגין",
"ar": "ת.רק''ל הקוממיות/דרך בגין"
},
"trust": {
"v": 1,
"observed_at_utc": "2026-10-21T14:14:15Z",
"received_at_utc": "2026-10-21T14:16:22Z",
"age_sec": 127,
"freshness": "scheduled_confirmed",
"identity": "exact",
"position": "ok",
"checks": {
"motion": "ok",
"time": "ok",
"geometry": "unknown",
"direction": "unknown"
},
"issues": [],
"forecast": "timetable",
"verdict": "schedule"
},
"vtok": "EXAMPLEpass2"
}
],
"source": "siri",
"server_now_utc": "2026-10-21T14:16:22Z",
"freshness_contract": 1,
"source_state": "ok"
}ماذا يمكنك أن تحصل عليه#
- المحطات. البحث بالاسم أو الرمز، ومحطة مع عنوانها ومنطقة التعرفة، والمحطات حول نقطة، ومحطات القطار.
- البيانات المباشرة. المركبات المتجهة إلى محطة. يوضّح كل صف مدى حداثته.
- جدول المواعيد. كل رحلات محطة أو مسار في يوم خدمة.
- الخطوط. مسارات رقم الخط ومحطاتها وتفرعاتها وشكلها على الطريق.
- تنبيهات الخدمة. التحويلات والمحطات المنقولة أو الملغاة والأشغال التي تنشرها وزارة المواصلات.
الوصول#
تتصل عمليات الربط بالواجهة من خادم بمفتاح مشروع مقبول: Authorization: Bearer <المفتاح>. كيف تحصل على الوصول. الوظائف الشخصية لتطبيق iBus (المفضلة والإشعارات والمساعد ليئور) ليست جزءًا من هذه الواجهة؛ انظر الوصول والمفاتيح والخصوصية.
المفتاح مطلوب: منذ 24.10.2026 لا تجيب عمليات /api/transport/ إلا على الطلبات التي تحمل مفتاحًا (بدونه: 401 KEY_REQUIRED). العناوين القديمة بدون /transport ما زالت تجيب بدون مفتاح مؤقتًا (فترة انتقالية)؛ سنعلن عن نهايتها في صفحة الوصول مسبقًا.
طلبك الأول#
curl -H "Authorization: Bearer $IBUS_API_KEY" "https://api.ibusisrael.online/api/transport/stops/search?q=Azrieli&limit=3&lang=en"احفظ المفتاح على خادمك، مثلًا في متغير البيئة IBUS_API_KEY الذي تستخدمه كل الأمثلة.
يعرض الرد محطات مع رمزها العام واسمها وموقعها. بهذا الرمز يمكنك طلب مواعيد الوصول: يشرح دليل الطلب الأول ذلك خطوة بخطوة.
بيانات يمكن الاعتماد عليها#
كل صف مباشر يحمل freshness. فقط الصفوف التي فيها freshness.state = "live" هي توقعات مباشرة. لا تُعرض ملاحظة قديمة أبدًا على أنها مباشرة، ويُوسم الوقت المأخوذ من الجدول بذلك.
أوقات الجدول هي أوقات GTFS ليوم الخدمة، وقد تكون بعد 24:00. الشرح وكذلك المعرّفات في صفحة البيانات والوقت.
الحدود#
الحدود تخص المشروع: طلبات في الدقيقة (مع دفعة قصيرة) وفي اليوم وفي الشهر، وطلبات في الوقت نفسه، وميزانية منفصلة للعمليات الثقيلة. عند تجاوز حد يكون الرد 429 مع Retry-After. التفاصيل: الحدود والأخطاء.
للأدوات ومساعدي الذكاء الاصطناعي#
- مواصفة OpenAPI 3.1 للعمليات المنشورة: openapi.json
- خريطة قصيرة لنماذج اللغة: llms.txt
- كل دليل بصيغة Markdown أيضًا، مثل هذه الصفحة
كل العمليات المنشورة#
| الطريقة | العملية | البيانات |
|---|---|---|
| GET | حالة الخدمة /api/transport/healthz | مرجعي |
| GET | قواعد حداثة البيانات المباشرة /api/transport/contract/freshness | مرجعي |
| GET | البحث عن المحطات بالاسم أو الرمز /api/transport/stops/search | مرجعي |
| GET | محطة: الموقع والعنوان ومنطقة التعرفة /api/transport/stop/{stopCode} | مرجعي |
| GET | المحطات حول نقطة /api/transport/nearby_stops | مرجعي |
| GET | أسماء ومواقع حتى 50 محطة /api/transport/gw/stops/brief | مرجعي |
| GET | مواعيد الوصول المتوقعة إلى محطة (مباشر) /api/transport/v2/stop/{stopCode}/arrivals | مباشر |
| GET | جدول مواعيد محطة ليوم خدمة /api/transport/stop/{stopCode}/day_schedule | جدول المواعيد |
| GET | محطات قطارات إسرائيل /api/transport/gw/rail/stations | مرجعي |
| GET | البحث عن الخطوط بالرقم /api/transport/routes/search | مرجعي |
| GET | مسار ومحطاته /api/transport/line/{routeId}/full | مرجعي |
| GET | شكل المسار على الطريق في تاريخ معيّن /api/transport/gw/line/{routeId}/shape | مرجعي |
| GET | كل تفرعات الخط الذي ينتمي إليه المسار /api/transport/gw/line/{routeId}/variants | مرجعي |
| GET | تفرعات خط حسب الرقم /api/transport/gw/line/variants | مرجعي |
| GET | رحلات المسار ليوم خدمة /api/transport/line/{routeId}/day_schedule | جدول المواعيد |
| GET | تنبيهات الخدمة /api/transport/alerts | تنبيهات |
| GET | تنبيه واحد /api/transport/alerts/{alertId} | تنبيهات |
| GET | تنبيهات تخص محطة /api/transport/alerts/by-stop/{stopCode} | تنبيهات |
| GET | تنبيهات تخص مسارًا /api/transport/alerts/by-line/{agencyId}/{routeId} | تنبيهات |
| GET | مشغلو النقل /api/transport/agencies | مرجعي |
| GET | إصدار قائمة المحطات /api/transport/stops/version | مرجعي |
| GET | هل التاريخ ضمن الجدول وهل هو يوم عادي /api/transport/gw/service-day | مرجعي |
| GET | ما يراه الخادم عن طلبك (العنوان، المفتاح، المشروع) /api/access/whoami | الوصول |