حالات الاستخدام
تعرض حالات الاستخدام التالية أمثلة شائعة على كيفية استخدام مخطط 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 | (يُنصح به لبطاقات التأكيد/إجابات "بحث Google") الوقت الذي تم فيه إجراء آخر تعديل على الحجز |
| confirmReservationUrl | عنوان URL | صفحة الويب التي يمكن تأكيد الحجز فيها |
| cancelReservationUrl | عنوان URL | صفحة الويب التي يمكن إلغاء الحجز فيها |
| modifyReservationUrl | عنوان URL | (يُنصح به لبطاقات التأكيد/إجابات "بحث Google") صفحة ويب يمكن تعديل الحجز فيها |
| 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 | نص | (مطلوبة) تمثّل اسم محطة الحافلات. |
| reservationFor.departureBusStop.address | PostalAddress | عنوان محطة الحافلات أو محطة المغادرة |
| reservationFor.departureBusStop.address.streetAddress | نص | (يُنصح به لبطاقات التأكيد/إجابات "بحث Google") عنوان الشارع الخاص بمحطة الحافلات أو القطارات التي ستغادر منها |
| reservationFor.departureBusStop.address.addressLocality | نص | (يُنصح به لبطاقات التأكيد/إجابات "بحث Google") المنطقة المحلية (مثل المدينة) التي تقع فيها محطة الحافلات أو القطارات التي ستغادر منها |
| reservationFor.departureBusStop.address.addressRegion | نص | (يُنصح باستخدامه لبطاقات التأكيد/إجابات "بحث Google") المنطقة (مثل الولاية) التي تقع فيها محطة الحافلات أو القطارات التي ستغادر منها |
| reservationFor.departureBusStop.address.postalCode | نص | (يُنصح باستخدامه لبطاقات التأكيد/إجابات "بحث Google") الرمز البريدي لمحطة الحافلات أو القطارات التي ستغادر منها |
| reservationFor.departureBusStop.address.addressCountry | نص أو البلد | (يُنصح باستخدامه لبطاقات التأكيد/إجابات "بحث Google") بلد مغادرة محطة الحافلات أو القطارات |
| reservationFor.departureBusStop.directions | نص | الاتجاهات إلى محطة الحافلات |
| reservationFor.departureTime | DateTime | (مطلوبة) وقت مغادرة الحافلة |
| reservationFor.arrivalBusStop | BusStop أو BusStation | (مطلوبة) تمثّل هذه السمة المكان الذي تصل إليه الحافلة. |
| reservationFor.arrivalBusStop.name | نص | (مطلوبة) تمثّل اسم محطة الحافلات. |
| reservationFor.arrivalBusStop.address | PostalAddress | عنوان محطة الحافلات أو محطة القطار عند الوصول |
| reservationFor.arrivalBusStop.address.streetAddress | نص | (يُنصح باستخدامه لبطاقات التأكيد/إجابات "بحث Google") العنوان التفصيلي لمحطة الحافلات أو القطارات التي ستصل إليها |
| reservationFor.arrivalBusStop.address.addressLocality | نص | (يُنصح به لبطاقات التأكيد/إجابات "بحث Google") المنطقة المحلية (مثل المدينة) التي تقع فيها محطة الحافلات أو القطارات عند الوصول |
| reservationFor.arrivalBusStop.address.addressRegion | نص | (يُنصح باستخدامه لبطاقات التأكيد/إجابات "بحث Google") المنطقة (مثل الولاية) التي تقع فيها محطة الحافلات أو القطارات عند الوصول |
| reservationFor.arrivalBusStop.address.postalCode | نص | (يُنصح باستخدامه لبطاقات التأكيد/إجابات "بحث Google") الرمز البريدي لمحطة الحافلات أو القطارات عند الوصول |
| reservationFor.arrivalBusStop.address.addressCountry | نص أو البلد | (يُنصح به لبطاقات التأكيد/إجابات "بحث Google") بلد الوصول ومحطة الحافلات أو القطارات |
| reservationFor.arrivalBusStop.directions | نص | الاتجاهات إلى محطة الحافلات |
| reservationFor.arrivalTime | DateTime | (مطلوب) وقت وصول الحافلة |
| reservedTicket | التذكرة | معلومات التذكرة |
| reservedTicket.ticketNumber | نص | رقم التذكرة أو معرّفها |
| reservedTicket.downloadUrl | عنوان URL | . |
| reservedTicket.printUrl | عنوان URL | . |
| reservedTicket.ticketToken | نص أو عنوان URL | إذا كانت صورة الرمز الشريطي مستضافة على موقعك الإلكتروني، تكون قيمة الحقل هي عنوان URL للصورة أو رمز URI للرمز الشريطي أو رمز الاستجابة السريعة، مثل "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 | نص | الموقع الجغرافي للصف الذي يضم المقعد المحجوز |