Casos de uso
Os casos de uso a seguir mostram exemplos comuns de como o esquema BusReservation é usado. Use esses exemplos para garantir que sua marcação esteja estruturada corretamente.
Confirmação de reserva básica
Incorpore a marcação a seguir em seu e-mail ao enviar uma confirmação de reserva.
O Google app vai mostrar os detalhes da reserva no dia da viagem e notificar o usuário sobre a hora de sair para chegar ao ponto de ônibus a tempo, considerando o meio de transporte, o trânsito etc. Se você fornecer um URL de check-in como no exemplo abaixo, o Google app o exibirá para o usuário 24 horas antes da viagem.
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>
Microdados
<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>
Cartão de embarque e ingresso
Além de uma confirmação de reserva, você pode acionar um cartão de embarque com um cartão de confirmação em um e-mail separado.
Os cartões de confirmação não só ajudam a chegar ao ponto de ônibus a tempo e também mostram a passagem para o usuário durante a viagem. Para isso, é preciso incluir alguns campos adicionais na marcação. Inclua outros campos necessários para embarcar no campo additionalTicketText.
Estes são os campos de ingressos sem assentos reservados : numSeats, ticketNumber e 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>
Microdados
<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>
Para ingressos com assentos reservados, estes campos são : seatNumber, seatingType, ticketNumber e 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>
Microdados
<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>
Exemplo com todos os campos compatíveis
Como referência, veja um exemplo com todos os campos aceitos preenchidos:
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>
Microdados
<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>
Testar sua marcação
É possível validar sua marcação usando a Ferramenta para testar a marcação em e-mails. Cole seu código de marcação e clique no botão Validar para digitalizar o conteúdo e receber um relatório sobre os erros presentes.
Especificação
Revise os detalhes do seu e-mail para ver se alguma dessas propriedades é aplicável à sua reserva de ônibus. Ao marcar essas propriedades adicionais, você permite que o Google mostre ao usuário uma descrição muito mais detalhada da reserva de ônibus.
| Propriedade | Tipo | Descrição |
|---|---|---|
| reservationNumber | Texto | (obrigatório) O número ou ID da reserva. |
| url | URL | Página da Web em que as reservas podem ser visualizadas. |
| underName | Pessoa ou organização | (obrigatório) O passageiro. |
| underName.name | Texto | (obrigatório) Nome da pessoa. |
| underName.email | Texto | Endereço de e-mail. |
| programMembership | ProgramMembership | Qualquer associação em um programa de milhagem, programa de fidelidade de hotel etc. que esteja sendo aplicada à reserva. |
| programMembership.memberNumber | Texto | O identificador da assinatura. |
| programMembership.program | Texto | É o nome do programa. |
| bookingAgent | Organização ou Pessoa | Agente ou agência de reservas. Também aceita uma string (por exemplo, ""). |
| bookingAgent.name | Texto | Nome do agente/serviço. |
| bookingAgent.url | URL | Site do agente/serviço. |
| bookingTime | DateTime | Data em que a reserva foi feita. |
| modifiedTime | DateTime | (recomendado para cartões de confirmação/respostas da pesquisa) Hora em que a reserva foi modificada pela última vez. |
| confirmReservationUrl | URL | Página da Web em que é possível confirmar a reserva. |
| cancelReservationUrl | URL | Página da Web em que é possível cancelar a reserva. |
| modifyReservationUrl | URL | (recomendado para cartões de confirmação/respostas da pesquisa) Página da Web em que a reserva pode ser modificada. |
| checkinUrl | URL | Página da Web em que o passageiro pode fazer check-in. |
| reservationStatus | ReservationStatus | (obrigatório) Status atual da reserva. |
| reservationFor | BusTrip | (obrigatório) Informações sobre a viagem de ônibus. |
| reservationFor.name | Texto | Nome do BusTrip. |
| reservationFor.busNumber | Texto | Por exemplo: 101. |
| reservationFor.busName | Texto | Por exemplo: Bolt Express. |
| reservationFor.busCompany | Organização | (obrigatório), por exemplo, Parafuso Nova York. Também aceita uma string (por exemplo, "Parafuso Nova York"). |
| reservationFor.busCompany.name | Texto | (obrigatório) Nome da organização. |
| reservationFor.departureBusStop | BusStop ou BusStation | (obrigatório) De onde parte o ônibus. |
| reservationFor.departureBusStop.name | Texto | (obrigatório) Nome do BusStop. |
| reservationFor.departureBusStop.address | PostalAddress | Endereço do ponto de ônibus / estação de partida. |
| reservationFor.departureBusStop.address.streetAddress | Texto | (recomendado para cartões de confirmação/respostas da pesquisa) Endereço da estação / ponto de ônibus de partida. |
| reservationFor.departureBusStop.address.addressLocality | Texto | (recomendado para cartões de confirmação/respostas da pesquisa) Região administrativa (por exemplo, cidade) do ponto de ônibus / estação de partida. |
| reservationFor.departureBusStop.address.addressRegion | Texto | (recomendado para cartões de confirmação/respostas da pesquisa) Região (por exemplo, estado) do ponto de ônibus / estação de partida. |
| reservationFor.departureBusStop.address.postalCode | Texto | (recomendado para cartões de confirmação/respostas da pesquisa) CEP do ponto de ônibus / estação de partida. |
| reservationFor.departureBusStop.address.addressCountry | Texto ou país | (recomendado para cartões de confirmação/respostas da pesquisa) País do ponto de ônibus / estação de partida. |
| reservationFor.departureBusStop.directions | Texto | Rotas até o ponto de ônibus. |
| reservationFor.departureTime | DateTime | (obrigatório) Horário de partida do ônibus. |
| reservationFor.arrivalBusStop | BusStop ou BusStation | (obrigatório) O local de chegada do ônibus. |
| reservationFor.arrivalBusStop.name | Texto | (obrigatório) Nome do BusStop. |
| reservationFor.arrivalBusStop.address | PostalAddress | Endereço do ponto de ônibus / estação de chegada. |
| reservationFor.arrivalBusStop.address.streetAddress | Texto | (recomendado para cartões de confirmação/respostas da pesquisa) Endereço da estação / ponto de ônibus de chegada. |
| reservationFor.arrivalBusStop.address.addressLocality | Texto | (recomendado para cartões de confirmação/respostas da pesquisa) Região administrativa (por exemplo, cidade) do ponto de ônibus / estação de chegada. |
| reservationFor.arrivalBusStop.address.addressRegion | Texto | (recomendado para cartões de confirmação/respostas da pesquisa) Região (por exemplo, estado) do ponto de ônibus / estação de chegada. |
| reservationFor.arrivalBusStop.address.postalCode | Texto | (recomendado para cartões de confirmação/respostas da pesquisa) CEP do ponto de ônibus / estação de chegada. |
| reservationFor.arrivalBusStop.address.addressCountry | Texto ou país | (recomendado para cartões de confirmação/respostas da pesquisa) País do ponto de ônibus / estação de chegada. |
| reservationFor.arrivalBusStop.directions | Texto | Rotas até o ponto de ônibus. |
| reservationFor.arrivalTime | DateTime | (obrigatório) Horário de chegada do ônibus. |
| reservedTicket | "Ticket" (Tíquete) | Informações sobre passagens. |
| reservedTicket.ticketNumber | Texto | O número ou ID do tíquete. |
| reservedTicket.downloadUrl | URL | . |
| reservedTicket.printUrl | URL | . |
| reservedTicket.ticketToken | Texto ou URL | Se a imagem do código de barras estiver hospedada no seu site, o valor do campo será o URL da imagem, ou um URI de código de barras ou QR, como "barcode128:AB34" (códigos de barras ISO-15417), "qrCode:AB34" (QR codes), "aztecCode:AB34" (códigos Astec), "barcodeEAN:1234" (códigos EAN) e "barcodeUPCA:1234" (códigos UPCA). |
| reservedTicket.additionalTicketText | Texto | Texto explicativo adicional sobre o ingresso. |
| reservedTicket.price | Texto | Preço total do ingresso. |
| reserveTicket.priceCurrency. | Texto | A moeda (no formato ISO 4217 de três letras) do preço do ingresso. |
| reservedTicket.underName | Pessoa ou organização | A pessoa ou organização a que o tíquete se destina. |
| reservedTicket.underName.name | Texto | Nome da pessoa. |
| reservedTicket.ticketedSeat | Assento | O local do assento reservado (por exemplo, 27B). . |
| reservedTicket.ticketedSeat.seatingType | Texto | O tipo/classe do assento. |
| reservedTicket.ticketedSeat.seatNumber | Texto | O local do assento reservado. |
| reservedTicket.ticketedSeat.seatRow | Texto | O local da fila do assento reservado. |