Kasus penggunaan
Kasus penggunaan berikut menunjukkan contoh umum cara penggunaan skema BusReservation. Gunakan contoh ini untuk memastikan markup Anda terstruktur dengan benar.
Konfirmasi pemesanan dasar
Sematkan markup berikut dalam email Anda saat Anda mengirim konfirmasi reservasi.
Aplikasi Google akan menampilkan detail reservasi pada hari perjalanan dan akan memberi tahu pengguna waktu keberangkatan untuk tiba di halte bus tepat waktu (dengan mempertimbangkan moda transportasi, lalu lintas, dll.). Jika Anda memberikan URL check-in seperti dalam contoh di bawah, aplikasi Google akan menampilkannya kepada pengguna 24 jam sebelum perjalanan pengguna.
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>
Microdata
<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>
Boarding pass dan tiket
Selain konfirmasi reservasi, Anda dapat memicu kartu boarding Kartu Konfirmasi di email terpisah.
Kartu konfirmasi tidak hanya dapat membantu pengguna tiba di halte bus tepat waktu, tetapi juga menampilkan tiket kepada pengguna selama perjalanan. Untuk itu, beberapa kolom tambahan perlu disertakan dalam markup. Jika ada kolom tambahan yang diperlukan untuk menaikkan penumpang ke pesawat, sertakan di kolom additionalTicketText.
Untuk tiket tanpa tempat duduk yang dipesan, kolom ini adalah : 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>
Microdata
<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>
Untuk tiket dengan tempat duduk yang dipesan, kolom ini adalah : 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>
Microdata
<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>
Contoh dengan semua kolom yang didukung
Sebagai referensi, berikut adalah contoh dengan semua kolom yang didukung diisi:
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>
Microdata
<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>
Menguji Markup
Anda dapat memvalidasi markup menggunakan Alat Penguji Markup Email. Tempelkan kode markup Anda dan klik tombol Validasi untuk memindai konten dan menerima laporan tentang error yang ada.
Spesifikasi
Tinjau detail email Anda untuk melihat apakah ada properti ini yang berlaku untuk reservasi bus Anda. Dengan menandai properti tambahan ini, Anda mengizinkan Google menampilkan deskripsi reservasi bus yang jauh lebih kaya kepada pengguna.
| Properti | Jenis | Deskripsi |
|---|---|---|
| reservationNumber | Teks | (wajib) Nomor atau ID reservasi. |
| url | URL | Halaman web tempat reservasi dapat dilihat. |
| underName | Person atau Organization | (wajib) Penumpang. |
| underName.name | Teks | (wajib diisi) Nama Orang. |
| underName.email | Teks | Alamat email. |
| programMembership | ProgramMembership | Keanggotaan dalam program frequent flyer, program loyalitas hotel, dll. yang diterapkan pada reservasi. |
| programMembership.memberNumber | Teks | ID keanggotaan. |
| programMembership.program | Teks | Nama program. |
| bookingAgent | Organization atau Person | Agen atau biro perjalanan. Juga menerima string (misalnya, ""). |
| bookingAgent.name | Teks | Nama agen/layanan. |
| bookingAgent.url | URL | Situs agen/layanan. |
| bookingTime | DateTime | Tanggal reservasi dibuat. |
| modifiedTime | DateTime | (direkomendasikan untuk kartu konfirmasi/Jawaban Penelusuran) Waktu saat pemesanan terakhir diubah. |
| confirmReservationUrl | URL | Halaman web tempat reservasi dapat dikonfirmasi. |
| cancelReservationUrl | URL | Halaman web tempat reservasi dapat dibatalkan. |
| modifyReservationUrl | URL | (direkomendasikan untuk kartu konfirmasi/Jawaban Penelusuran) Halaman web tempat reservasi dapat diubah. |
| checkinUrl | URL | Halaman web tempat penumpang dapat melakukan check-in. |
| reservationStatus | ReservationStatus | (wajib) Status reservasi saat ini. |
| reservationFor | BusTrip | (wajib) Informasi tentang perjalanan bus. |
| reservationFor.name | Teks | Nama BusTrip. |
| reservationFor.busNumber | Teks | mis. 101. |
| reservationFor.busName | Teks | mis. Bolt Express. |
| reservationFor.busCompany | Organisasi | (wajib) misalnya Bolt NYC. Juga menerima string (mis. "Bolt NYC"). |
| reservationFor.busCompany.name | Teks | (wajib diisi) Nama Organisasi. |
| reservationFor.departureBusStop | BusStop atau BusStation | (wajib) Tempat keberangkatan bus. |
| reservationFor.departureBusStop.name | Teks | (wajib) Nama BusStop. |
| reservationFor.departureBusStop.address | PostalAddress | Alamat halte / stasiun bus keberangkatan. |
| reservationFor.departureBusStop.address.streetAddress | Teks | (direkomendasikan untuk kartu konfirmasi/Jawaban Penelusuran) Alamat jalan halte / stasiun bus keberangkatan. |
| reservationFor.departureBusStop.address.addressLocality | Teks | (direkomendasikan untuk kartu konfirmasi/Jawaban Penelusuran) Lokalitas (misalnya, kota) dari halte / stasiun bus keberangkatan. |
| reservationFor.departureBusStop.address.addressRegion | Teks | (direkomendasikan untuk kartu konfirmasi/Jawaban Penelusuran) Wilayah (misalnya, Negara Bagian) dari halte / stasiun bus keberangkatan. |
| reservationFor.departureBusStop.address.postalCode | Teks | (direkomendasikan untuk kartu konfirmasi/Jawaban Penelusuran) Kode pos halte / stasiun bus keberangkatan. |
| reservationFor.departureBusStop.address.addressCountry | Teks atau Negara | (direkomendasikan untuk kartu konfirmasi/Jawaban Penelusuran) Halte / stasiun bus keberangkatan. |
| reservationFor.departureBusStop.directions | Teks | Rute ke halte bus. |
| reservationFor.departureTime | DateTime | (wajib) Waktu keberangkatan bus. |
| reservationFor.arrivalBusStop | BusStop atau BusStation | (wajib) Tempat bus tiba. |
| reservationFor.arrivalBusStop.name | Teks | (wajib) Nama BusStop. |
| reservationFor.arrivalBusStop.address | PostalAddress | Alamat halte / stasiun bus kedatangan. |
| reservationFor.arrivalBusStop.address.streetAddress | Teks | (direkomendasikan untuk kartu konfirmasi/Jawaban Penelusuran) Alamat jalan dari halte / stasiun bus kedatangan. |
| reservationFor.arrivalBusStop.address.addressLocality | Teks | (direkomendasikan untuk kartu konfirmasi/Jawaban Penelusuran) Lokalitas (mis. kota) halte / stasiun bus kedatangan. |
| reservationFor.arrivalBusStop.address.addressRegion | Teks | (direkomendasikan untuk kartu konfirmasi/Jawaban Penelusuran) Wilayah (misalnya, Negara Bagian) perhentian / stasiun bus kedatangan. |
| reservationFor.arrivalBusStop.address.postalCode | Teks | (direkomendasikan untuk kartu konfirmasi/Jawaban Penelusuran) Kode pos halte / stasiun bus tujuan. |
| reservationFor.arrivalBusStop.address.addressCountry | Teks atau Negara | (direkomendasikan untuk kartu konfirmasi/Jawaban Penelusuran) Halte / stasiun bus di negara tujuan. |
| reservationFor.arrivalBusStop.directions | Teks | Rute ke halte bus. |
| reservationFor.arrivalTime | DateTime | (wajib) Waktu kedatangan bus. |
| reservedTicket | Tiket | Informasi tiket. |
| reservedTicket.ticketNumber | Teks | Nomor atau ID tiket. |
| reservedTicket.downloadUrl | URL | . |
| reservedTicket.printUrl | URL | . |
| reservedTicket.ticketToken | Teks atau URL | Jika gambar kode batang dihosting di situs Anda, nilai kolom adalah URL gambar, atau URI kode batang atau QR, seperti "barcode128:AB34" (kode batang ISO-15417), "qrCode:AB34" (kode QR), "aztecCode:AB34" (kode Aztec), "barcodeEAN:1234" (kode EAN), dan "barcodeUPCA:1234" (kode UPCA). |
| reservedTicket.additionalTicketText | Teks | Teks penjelasan tambahan tentang tiket. |
| reservedTicket.price | Teks | Total harga tiket. |
| reservedTicket.priceCurrency | Teks | Mata uang (dalam format ISO 4217 3 huruf) harga tiket. |
| reservedTicket.underName | Person atau Organization | Orang atau Organisasi yang memiliki tiket. |
| reservedTicket.underName.name | Teks | Nama Orang. |
| reservedTicket.ticketedSeat | Slot | Lokasi kursi yang dipesan (misalnya, 27B). . |
| reservedTicket.ticketedSeat.seatingType | Teks | Jenis/kelas kursi. |
| reservedTicket.ticketedSeat.seatNumber | Teks | Lokasi kursi yang dipesan. |
| reservedTicket.ticketedSeat.seatRow | Teks | Lokasi baris kursi yang dipesan. |