حالات الاستخدام
اتّبِعوا هذه الأمثلة لضمان تنظيم ترميز BusReservation بشكلٍ سليم.
تأكيد الحجز الأساسي
ضمِّنوا الترميز التالي في رسالتكم الإلكترونية عند إرسال تأكيد الحجز.
يعرض تطبيق Google تفاصيل الحجز في يوم الرحلة ويُعلم المستخدم بموعد المغادرة إلى محطة الحافلات، مع مراعاة وسيلة النقل وحركة المرور. إذا قدّمتم عنوان URL لتسجيل الوصول كما هو موضّح في المثال التالي، يعرضه تطبيق Google للمستخدم قبل 24 ساعة من الرحلة.
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "BusReservation",
"reservationNumber": "123456",
"underName": {
"@type": "Person",
"name": "John Smith"
},
"reservationStatus": "http://schema.org/ReservationConfirmed",
"reservationFor": {
"@type": "BusTrip",
"busCompany": {
"@type": "Organization",
"name": "Bolt NYC"
},
"departureBusStop": {
"@type": "BusStop",
"name": "Port Authority, NYC"
},
"departureTime": "2017-01-04T12:30:00-05:00",
"arrivalBusStop": {
"@type": "BusStop",
"name": "Boston South Station"
},
"arrivalTime": "2017-01-04T17:10:00-05:00"
}
}
</script>
البيانات الجزئية
<div itemscope itemtype="http://schema.org/BusReservation">
<meta itemprop="reservationNumber" content="123456"/>
<div itemprop="underName" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name" content="John Smith"/>
</div>
<link itemprop="reservationStatus" href="http://schema.org/ReservationConfirmed"/>
<div itemprop="reservationFor" itemscope itemtype="http://schema.org/BusTrip">
<div itemprop="busCompany" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Bolt NYC"/>
</div>
<div itemprop="departureBusStop" itemscope itemtype="http://schema.org/BusStop">
<meta itemprop="name" content="Port Authority, NYC"/>
</div>
<meta itemprop="departureTime" content="2017-01-04T12:30:00-05:00"/>
<div itemprop="arrivalBusStop" itemscope itemtype="http://schema.org/BusStop">
<meta itemprop="name" content="Boston South Station"/>
</div>
<meta itemprop="arrivalTime" content="2017-01-04T17:10:00-05:00"/>
</div>
</div>
بطاقة صعود الطائرة والتذكرة
بالإضافة إلى تأكيد الحجز، يمكنكم إرسال بطاقة صعود الطائرة في رسالة إلكترونية منفصلة.
لا تساعد بطاقات التأكيد المستخدم في الوصول إلى محطة الحافلات في الوقت المحدّد فحسب، بل تعرض له أيضًا التذكرة أثناء الرحلة. لإجراء ذلك، أدرِجوا حقولاً إضافية في الترميز. إذا كانت هناك حقول إضافية مطلوبة لصعود الركاب إلى الحافلة، أدرِجوها في الحقل additionalTicketText.
بالنسبة إلى التذاكر التي لا تتضمّن مقاعد محجوزة، تكون هذه الحقول: numSeats وticketNumber و ticketToken
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "BusReservation",
"reservationNumber": "123456",
"underName": {
"@type": "Person",
"name": "John Smith"
},
"reservationStatus": "http://schema.org/ReservationConfirmed",
"reservationFor": {
"@type": "BusTrip",
"busCompany": "Bolt NYC",
"departureBusStop": {
"@type": "BusStop",
"name": "Port Authority, NYC"
},
"departureTime": "2017-01-04T12:30:00-05:00",
"arrivalBusStop": {
"@type": "BusStop",
"name": "Boston South Station"
},
"arrivalTime": "2017-01-04T17:10:00-05:00"
},
"reservedTicket": {
"@type": "Ticket",
"underName": "John Smith",
"ticketNumber": "123XYZ",
"ticketToken": "aztecCode:AB34",
"additionalTicketText": "We recommend that you arrive at the station at least 30 minutes prior to your scheduled departure. Allow additional time if you need help with baggage or tickets."
}
}
</script>
البيانات الجزئية
<div itemscope itemtype="http://schema.org/BusReservation">
<meta itemprop="reservationNumber" content="123456"/>
<div itemprop="underName" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name" content="John Smith"/>
</div>
<link itemprop="reservationStatus" href="http://schema.org/ReservationConfirmed"/>
<div itemprop="reservationFor" itemscope itemtype="http://schema.org/BusTrip">
<meta itemprop="busCompany" content="Bolt NYC"/>
<div itemprop="departureBusStop" itemscope itemtype="http://schema.org/BusStop">
<meta itemprop="name" content="Port Authority, NYC"/>
</div>
<meta itemprop="departureTime" content="2017-01-04T12:30:00-05:00"/>
<div itemprop="arrivalBusStop" itemscope itemtype="http://schema.org/BusStop">
<meta itemprop="name" content="Boston South Station"/>
</div>
<meta itemprop="arrivalTime" content="2017-01-04T17:10:00-05:00"/>
</div>
<div itemprop="reservedTicket" itemscope itemtype="http://schema.org/Ticket">
<meta itemprop="underName" content="John Smith"/>
<meta itemprop="ticketNumber" content="123XYZ"/>
<meta itemprop="ticketToken" content="aztecCode:AB34"/>
<meta itemprop="additionalTicketText" content="We recommend that you arrive at the station at least 30 minutes prior to your scheduled departure. Allow additional time if you need help with baggage or tickets."/>
</div>
</div>
بالنسبة إلى التذاكر التي تتضمّن مقاعد محجوزة، تكون هذه الحقول: seatNumber وseatingType وticketNumber و ticketToken
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "BusReservation",
"reservationNumber": "123456",
"underName": {
"@type": "Person",
"name": "John Smith"
},
"reservationStatus": "http://schema.org/ReservationConfirmed",
"reservationFor": {
"@type": "BusTrip",
"busCompany": "Bolt NYC",
"departureBusStop": {
"@type": "BusStop",
"name": "Port Authority, NYC"
},
"departureTime": "2017-01-04T12:30:00-05:00",
"arrivalBusStop": {
"@type": "BusStop",
"name": "Boston South Station"
},
"arrivalTime": "2017-01-04T17:10:00-05:00"
},
"reservedTicket": {
"@type": "Ticket",
"underName": "John Smith",
"ticketedSeat": {
"@type": "Seat",
"seatNumber": "27B",
"seatingType": "Coach"
},
"ticketNumber": "123XYZ",
"ticketToken": "aztecCode:AB34",
"additionalTicketText": "We recommend that you arrive at the station at least 30 minutes prior to your scheduled departure. Allow additional time if you need help with baggage or tickets."
}
}
</script>
البيانات الجزئية
<div itemscope itemtype="http://schema.org/BusReservation">
<meta itemprop="reservationNumber" content="123456"/>
<div itemprop="underName" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name" content="John Smith"/>
</div>
<link itemprop="reservationStatus" href="http://schema.org/ReservationConfirmed"/>
<div itemprop="reservationFor" itemscope itemtype="http://schema.org/BusTrip">
<meta itemprop="busCompany" content="Bolt NYC"/>
<div itemprop="departureBusStop" itemscope itemtype="http://schema.org/BusStop">
<meta itemprop="name" content="Port Authority, NYC"/>
</div>
<meta itemprop="departureTime" content="2017-01-04T12:30:00-05:00"/>
<div itemprop="arrivalBusStop" itemscope itemtype="http://schema.org/BusStop">
<meta itemprop="name" content="Boston South Station"/>
</div>
<meta itemprop="arrivalTime" content="2017-01-04T17:10:00-05:00"/>
</div>
<div itemprop="reservedTicket" itemscope itemtype="http://schema.org/Ticket">
<meta itemprop="underName" content="John Smith"/>
<div itemprop="ticketedSeat" itemscope itemtype="http://schema.org/Seat">
<meta itemprop="seatNumber" content="27B"/>
<meta itemprop="seatingType" content="Coach"/>
</div>
<meta itemprop="ticketNumber" content="123XYZ"/>
<meta itemprop="ticketToken" content="aztecCode:AB34"/>
<meta itemprop="additionalTicketText" content="We recommend that you arrive at the station at least 30 minutes prior to your scheduled departure. Allow additional time if you need help with baggage or tickets."/>
</div>
</div>
مثال يتضمّن جميع الحقول المتوافقة
للعلم، إليكم مثال يتضمّن جميع الحقول المتوافقة التي تم ملؤها:
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "BusReservation",
"reservationNumber": "123456",
"url": "http://boltbus.com/view/123456",
"underName": {
"@type": "Person",
"name": "John Smith",
"email": "john@mail.com"
},
"programMembership": {
"@type": "ProgramMembership",
"memberNumber": "12345",
"program": "STA"
},
"bookingAgent": {
"@type": "Organization",
"name": "Bolt Bus NYC",
"url": "http://boltbus.com/"
},
"bookingTime": "2013-01-14T13:05:00-05:00",
"modifiedTime": "2013-03-14T13:05:00-05:00",
"confirmReservationUrl": "http://boltbus.com/confirm?id=123456",
"cancelReservationUrl": "http://boltbus.com/cancel?id=123456",
"modifyReservationUrl": "http://boltbus.com/edit?id=123456",
"checkinUrl": "http://boltbus.com/checkin?id=AB3XY2",
"reservationStatus": "http://schema.org/ReservationConfirmed",
"reservationFor": {
"@type": "BusTrip",
"name": "?",
"busNumber": "63",
"busName": "Bolt Bus NY:Boston",
"busCompany": {
"@type": "Organization",
"name": "Bolt NYC"
},
"departureBusStop": {
"@type": "BusStop",
"name": "Port Authority, NYC",
"address": {
"@type": "PostalAddress",
"streetAddress": "625 8th Avenue",
"addressLocality": "New York",
"addressRegion": "NY",
"postalCode": "10018",
"addressCountry": "USA"
},
"directions": "Bus terminals are at floors 2-4 of the Port Authority building"
},
"departureTime": "2017-01-04T12:30:00-05:00",
"arrivalBusStop": {
"@type": "BusStop",
"name": "Boston South Station",
"address": {
"@type": "PostalAddress",
"streetAddress": "Summer St.",
"addressLocality": "Boston",
"addressRegion": "MA",
"postalCode": "02111",
"addressCountry": "USA"
},
"directions": "Bus stops are at thewest side of the train station."
},
"arrivalTime": "2017-01-04T17:10:00-05:00"
},
"reservedTicket": {
"@type": "Ticket",
"ticketNumber": "123XYZ",
"downloadUrl": "?",
"printUrl": "?",
"ticketToken": "qrCode:123456789",
"additionalTicketText": "?",
"price": "45.00",
"priceCurrency": "USD",
"underName": {
"@type": "Person",
"name": "Mary Smith"
},
"ticketedSeat": {
"@type": "Seat",
"seatingType": "Coach",
"seatNumber": "27",
"seatRow": "A"
}
}
}
</script>
البيانات الجزئية
<div itemscope itemtype="http://schema.org/BusReservation">
<meta itemprop="reservationNumber" content="123456"/>
<link itemprop="url" href="http://boltbus.com/view/123456"/>
<div itemprop="underName" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name" content="John Smith"/>
<meta itemprop="email" content="john@mail.com"/>
</div>
<div itemprop="programMembership" itemscope itemtype="http://schema.org/ProgramMembership">
<meta itemprop="memberNumber" content="12345"/>
<meta itemprop="program" content="STA"/>
</div>
<div itemprop="bookingAgent" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Bolt Bus NYC"/>
<link itemprop="url" href="http://boltbus.com/"/>
</div>
<meta itemprop="bookingTime" content="2013-01-14T13:05:00-05:00"/>
<meta itemprop="modifiedTime" content="2013-03-14T13:05:00-05:00"/>
<link itemprop="confirmReservationUrl" href="http://boltbus.com/confirm?id=123456"/>
<link itemprop="cancelReservationUrl" href="http://boltbus.com/cancel?id=123456"/>
<link itemprop="modifyReservationUrl" href="http://boltbus.com/edit?id=123456"/>
<link itemprop="checkinUrl" href="http://boltbus.com/checkin?id=AB3XY2"/>
<link itemprop="reservationStatus" href="http://schema.org/ReservationConfirmed"/>
<div itemprop="reservationFor" itemscope itemtype="http://schema.org/BusTrip">
<meta itemprop="name" content="?"/>
<meta itemprop="busNumber" content="63"/>
<meta itemprop="busName" content="Bolt Bus NY:Boston"/>
<div itemprop="busCompany" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Bolt NYC"/>
</div>
<div itemprop="departureBusStop" itemscope itemtype="http://schema.org/BusStop">
<meta itemprop="name" content="Port Authority, NYC"/>
<div itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="streetAddress" content="625 8th Avenue"/>
<meta itemprop="addressLocality" content="New York"/>
<meta itemprop="addressRegion" content="NY"/>
<meta itemprop="postalCode" content="10018"/>
<meta itemprop="addressCountry" content="USA"/>
</div>
<meta itemprop="directions" content="Bus terminals are at floors 2-4 of the Port Authority building"/>
</div>
<meta itemprop="departureTime" content="2017-01-04T12:30:00-05:00"/>
<div itemprop="arrivalBusStop" itemscope itemtype="http://schema.org/BusStop">
<meta itemprop="name" content="Boston South Station"/>
<div itemprop="address" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="streetAddress" content="Summer St."/>
<meta itemprop="addressLocality" content="Boston"/>
<meta itemprop="addressRegion" content="MA"/>
<meta itemprop="postalCode" content="02111"/>
<meta itemprop="addressCountry" content="USA"/>
</div>
<meta itemprop="directions" content="Bus stops are at thewest side of the train station."/>
</div>
<meta itemprop="arrivalTime" content="2017-01-04T17:10:00-05:00"/>
</div>
<div itemprop="reservedTicket" itemscope itemtype="http://schema.org/Ticket">
<meta itemprop="ticketNumber" content="123XYZ"/>
<meta itemprop="downloadUrl" content="?"/>
<meta itemprop="printUrl" content="?"/>
<meta itemprop="ticketToken" content="qrCode:123456789"/>
<meta itemprop="additionalTicketText" content="?"/>
<meta itemprop="price" content="45.00"/>
<meta itemprop="priceCurrency" content="USD"/>
<div itemprop="underName" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name" content="Mary Smith"/>
</div>
<div itemprop="ticketedSeat" itemscope itemtype="http://schema.org/Seat">
<meta itemprop="seatingType" content="Coach"/>
<meta itemprop="seatNumber" content="27"/>
<meta itemprop="seatRow" content="A"/>
</div>
</div>
</div>
اختبار الترميز
يمكنكم التحقّق من صحة الترميز باستخدام الـ أداة اختبار ترميز الرسائل الإلكترونية. ألصِقوا رمز الترميز وانقروا على الزر التحقّق من الصحة لفحص المحتوى وتلقّي تقرير عن أي أخطاء.
المواصفات
راجِعوا تفاصيل رسالتكم الإلكترونية لمعرفة ما إذا كانت أي من هذه المواقع تنطبق على حجز الحافلة. من خلال وضع علامات على هذه المواقع الإضافية، تسمحون لشركة Google بعرض وصف أكثر تفصيلاً لحجز الحافلة للمستخدم.
| الموقع | النوع | الوصف |
|---|---|---|
| reservationNumber | نص | (مطلوب) رقم الحجز أو معرّفه |
| url | عنوان URL | صفحة الويب التي يمكن عرض الحجز فيها |
| underName | Person أو Organization | (مطلوب) الراكب |
| underName.name | نص | (مطلوب) اسم الشخص |
| underName.email | نص | عنوان البريد الإلكتروني |
| programMembership | ProgramMembership | أي اشتراك في برنامج "المسافر الدائم" أو برنامج ولاء الفنادق أو ما إلى ذلك يتم تطبيقه على الحجز |
| programMembership.memberNumber | نص | معرّف الاشتراك |
| programMembership.program | نص | اسم البرنامج |
| bookingAgent | Organization أو Person | وكيل الحجز أو الوكالة يقبل أيضًا سلسلة (مثل "") |
| bookingAgent.name | نص | اسم الوكيل أو الخدمة |
| bookingAgent.url | عنوان URL | موقع الويب الخاص بالوكيل أو الخدمة |
| bookingTime | DateTime | تاريخ إجراء الحجز |
| modifiedTime | DateTime | (مُقترَح لبطاقات التأكيد أو "إجابات البحث") آخر مرة تم فيها تعديل الحجز |
| confirmReservationUrl | عنوان URL | صفحة الويب التي يمكن تأكيد الحجز فيها |
| cancelReservationUrl | عنوان URL | صفحة الويب التي يمكن إلغاء الحجز فيها |
| modifyReservationUrl | عنوان URL | (مُقترَح لبطاقات التأكيد أو "إجابات البحث") صفحة الويب التي يمكن تعديل الحجز فيها |
| checkinUrl | عنوان URL | صفحة الويب التي يمكن للراكب تسجيل الوصول فيها |
| reservationStatus | ReservationStatus | (مطلوب) الحالة الحالية للحجز |
| reservationFor | BusTrip | (مطلوب) معلومات عن رحلة الحافلة |
| reservationFor.name | نص | اسم BusTrip |
| reservationFor.busNumber | نص | مثلاً 101 |
| reservationFor.busName | نص | مثلاً Bolt Express |
| reservationFor.busCompany | المؤسسة | (مطلوب) مثلاً Bolt NYC يقبل أيضًا سلسلة (مثل "Bolt NYC") |
| reservationFor.busCompany.name | نص | (مطلوب) اسم المؤسسة |
| reservationFor.departureBusStop | BusStop أو BusStation | (مطلوب) المكان الذي تغادر منه الحافلة |
| reservationFor.departureBusStop.name | نص | (مطلوب) اسم BusStop |
| reservationFor.departureBusStop.address | PostalAddress | عنوان محطة الحافلات للمغادرة |
| reservationFor.departureBusStop.address.streetAddress | نص | (مُقترَح لبطاقات التأكيد أو "إجابات البحث") عنوان الشارع لمحطة الحافلات للمغادرة |
| reservationFor.departureBusStop.address.addressLocality | نص | (مُقترَح لبطاقات التأكيد أو "إجابات البحث") المنطقة (مثل المدينة) لمحطة الحافلات للمغادرة |
| reservationFor.departureBusStop.address.addressRegion | نص | (مُقترَح لبطاقات التأكيد أو "إجابات البحث") المنطقة (مثل الولاية) لمحطة الحافلات للمغادرة |
| reservationFor.departureBusStop.address.postalCode | نص | (مُقترَح لبطاقات التأكيد أو "إجابات البحث") الرمز البريدي لمحطة الحافلات للمغادرة |
| reservationFor.departureBusStop.address.addressCountry | نص أو Country | (مُقترَح لبطاقات التأكيد أو "إجابات البحث") بلد محطة الحافلات للمغادرة |
| reservationFor.departureBusStop.directions | نص | الاتجاهات إلى محطة الحافلات |
| reservationFor.departureTime | DateTime | (مطلوب) وقت مغادرة الحافلة |
| reservationFor.arrivalBusStop | BusStop أو BusStation | (مطلوب) المكان الذي تصل إليه الحافلة |
| reservationFor.arrivalBusStop.name | نص | (مطلوب) اسم BusStop |
| reservationFor.arrivalBusStop.address | PostalAddress | عنوان محطة الحافلات للوصول |
| reservationFor.arrivalBusStop.address.streetAddress | نص | (مُقترَح لبطاقات التأكيد أو "إجابات البحث") عنوان الشارع لمحطة الحافلات للوصول |
| reservationFor.arrivalBusStop.address.addressLocality | نص | (مُقترَح لبطاقات التأكيد أو "إجابات البحث") المنطقة (مثل المدينة) لمحطة الحافلات للوصول |
| reservationFor.arrivalBusStop.address.addressRegion | نص | (مُقترَح لبطاقات التأكيد أو "إجابات البحث") المنطقة (مثل الولاية) لمحطة الحافلات للوصول |
| reservationFor.arrivalBusStop.address.postalCode | نص | (مُقترَح لبطاقات التأكيد أو "إجابات البحث") الرمز البريدي لمحطة الحافلات للوصول |
| reservationFor.arrivalBusStop.address.addressCountry | نص أو Country | (مُقترَح لبطاقات التأكيد أو "إجابات البحث") بلد محطة الحافلات للوصول |
| reservationFor.arrivalBusStop.directions | نص | الاتجاهات إلى محطة الحافلات |
| reservationFor.arrivalTime | DateTime | (مطلوب) وقت وصول الحافلة |
| reservedTicket | Ticket | معلومات التذكرة |
| reservedTicket.ticketNumber | نص | رقم التذكرة أو معرّفها |
| reservedTicket.downloadUrl | عنوان URL | . |
| reservedTicket.printUrl | عنوان URL | . |
| reservedTicket.ticketToken | نص أو عنوان URL | إذا كانت صورة الرمز الشريطي مستضافة على موقعكم الإلكتروني، يكون الحقل عنوان URL للصورة أو رمز شريطي أو معرّف موارد موحّد لرمز الاستجابة السريعة، مثل "barcode128:AB34" (الرموز الشريطية ISO-15417) و"qrCode:AB34" (رموز الاستجابة السريعة) و"aztecCode:AB34" (رموز Aztec) و"barcodeEAN:1234" (رموز EAN) و"barcodeUPCA:1234" (رموز UPCA) |
| reservedTicket.additionalTicketText | نص | نص توضيحي إضافي حول التذكرة |
| reservedTicket.price | نص | إجمالي سعر التذكرة |
| reservedTicket.priceCurrency | نص | العملة (بالتنسيق ISO 4217 المُكوَن من 3 أحرف) لسعر التذكرة |
| reservedTicket.underName | Person أو Organization | الشخص أو المؤسسة التي تم إصدار التذكرة لها |
| reservedTicket.underName.name | نص | اسم الشخص |
| reservedTicket.ticketedSeat | المقعد | موقع المقعد المحجوز (مثلاً 27B) . |
| reservedTicket.ticketedSeat.seatingType | نص | نوع المقعد أو فئته |
| reservedTicket.ticketedSeat.seatNumber | نص | موقع المقعد المحجوز |
| reservedTicket.ticketedSeat.seatRow | نص | موقع صف المقعد المحجوز |