Trường hợp sử dụng
Các trường hợp sử dụng sau đây là một số ví dụ phổ biến về cách sử dụng giản đồ BusReservation. Sử dụng các ví dụ này để đảm bảo rằng đánh dấu của bạn có cấu trúc chính xác.
Xác nhận yêu cầu đặt chỗ cơ bản
Nhúng mã đánh dấu sau đây vào email của bạn khi bạn gửi thông báo xác nhận đặt chỗ.
Ứng dụng Google sẽ hiện thông tin đặt chỗ vào ngày của chuyến đi và thông báo cho người dùng thời gian cần khởi hành để đến trạm xe buýt đúng giờ (có tính đến phương tiện giao thông, tình hình giao thông, v.v.). Nếu bạn cung cấp URL đăng ký như trong ví dụ dưới đây, ứng dụng Google sẽ hiển thị URL này cho người dùng 24 giờ trước khi đến chuyến đi cho người dùng.
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>
Vi dữ liệu
<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>
Vé và thẻ lên máy bay
Ngoài việc xác nhận đặt chỗ, bạn có thể kích hoạt thẻ lên máy bay của Thẻ xác nhận trong một email riêng.
Thẻ xác nhận không chỉ giúp người dùng đến trạm xe buýt đúng giờ, mà còn hiển thị vé cho người dùng trong suốt hành trình. Để thực hiện điều này, bạn cần thêm một số trường bổ sung vào mã đánh dấu. Nếu hành khách cần có các trường khác để lên tàu, hãy điền các trường đó vào trường additionalTicketText.
Đối với vé không có chỗ ngồi đặt trước, các trường sau là : 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>
Vi dữ liệu
<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>
Đối với vé có chỗ ngồi đặt trước, các trường sau là : 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>
Vi dữ liệu
<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>
Ví dụ về tất cả các trường được hỗ trợ
Để tham khảo, sau đây là ví dụ về tất cả các trường được hỗ trợ đã điền sẵn:
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>
Vi dữ liệu
<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>
Kiểm tra mục đánh dấu của bạn
Bạn có thể xác thực mã đánh dấu bằng Công cụ kiểm tra đánh dấu qua email. Dán mã đánh dấu và nhấp vào nút Xác thực để quét nội dung và nhận báo cáo về mọi lỗi có.
Thông số kỹ thuật
Kiểm tra thông tin chi tiết trong email để xem có cơ sở lưu trú nào trong số này có áp dụng cho việc đặt xe buýt của bạn hay không. Bằng cách đánh dấu các thuộc tính bổ sung này, bạn cho phép Google hiển thị mô tả chi tiết hơn nhiều về đặt chỗ xe buýt cho người dùng.
| Thuộc tính | Loại | Mô tả |
|---|---|---|
| reservationNumber | Văn bản | (bắt buộc) Số hoặc mã nhận dạng của thông tin đặt chỗ. |
| url | URL | Trang web để bạn có thể xem thông tin đặt chỗ. |
| underName | Person (Người) hoặc Organization (Tổ chức) | (bắt buộc) Hành khách. |
| underName.name | Văn bản | (bắt buộc) Tên của một người. |
| underName.email | Văn bản | Địa chỉ email. |
| programMembership | ProgramMembership | Mọi gói thành viên của khách bay thường xuyên, chương trình khách hàng thân thiết của khách sạn, v.v. được áp dụng khi đặt phòng. |
| programMembership.memberNumber | Văn bản | Giá trị nhận dạng của gói thành viên. |
| programMembership.program | Văn bản | Tên chương trình. |
| bookingAgent | Organization (Tổ chức) hoặc Person (Người) | Đại lý đặt vé. Cũng chấp nhận một chuỗi (ví dụ: ""). |
| bookingAgent.name | Văn bản | Tên của nhân viên hỗ trợ/dịch vụ. |
| bookingAgent.url | URL | Trang web của nhân viên hỗ trợ/dịch vụ. |
| bookingTime | DateTime | Ngày đặt phòng. |
| modifiedTime | DateTime | (nên dùng cho thẻ xác nhận/Câu trả lời của Google Tìm kiếm) Thời gian sửa đổi lần gần đây nhất của yêu cầu đặt chỗ. |
| confirmReservationUrl | URL | Trang web nơi có thể xác nhận việc đặt chỗ. |
| cancelReservationUrl | URL | Trang web có thể huỷ yêu cầu đặt chỗ. |
| modifyReservationUrl | URL | (nên dùng cho thẻ xác nhận/Câu trả lời của Tìm kiếm) Trang web nơi bạn có thể sửa đổi thông tin đặt chỗ. |
| checkinUrl | URL | Trang web mà hành khách có thể xác nhận có mặt. |
| reservationStatus | ReservationStatus | (bắt buộc) Trạng thái hiện tại của yêu cầu đặt chỗ. |
| reservationFor | BusTrip | (bắt buộc) Thông tin về chuyến xe buýt. |
| reservationFor.name | Văn bản | Tên của BusTrip. |
| reservationFor.busNumber | Văn bản | ví dụ: 101. |
| reservationFor.busName | Văn bản | ví dụ: Ưu tiên bu lông. |
| reservationFor.busCompany | Tổ chức | (bắt buộc), ví dụ: Ưu đãi về thành phố New York. Cũng chấp nhận chuỗi (ví dụ: "Bolt NYC"). |
| reservationFor.busCompany.name | Văn bản | (bắt buộc) Tên tổ chức. |
| reservationFor.departureBusStop | BusStop hoặc BusStation | (bắt buộc) Nơi xe buýt khởi hành. |
| reservationFor.departureBusStop.name | Văn bản | (bắt buộc) Tên của BusStop. |
| reservationFor.departureBusStop.address | PostalAddress | Địa chỉ của trạm / bến xe buýt khởi hành. |
| reservationFor.departureBusStop.address.streetAddress | Văn bản | (nên dùng cho thẻ xác nhận/Câu trả lời tìm kiếm) Địa chỉ đường phố của trạm / bến xe buýt khởi hành. |
| reservationFor.departureBusStop.address.addressLocality | Văn bản | (nên dùng cho thẻ xác nhận/Câu trả lời tìm kiếm) Thành phố (ví dụ: thành phố) của trạm xe buýt / trạm khởi hành. |
| reservationFor.departureBusStop.address.addressRegion | Văn bản | (nên dùng cho thẻ xác nhận/Câu trả lời tìm kiếm) Khu vực (ví dụ: tiểu bang) của trạm xe buýt / trạm khởi hành. |
| reservationFor.departureBusStop.address.postalCode | Văn bản | (nên dùng cho thẻ xác nhận/Câu trả lời tìm kiếm) Mã bưu chính của trạm xe buýt / trạm khởi hành. |
| reservationFor.departureBusStop.address.addressCountry | Văn bản hoặc Quốc gia | (nên dùng cho thẻ xác nhận/Câu trả lời tìm kiếm) Quốc gia nơi / trạm xe buýt khởi hành. |
| reservationFor.departureBusStop.directions | Văn bản | Đường đi đến trạm xe buýt. |
| reservationFor.departureTime | DateTime | (bắt buộc) Thời gian khởi hành của xe buýt. |
| reservationFor.arrivalBusStop | BusStop hoặc BusStation | (bắt buộc) Nơi xe buýt đến. |
| reservationFor.arrivalBusStop.name | Văn bản | (bắt buộc) Tên của BusStop. |
| reservationFor.arrivalBusStop.address | PostalAddress | Địa chỉ của trạm / bến xe buýt đến. |
| reservationFor.arrivalBusStop.address.streetAddress | Văn bản | (nên dùng cho thẻ xác nhận/Câu trả lời tìm kiếm) Địa chỉ đường phố của trạm xe buýt đến. |
| reservationFor.arrivalBusStop.address.addressLocality | Văn bản | (nên dùng cho thẻ xác nhận/Câu trả lời tìm kiếm) Thành phố (ví dụ: thành phố) nơi dừng xe buýt / trạm đến. |
| reservationFor.arrivalBusStop.address.addressRegion | Văn bản | (nên dùng cho thẻ xác nhận/Câu trả lời tìm kiếm) Khu vực (ví dụ: tiểu bang) nơi dừng xe buýt / trạm đến. |
| reservationFor.arrivalBusStop.address.postalCode | Văn bản | (nên dùng cho thẻ xác nhận/Câu trả lời tìm kiếm) Mã bưu chính của trạm / bến xe buýt đến. |
| reservationFor.arrivalBusStop.address.addressCountry | Văn bản hoặc Quốc gia | (nên dùng cho thẻ xác nhận/Câu trả lời tìm kiếm) Quốc gia nơi / trạm xe buýt đến. |
| reservationFor.arrivalBusStop.directions | Văn bản | Đường đi đến trạm xe buýt. |
| reservationFor.arrivalTime | DateTime | (bắt buộc) Thời gian đến của xe buýt. |
| reservedTicket | Phiếu yêu cầu hỗ trợ | Thông tin vé. |
| reservedTicket.ticketNumber | Văn bản | Số hoặc mã vé. |
| reservedTicket.downloadUrl | URL | . |
| reservedTicket.printUrl | URL | . |
| reservedTicket.ticketToken | Văn bản hoặc URL | Nếu hình ảnh mã vạch được lưu trữ trên trang web của bạn, thì giá trị của trường này sẽ là URL của hình ảnh, mã vạch hoặc URI QR, chẳng hạn như "barcode128:AB34" (mã vạch ISO-15417), "qrCode:AB34" (mã QR), "aztecCode:AB34" (mã Aztec), "barcodeEAN:1234" (mã EAN) và "mã vạchUPCA:1234" (mã UPCA). |
| reservedTicket.additionalTicketText | Văn bản | Văn bản giải thích bổ sung về vé. |
| reservedTicket.price | Văn bản | Tổng giá vé. |
| Vé dành riêng.priceCurrency | Văn bản | Đơn vị tiền tệ (ở định dạng ISO 4217 gồm 3 chữ cái) của giá vé. |
| reservedTicket.underName | Person (Người) hoặc Organization (Tổ chức) | Người hoặc tổ chức có vé. |
| reservedTicket.underName.name | Văn bản | Tên của người đó. |
| reservedTicket.ticketedSeat | Ghế ngồi | Vị trí của ghế đã đặt trước (ví dụ: 27 tỷ). . |
| reservedTicket.ticketedSeat.seatingType | Văn bản | Loại/lớp chỗ ngồi. |
| reservedTicket.ticketedSeat.seatNumber | Văn bản | Vị trí của chỗ ngồi đã đặt trước. |
| reservedTicket.ticketedSeat.seatRow | Văn bản | Vị trí hàng của ghế đã đặt trước. |