نظرة عامة
إذا لم تكن مقدّم خلاصات GTFS لخدمة "خرائط Google"، سيكون دمجك مخصّصًا للمحطات فقط. لإجراء عملية الدمج هذه، نحتاج إلى معرفة كيفية تحديد محطات القطار أو الحافلات المختلفة.
المواصفات العامة للخلاصات
عند بدء عملية الدمج، ننشئ معرّفًا فريدًا لكل عملية دمج، على سبيل المثال: ch_google_test (رمز البلد، اسم الشريك، عملية الدمج) أو eu_google (رمز المنطقة، اسم الشريك).
يمكن للشركاء تقديم ملف zip يحتوي على ملفات نصية بتنسيق CSV يتم تطبيقها على مستوى الحساب أو لكل عملية دمج:
المثال 1:
- ch_google_test_stops.txt
- ch_google_test_markets.txt
المثال 2:
- stops.txt (يتم تطبيقه على جميع عمليات الدمج)
- eu_google_integration1_markets.txt
- eu_google_integration2_markets.txt
مواصفات خلاصة التوقف (مطلوبة)
يجب أن يحتوي ملف التوقف على الأعمدة التالية:
| اسم الحقل | النوع (راجِع GTFS) | الوصف |
|---|---|---|
stop_id |
رقم التعريف (مطلوب) | المعرّف الفريد الذي يحدِّد محطة أو نقطة توقف يجب أن تحتوي المحطات الأكبر حجمًا على إدخال واحد فقط. يتم استخدام هذا عند إجراء طلبات بيانات من Partner Server API وفي الروابط لصفحات في التطبيق الخاصة بطلب التذاكر. |
stop_name |
النص (مطلوب) | اسم سهل القراءة للمستخدمين لتصحيح أخطاء بيانات تعيين نقاط التوقف وملء ذاكرة التخزين المؤقت ودقة الأسعار |
stop_lat |
خط العرض (مطلوب) | خط العرض للمحطة |
stop_lon |
خط الطول (مطلوب) | خط طول المحطة |
سنستخدم عملية نقل مبرمَجة يمكن للشركاء من خلالها باستمرار تقديم ملفات ZIP معدّلة عند تغيير المعلومات الواردة فيها. على سبيل المثال، يمكن للشريك توسيع المستودع الإعلاني المقدَّم من خلال توسيع قائمة المحطات. ومع ذلك، يجب أن تكون أرقام تعريف المحطات ثابتة، تمامًا مثل GTFS.
مواصفات خلاصة مجموعة الأسواق (اختيارية)
باستخدام المحطات المُحدَّدة، ننشئ مجموعة الأسواق لهذا الدمج (قائمة تحتوي على أزواج وجهة / منشأ رائجة). من هنا، يمكنك تقليل هذه المجموعة من الأسواق من خلال تقديم خلاصة مجموعة أسواق.
تعمل مجموعة الأسواق بمثابة قائمة مسموح بها: في حال عدم تقديم مجموعة أسواق، يتم تفعيل جميع الأسواق في عملية الدمج. في حال تقديم مجموعة أسواق، يتم إيقاف أي سوق ليس في القائمة.
يجب أن يحتوي ملف مجموعة الأسواق على الأعمدة التالية:
| اسم الحقل | النوع (راجِع GTFS) | الوصف |
|---|---|---|
origin_stop_id |
رقم التعريف (مطلوب) | نقطة منشأ stop_id السوق |
destination_stop_id |
رقم التعريف (مطلوب) | الوجهة stop_id للسوق. |
إعدادات الشريك
عند استخدام التكامل لإيقاف فقط، نطلب معلومات إضافية لإعداد الشريك الثابت كما هو موضح في قسم إعدادات الشريك.
الروابط المؤدية إلى صفحات بيع التذاكر
يتم تحديد تنسيق الرابط لصفحة في التطبيق ومَعلماته في روابط الحجز.
مَعلمات Partner API
تستند مَعلمات SegmentKeys لواجهة برمجة التطبيقات Partner API
(GetBulkTripOptionsRequest)
إلى مواصفات الروابط المؤدية إلى صفحات في التطبيق. نستخدم
SegmentKeys
التي تتضمّن from_ticketing_stop_time_id وto_ticketing_stop_time_id
service_date وboarding_time وarrival_time فقط، ونترك ticketing_trip_id
فارغًا. سنحدّد المسار بالكامل بما في ذلك جميع عمليات النقل من خلال تحديد
عدة مفاتيح SegmentKeys، واحدة لكلّ شريحة.