- المورد: TransitObject
- PassengerType
- TicketStatus
- ConcessionCategory
- TicketRestrictions
- PurchaseDetails
- TicketCost
- TicketLeg
- TicketSeat
- FareClass
- TripType
- ActivationStatus
- الولاية
- DeviceContext
- الطُرق
المورد: TransitObject
تمثيل JSON |
---|
{ "classReference": { object ( |
الحقول | |
---|---|
classReference |
نسخة من الحقول المكتسَبة للفئة الرئيسية يتم استرداد هذه الحقول أثناء عملية GET. |
ticketNumber |
رقم التذكرة. إنّه معرّف فريد للتذكرة في نظام شركة النقل العام. |
passengerType |
عدد الركاب. |
passengerNames |
تمثّل هذه السمة أسماء الركاب الذين تم تخصيص التذكرة لهم. يهدف الحقل |
tripId |
يتم استخدام هذا المعرّف لتجميع التذاكر معًا إذا حفظ المستخدم تذاكر متعددة للرحلة نفسها. |
ticketStatus |
تمثّل هذه السمة حالة التذكرة. بالنسبة إلى الحالات التي تؤثر في العرض، استخدِم الحقل |
customTicketStatus |
حالة مخصّصة يتم استخدامها لقيمة حالة التذكرة عندما لا يوفّر |
concessionCategory |
تمثّل هذه السمة فئة الامتياز الخاص بالتذكرة. |
customConcessionCategory |
فئة امتياز مخصّصة يمكن استخدامها عندما لا يوفّر |
ticketRestrictions |
معلومات حول نوع القيود المفروضة على استخدام هذه التذكرة على سبيل المثال، أيام الأسبوع التي يجب استخدامها أو المسارات المسموح بالسير فيها. |
purchaseDetails |
تفاصيل شراء هذه التذكرة |
ticketLeg |
تحتوي مرحلة التذكرة الواحدة على معلومات المغادرة والوصول، بالإضافة إلى معلومات عن الصعود إلى الطائرة والمقاعد. وفي حال تحديد أكثر من ساق واحدة، استخدِم الحقل |
ticketLegs[] |
قد تحتوي كل تذكرة على ساق واحدة أو أكثر. تحتوي كل ساق على معلومات المغادرة والوصول إلى جانب معلومات عن الصعود إلى الطائرة والمقاعد. في حال تحديد ساق واحدة فقط، استخدِم الحقل |
hexBackgroundColor |
لون خلفية البطاقة إذا لم يتم تعيين اللون السائد لصورة الجزء الرئيسي، وإذا لم يتم تعيين صورة الجزء الرئيسي، فسيتم استخدام اللون السائد في الشعار. التنسيق هو رقم rrggbb، حيث يكون rrggbb عبارة عن ثلاثي بنموذج أحمر أخضر أزرق سداسي، مثل |
tripType |
مطلوب. نوع الرحلة التي يمثلها عنصر النقل العام هذا. يتم استخدامها لتحديد عنوان البطاقة و/أو الرمز الذي يجب استخدامه بين نقطة الانطلاق والوجهة. |
id |
مطلوب. تمثّل هذه السمة المعرّف الفريد للعنصر. ويجب أن يكون هذا المعرّف فريدًا في كل العناصر من جهة الإصدار. يجب أن تتبع هذه القيمة التنسيق issuer ID.identifier حيث يتم إصدار الطريقة السابقة من قِبل Google واختيار الطريقة الثانية من قِبلك. يجب أن يتضمّن المعرّف الفريد أحرفًا أبجدية رقمية فقط، مثل "." أو "_" أو "-". |
classId |
مطلوب. الفئة المرتبطة بهذا العنصر. يجب أن تكون الفئة من نوع هذا العنصر نفسه، ويجب أن تكون متوفّرة من قبل، ويجب أن تتم الموافقة عليها. يجب أن تتبع أرقام تعريف الصفوف التنسيق issuer ID.identifier حيث يتم إصدار الطريقة السابقة من قِبل Google واختيار الطريقة الثانية من قِبلك. |
version |
منهي العمل به |
state |
مطلوب. حالة العنصر يُستخدَم هذا الحقل لتحديد كيفية عرض عنصر في التطبيق. على سبيل المثال، يتم نقل عنصر |
barcode |
نوع الرمز الشريطي وقيمته |
messages[] |
مصفوفة من الرسائل المعروضة في التطبيق سيتلقّى جميع مستخدمي هذا العنصر الرسائل المرتبطة به. الحد الأقصى لعدد هذه الحقول هو 10. |
validTimeInterval |
الفترة الزمنية التي سيكون هذا الكائن فيها |
locations[] |
ملاحظة: هذا الحقل غير متاح حاليًا لتشغيل الإشعارات الجغرافية. |
hasUsers |
يشير إلى ما إذا كان العنصر يحتوي على مستخدمين. تضبط المنصة هذا الحقل. |
smartTapRedemptionValue |
القيمة التي سيتم إرسالها إلى محطة دفع معتمَدة من خلال تكنولوجيا "الدفع الذكي" عبر NFC لهذا الجهاز يجب أيضًا إعداد حقلَي مستوى الصف |
hasLinkedDevice |
ما إذا كان هذا العنصر مرتبطًا حاليًا بجهاز واحد يتم ضبط هذا الحقل من خلال النظام الأساسي عندما يحفظ المستخدم العنصر ويربطه بجهازه. مخصص للاستخدام من قِبل شركاء محدّدين. يمكنك التواصل مع فريق الدعم للحصول على معلومات إضافية. |
disableExpirationNotification |
يشير هذا الرمز إلى ما إذا كان يجب إلغاء الإشعارات بشكل صريح. في حال ضبط هذا الحقل على "صحيح"، بغض النظر عن الحقل في الوقت الحالي، لا يمكن ضبط هذا الإعداد إلا للعروض. |
infoModuleData |
تمّ الإيقاف. يمكنك استخدام textModulesData بدلاً من ذلك. |
imageModulesData[] |
بيانات وحدة الصورة الحدّ الأقصى لعدد هذه الحقول المعروضة هو 1 من مستوى العنصر و1 لمستوى عنصر الفئة. |
textModulesData[] |
بيانات الوحدة النصية. وإذا تم تحديد بيانات الوحدة النصية أيضًا في الفئة، سيتم عرض كلتيهما. الحد الأقصى لعدد هذه الحقول المعروضة هو 10 حقول من الكائن و10 من الفئة. |
linksModuleData |
بيانات وحدة الروابط. وإذا تم أيضًا تحديد بيانات وحدة الروابط في الفئة، سيتم عرض كلتيهما. |
appLinkData |
رابط اختياري للتطبيق أو الموقع الإلكتروني سيتم عرضه كزر على الجهة الأمامية من البطاقة. في حال توفير AppLinkData للفئة المقابلة فقط، سيتم عرض عنصر AppLinkData. |
activationStatus |
حالة التفعيل للعنصر. مطلوبة إذا تم ضبط |
rotatingBarcode |
نوع الرمز الشريطي الدوار وقيمته |
deviceContext |
سياق الجهاز المرتبط بالعنصر |
heroImage |
صورة بانر اختيارية معروضة في الجهة الأمامية من البطاقة. وفي حالة عدم وجودها، سيتم عرض صورة الجزء الرئيسي للفئة، إن وجدت. وفي حال عدم توفّر الصورة الرئيسية للفئة أيضًا، لن يتم عرض أي شيء. |
groupingInfo |
المعلومات التي تتحكّم في كيفية تجميع البطاقات معًا |
passConstraints |
قيود التمرير للكائن. ويشمل ذلك الحدّ من سلوكيات تقنية NFC ولقطات الشاشة. |
saveRestrictions |
القيود المفروضة على العنصر الذي يجب إثبات ملكيته قبل أن يحاول المستخدم حفظ البطاقة تجدر الإشارة إلى أنّه لن يتم تطبيق هذه القيود إلا خلال وقت توفير الوقت. في حال تغيير القيود بعد حفظ المستخدم للبطاقة، لن يتم تطبيق القيود الجديدة على بطاقة سبق أن حفظتها. |
PassengerType
عمليات التعداد | |
---|---|
PASSENGER_TYPE_UNSPECIFIED |
|
SINGLE_PASSENGER |
|
singlePassenger |
الاسم المستعار القديم لـ |
MULTIPLE_PASSENGERS |
|
multiplePassengers |
الاسم المستعار القديم لـ |
TicketStatus
عمليات التعداد | |
---|---|
TICKET_STATUS_UNSPECIFIED |
|
USED |
|
used |
الاسم المستعار القديم لـ |
REFUNDED |
|
refunded |
الاسم المستعار القديم لـ |
EXCHANGED |
|
exchanged |
الاسم المستعار القديم لـ |
ConcessionCategory
عمليات التعداد | |
---|---|
CONCESSION_CATEGORY_UNSPECIFIED |
|
ADULT |
|
adult |
الاسم المستعار القديم لـ |
CHILD |
|
child |
الاسم المستعار القديم لـ |
SENIOR |
|
senior |
الاسم المستعار القديم لـ |
TicketRestrictions
تمثيل JSON |
---|
{ "routeRestrictions": { object ( |
الحقول | |
---|---|
routeRestrictions |
القيود المفروضة على المسارات التي يمكن أن يتم سلكها. على سبيل المثال، قد تكون هذه القيمة هي السلسلة "قطارات عبر البلد المحجوزة فقط". |
routeRestrictionsDetails |
يمكنك الاطّلاع على مزيد من التفاصيل حول ما سبق |
timeRestrictions |
القيود المفروضة على أوقات استخدام هذه التذكرة |
otherRestrictions |
قيود إضافية لا تندرج ضمن "المسار" أو "الوقت" الفئات. |
PurchaseDetails
تمثيل JSON |
---|
{
"purchaseReceiptNumber": string,
"purchaseDateTime": string,
"accountId": string,
"confirmationCode": string,
"ticketCost": {
object ( |
الحقول | |
---|---|
purchaseReceiptNumber |
رقم الإيصال/المعرّف لتتبُّع عملية شراء التذكرة عبر الشخص الذي باع التذكرة |
purchaseDateTime |
تاريخ/وقت شراء التذكرة هذا التاريخ أو الوقت بالتنسيق الممتد وفقًا لمعيار ISO 8601، مع إزاحة أو بدونها. يمكن تحديد الوقت بدقة تصل إلى نانو ثانية. يمكن تحديد الإزاحة بدقة بالثواني (على الرغم من أن ثوانٍ الإزاحة ليست جزءًا من ISO 8601). على سبيل المثال: ستكون
ستكون بدون معلومات الإزاحة، قد لا تتوفّر بعض الميزات المنسّقة. |
accountId |
رقم تعريف الحساب المستخدَم لشراء التذكرة |
confirmationCode |
رمز تأكيد عملية الشراء قد يكون هذا هو نفسه لعدة تذاكر مختلفة ويستخدم لتجميع التذاكر معًا. |
ticketCost |
تمثّل هذه السمة تكلفة التذكرة. |
TicketCost
تمثيل JSON |
---|
{ "faceValue": { object ( |
الحقول | |
---|---|
faceValue |
تمثّل هذه السمة القيمة الاسمية للتذكرة. |
purchasePrice |
سعر الشراء الفعلي للتذكرة، بعد احتساب الضريبة و/أو الخصومات. |
discountMessage |
رسالة تصف أي نوع من الخصم تم تطبيقه. |
TicketLeg
تمثيل JSON |
---|
{ "originStationCode": string, "originName": { object ( |
الحقول | |
---|---|
originStationCode |
رمز محطة المصدر. يجب توفير هذه السمة إذا كانت السمة |
originName |
اسم المحطة المصدر. يجب توفير هذه السمة إذا كانت السمة |
destinationStationCode |
رمز محطة الوجهة. |
destinationName |
اسم الوجهة |
departureDateTime |
تاريخ/وقت المغادرة. يجب تنفيذ هذا الإجراء في حال عدم ضبط فاصل زمني للصلاحية على عنصر النقل العام. هذا التاريخ أو الوقت بالتنسيق الممتد وفقًا لمعيار ISO 8601، مع إزاحة أو بدونها. يمكن تحديد الوقت بدقة تصل إلى نانو ثانية. يمكن تحديد الإزاحة بدقة بالثواني (على الرغم من أن ثوانٍ الإزاحة ليست جزءًا من ISO 8601). على سبيل المثال: ستكون
ستكون كما أن الجزء من التاريخ/الوقت بدون الإزاحة يعتبر "التاريخ/الوقت المحلي". يجب إدخال التاريخ/الوقت المحلي في محطة المصدر. على سبيل المثال، إذا حدثت المغادرة في الساعة 20 من 5 حزيران (يونيو) 2018 في محطة المغادرة، يجب أن يكون جزء التاريخ/الوقت المحلي بدون معلومات الإزاحة، قد لا تتوفّر بعض الميزات المنسّقة. |
arrivalDateTime |
تاريخ/وقت الوصول هذا التاريخ أو الوقت بالتنسيق الممتد وفقًا لمعيار ISO 8601، مع إزاحة أو بدونها. يمكن تحديد الوقت بدقة تصل إلى نانو ثانية. يمكن تحديد الإزاحة بدقة بالثواني (على الرغم من أن ثوانٍ الإزاحة ليست جزءًا من ISO 8601). على سبيل المثال: ستكون
ستكون كما أن الجزء من التاريخ/الوقت بدون الإزاحة يعتبر "التاريخ/الوقت المحلي". يجب إدخال التاريخ/الوقت المحلي في محطة الوجهة. على سبيل المثال، إذا وقع الحدث في الساعة 20 من 5 حزيران (يونيو) 2018 في المحطة الوجهة، يجب أن يكون جزء التاريخ/الوقت المحلي بدون معلومات الإزاحة، قد لا تتوفّر بعض الميزات المنسّقة. |
fareName |
وصف/اسم مختصر للسعر الخاص بمرحلة السفر هذه على سبيل المثال، "استخدام لمرة واحدة في أي وقت" |
carriage |
اسم القطار أو السفينة أو رقمها الذي على الراكب أن يركبها. |
platform |
الرصيف أو البوابة حيث يمكن للراكب ركوب العربة. |
zone |
تمثّل هذه السمة منطقة الصعود إلى الطائرة ضمن المنصة. |
ticketSeat |
تمثّل هذه السمة المقعد الذي تم حجزه للركّاب. وفي حال تحديد أكثر من مقعد واحد، يُرجى استخدام الحقل |
ticketSeats[] |
تمثّل هذه السمة المقعد الذي تم حجزه للركّاب. في حال تحديد مقعد واحد فقط، يُرجى استخدام الحقل |
transitOperatorName |
اسم شركة النقل العام التي تدير هذه المرحلة من الرحلة |
transitTerminusName |
محطة طرفية أو وجهة القطار/الحافلة وغيرها |
TicketSeat
تمثيل JSON |
---|
{ "fareClass": enum ( |
الحقول | |
---|---|
fareClass |
تمثّل هذه السمة فئة السعر للمقعد المغطى بتذكرة. |
customFareClass |
فئة سعر مخصّص يتم استخدامها في حال عدم انطباق |
coach |
معرّف عربة القطار أو الحافلة التي يوجد فيها المقعد المغطى بتذكرة على سبيل المثال: "10" |
seat |
معرّف الموقع الجغرافي للمقعد المغطى بتذكرة على سبيل المثال: "42". في حال عدم توفُّر معرّف محدد، استخدِم السمة |
seatAssignment |
تخصيص مقعد الراكب. على سبيل المثال: "لا توجد مقعد محدد". تُستخدَم في حال عدم توفّر معرّف محدد لاستخدامه في |
FareClass
عمليات التعداد | |
---|---|
FARE_CLASS_UNSPECIFIED |
|
ECONOMY |
|
economy |
الاسم المستعار القديم لـ |
FIRST |
|
first |
الاسم المستعار القديم لـ |
BUSINESS |
|
business |
الاسم المستعار القديم لـ |
TripType
عمليات التعداد | |
---|---|
TRIP_TYPE_UNSPECIFIED |
|
ROUND_TRIP |
|
roundTrip |
الاسم المستعار القديم لـ |
ONE_WAY |
|
oneWay |
الاسم المستعار القديم لـ |
ActivationStatus
حالة تفعيل العنصر يتضمّن هذا الحقل حالة التفعيل إذا كانت ذات قيمة تتيح التفعيل.
تمثيل JSON |
---|
{
"state": enum ( |
الحقول | |
---|---|
state |
|
الحالة
عمليات التعداد | |
---|---|
UNKNOWN_STATE |
|
NOT_ACTIVATED |
غير مفعّل، هذه هي الحالة التلقائية |
not_activated |
الاسم المستعار القديم لـ |
ACTIVATED |
مفعّل |
activated |
الاسم المستعار القديم لـ |
DeviceContext
سياق الجهاز المرتبط بالعنصر
تمثيل JSON |
---|
{ "deviceToken": string } |
الحقول | |
---|---|
deviceToken |
وفي حال ضبط هذه السياسة، لن يتم عرض معلومات تحصيل القيمة إلا على الجهاز المحدَّد عند تفعيل العنصر. ويجب عدم استخدام ذلك كمعرّف ثابت لتتبُّع جهاز المستخدم. ويمكن أن يتغيّر هذا الرمز على مستوى البطاقات المختلفة للجهاز نفسه أو حتى عند تفعيل طرق تفعيل مختلفة على الجهاز نفسه. عند ضبط هذه السياسة، على المتصلين أيضًا ضبط hasLinkedDevice على العنصر الذي يتم تفعيله. |
الطُرق |
|
---|---|
|
يضيف هذا الخيار رسالة إلى عنصر النقل العام المشار إليه من خلال رقم تعريف العنصر المحدّد. |
|
تعرض عنصر النقل العام برقم تعريف العنصر المحدّد. |
|
يتم إدراج عنصر نقل عام باستخدام رقم التعريف والخصائص المحدّدَين. |
|
تعرض قائمة بجميع عناصر النقل العام لرقم تعريف جهة إصدار معيّن. |
|
لتعديل عنصر النقل العام المُشار إليه باستخدام رقم تعريف العنصر المحدّد. |
|
لتعديل عنصر النقل العام المُشار إليه باستخدام رقم تعريف العنصر المحدّد. |