يصف GTFS Schedule عرض النقل المخطط. يقوم GTFS Realtime، المعروف غالبًا بـ GTFS-RT، بنقل معلومات محدثة حول الخدمة. يصف GBFS خدمات التنقل المشتركة، بما في ذلك محطاتها والمركبات المتاحة حسب البيانات المنشورة. اختر التنسيق بناءً على السؤال الذي يجب أن تحله تطبيقك.
تُنظم هذه التنسيقات البيانات؛ لكنها لا تضمن توفرها في كل مكان ولا جودة كل تدفق.
GTFS لتمثيل العرض المخطط
يجمع مجموعة ملفات جدولة GTFS Schedule ملفات جدوليّة تشرح بشكل خاص المشغلين، والمحطات، والخطوط، والرحلات ومرورها. تشير الجداول إلى الأيام المعنية. ترتبط الملفات بواسطة معرفات. مرجع GTFS Schedule.
يسمح بالإجابة على أسئلة مثل "أين تقع هذه المحطة؟" أو "ما هي مواعيد المرور المخططة لهذه الخدمة؟". لاستغلال جدول زمني، يجب تفسير التقويم والعلاقات بين الملفات.
قراءة قائمة المحطات فقط لا تكفي لإعادة بناء المرور. وبالمقابل، قد تكون موقع المحطة مفيدًا دون عرض الجداول الزمنية.
GTFS-RT لتحديث معلومات الخدمة
يمكن لـ GTFS Realtime توفير تحديثات الرحلات، مواقع المركبات والتنبيهات. تشمل تحديثات الرحلات المرور وتغييرات الخدمة. تستخدم التدفقات بروتوكول بروتوبافرز، وهو تنسيق تسلسل منظم. مقدمة GTFS Realtime.
يمكن للمنتج نشر بعض الفئات دون توفير جميع الأخرى. وجود تدفق موقع لا يضمن تقديرات لكل المحطات.
لواجهة الاستخدام، فرّق بين المرور المخطط والتقدير المحدث. يشرح دليلنا الجداول النظرية والوقت الحقيقي هذا الاختلاف من وجهة نظر المستخدم.
GBFS للتنقل المشترك
يستخدم GBFS تدفقات JSON لوصف خدمة التنقل المشتركة. بحسب النظام والإصدار، قد تقدم معلومات عن المحطات، حالتها، المركبات وخصائص أخرى للخدمة. توضح الوثائق تمييزًا بين معلومات المحطة وحالات التوفر. وثائق GBFS.
فصل في تطبيقك بين المواقع المستقرة نسبيًا والحالات التي تتغير بسرعة. احتفظ بإصدار التنسيق والطابع الزمني المناسب عند التفسير.
تدفق التوفر ليس API للحجز أو فتح القفل. إنه يساعد على اكتشاف العرض؛ وتتم عملية التأجير عبر الخدمة المعنية.
المقارنة حسب حالة الاستخدام
| الحاجة | التنسيق المراد مراجعته |
|---|---|
| وصف المحطات والخطوط المخططة | GTFS Schedule |
| تفسير المواعيد المخططة وأيام الخدمة | GTFS Schedule |
| تحديث المرور أو استلام معلومات الخدمة | GTFS-RT، حسب التدفقات المنشورة |
| تحديد مواقع محطات أو مركبات التنقل المشترك | GBFS، حسب البيانات المنشورة |
مثال تصميمي: تعرض خريطة محطات ترام ومحطات دراجات. تستخدم بيانات هيكلية للأماكن وحالات محدثة لتوفر الدراجات. كلتا الطبقتين لهما حاجات مختلفة من التخزين المؤقت والتحديث.
توقع حدود كل مصدر
تحقق من الإصدارات، الحقول الاختيارية، التغطية وحقوق الاستخدام. المعرف له معنى فقط في سياقه: يمكن لمنتجين استخدام سلاسل متطابقة لكيانات مختلفة.
توقع كذلك البيانات المفقودة أو المنتهية الصلاحية. لا يجب عرض قائمة فارغة من تدفق غير متوفر كغياب الخدمة. تجنب استبدال معلومات غير معروفة بصمت بصفر.
استخدام التدفقات مباشرة أو API
يسمح لك التكامل المباشر بتحمل مسؤولية جمع، التحقق وتفسير المصادر. قد تقدم API عقدًا مشتركًا، لكن يجب دائمًا قراءة تغطيتها، تحذيراتها وشروطها.
لحالة استخدام ROOTE أولى، راجع كيفية البحث عن محطات قريبة عبر API. ابدأ بحاجة واجهتك، ثم تحقق من الحقول المتاحة فعلًا.
قراءة مقتطفات واختيار بنية
في جدول GTFS، يربط مقتطف من ملف stop_times.txt بين رحلة، وتوقف، ومرور مخطط له. المثال المختصر أدناه تعليمي: لا يشكل مجموعة بيانات GTFS كاملة ويجب ربط معرفاته ب trips.txt و stops.txt والجداول الزمنية.
لـ GTFS الوقت الحقيقي، ابحث عن الكيان المفيد: يمكن لتحديث الرحلة TripUpdate تحديث مرور ما، يصف موقع المركبة VehiclePosition موقعاً، وترسل التنبيهات Alert معلومات خدمة. موقع المركبة ليس تلقائياً توقع وصول. التنسيق المستخدم هو Protocol Buffers ؛ تمثيل JSON التشخيصي ليس تدفق البيانات الثنائي المرجعي.
في GBFS، يصف ملف station_information المحطات بينما يصف station_status حالاتها المنشورة. أسماء بعض العدادات والملفات المتوفرة تختلف حسب النسخة. المقتطف JSON أدناه يوضح GBFS 2.3 وحقلي num_bikes_available و num_docks_available ؛ تحقق من النسخة قبل استخدام المثال.
يمكن أن تبدأ خريطة المواقع بالبيانات الهيكلية. بعد ذلك، يتطلب عرض المرات القادمة تحديثات متوافقة وتراجع مخطط بوضوح. يجب أن يدير عرض الدراجات المتاحة العدادات وظروف الاستئجار والصلاحية الزمنية. هذه الشاشات الثلاث لا تشترك تلقائياً في نفس سياسة التخزين المؤقت.
# Extrait pédagogique de stop_times.txt
trip_id,arrival_time,departure_time,stop_id,stop_sequence
trip_demo,08:10:00,08:10:00,stop_demo,1
# Extrait pédagogique de station_status en GBFS 2.3
{
"station_id": "station_demo",
"num_bikes_available": 3,
"num_docks_available": 7,
"is_installed": true,
"is_renting": true,
"is_returning": true,
"last_reported": 1720000000
}اختيار واجهة برمجة التطبيقات أو MCP لمنتجك
أسئلة شائعة
هل يحتوي GTFS تلقائياً على الوقت الحقيقي؟
لا. يمثل GTFS Schedule العرض المخطط؛ المعلومات المحدثة تأتي من تدفقات أخرى، خصوصًا GTFS-RT.
هل يسمح GBFS بفتح قفل دراجة؟
يصف الخدمة وبياناتها العامة. تتم عملية التأجير عبر القدرات التي يوفرها المشغل.
هل يضمن الشكل المعياري تغطية كاملة؟
لا. يحدد التنسيق هيكلًا؛ التغطية والمعلومات المنشورة تعتمد على المصادر.