Trường hợp sử dụng
Các trường hợp sử dụng sau đây cho thấy những ví dụ phổ biến về cách sử dụng giản đồ BusReservation. Hãy sử dụng các ví dụ này để đảm bảo rằng bạn đã cấu trúc mã đánh dấu đúng cách.
Xác nhận đặt chỗ cơ bản
Nhúng mã đánh dấu sau đây vào email khi bạn gửi email xác nhận đặt chỗ.
Ứng dụng Google sẽ hiển thị thông tin chi tiết về lượt đặt chỗ vào ngày đi và thông báo cho người dùng biết thời gian cần rời đi để đến trạm xe buýt đúng giờ (có tính đến phương tiện giao thông, tình trạng giao thông, v.v.). Nếu bạn cung cấp một URL nhận phòng như trong ví dụ bên dưới, ứng dụng Google sẽ hiển thị URL này cho người dùng 24 giờ trước chuyến đi.
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>
Thẻ lên máy bay và vé
Ngoài email xác nhận đặt chỗ, bạn có thể kích hoạt thẻ lên máy bay 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 hành trình. Để làm được điều này, bạn cần thêm một số trường khác vào mã đánh dấu. Nếu có các trường bổ sung cần thiết để hành khách lên máy bay, hãy thêm 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 này 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 được đặt trước, các trường này 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ợ đã được đ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 Trình kiểm tra đánh dấu email. Dán mã đánh dấu vào rồi 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 hiện có.
Thông số kỹ thuật
Xem xét thông tin chi tiết trong email để xem có thuộc tính nào trong số này áp dụng cho yêu cầu đặt vé 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ị cho người dùng nội dung mô tả phong phú hơn nhiều về thông tin đặt chỗ xe buýt.
| Thuộc tính | Loại | Mô tả |
|---|---|---|
| reservationNumber | Văn bản | (bắt buộc) Số hoặc mã đặt chỗ. |
| url | URL | Trang web nơi bạn có thể xem thông tin đặt phòng. |
| 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 người đó. |
| underName.email | Văn bản | Địa chỉ email. |
| programMembership | ProgramMembership | Mọi chương trình thành viên của khách hàng 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 cho yêu cầu đặ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é hoặc công ty du lịch. Cũng chấp nhận một chuỗi (ví dụ: ""). |
| bookingAgent.name | Văn bản | Tên của tác nhân/dịch vụ. |
| bookingAgent.url | URL | Trang web của đại lý/dịch vụ. |
| bookingTime | DateTime | Ngày đặt chỗ. |
| modifiedTime | DateTime | (nên dùng cho thẻ xác nhận/Câu trả lời trên Tìm kiếm) Thời gian sửa đổi gần đây nhất của thông tin đặt phòng. |
| confirmReservationUrl | URL | Trang web nơi bạn có thể xác nhận yêu cầu đặt chỗ. |
| cancelReservationUrl | URL | Trang web nơi bạn có thể huỷ lượt đặt chỗ. |
| modifyReservationUrl | URL | (nên dùng cho thẻ xác nhận/Câu trả lời trên Tìm kiếm) Trang web nơi bạn có thể sửa đổi thông tin đặt phòng. |
| checkinUrl | URL | Trang web mà hành khách có thể làm thủ tục nhận phòng. |
| reservationStatus | ReservationStatus | (bắt buộc) Trạng thái hiện tại của lượt đặt phòng. |
| reservationFor | BusTrip | (bắt buộc) Thông tin về chuyến đi bằng 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ụ: Bolt Express. |
| reservationFor.busCompany | Tổ chức | (bắt buộc) ví dụ: Bolt NYC. Cũng chấp nhận một 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 trên 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 trên Tìm kiếm) Địa phương (ví dụ: thành phố) của trạm / bến xe buýt 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 trên Tìm kiếm) Khu vực (ví dụ: tiểu bang) của trạm dừng / ga xe buýt 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 trên Tìm kiếm) Mã bưu chính của trạm / bến xe buýt 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 trên Tìm kiếm) Quốc gia nơi có trạm dừng / nhà ga 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 xe buýt khởi hành. |
| 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 trên Tìm kiếm) Địa chỉ đường của trạm / bến 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 trên Tìm kiếm) Địa phương (ví dụ: thành phố) của trạm dừng / nhà ga xe buýt đến. |
| reservationFor.arrivalBusStop.address.addressRegion | Văn bản | (nên dùng cho thẻ xác nhận/Câu trả lời trên Tìm kiếm) Khu vực (ví dụ: tiểu bang) của trạm dừng / nhà ga xe buýt đến. |
| reservationFor.arrivalBusStop.address.postalCode | Văn bản | (nên dùng cho thẻ xác nhận/Câu trả lời trên 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 trên Tìm kiếm) Quốc gia của trạm / bến xe buýt nơi đế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 xe buýt đến. |
| reservedTicket | Vé | Thông tin về vé. |
| reservedTicket.ticketNumber | Văn bản | Số hoặc mã nhận dạng của 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 là URL của hình ảnh, hoặc một 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à "barcodeUPCA: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é. |
| reservedTicket.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 mà vé dành cho. |
| reservedTicket.underName.name | Văn bản | Tên của người. |
| reservedTicket.ticketedSeat | Ghế | Vị trí của ghế đã đặt trước (ví dụ: 27B). . |
| reservedTicket.ticketedSeat.seatingType | Văn bản | Loại/hạng ghế. |
| 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. |