Casos prácticos
En los siguientes casos de uso, se muestran ejemplos comunes de cómo se usa el esquema BusReservation. Usa estos ejemplos para asegurarte de que tu lenguaje de marcado esté estructurado correctamente.
Confirmación básica de la reserva
Cuando envíes una confirmación de reserva, incorpora el siguiente lenguaje de marcado en tu correo electrónico.
El día del viaje, la app de Google mostrará los detalles de la reserva y le notificará al usuario la hora a la que debe salir para llegar a la parada de autobús a tiempo (teniendo en cuenta el medio de transporte, el tráfico, etcétera). Si proporcionas una URL de registro, como en el siguiente ejemplo, la app de Google se la mostrará al usuario 24 horas antes del viaje.
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>
Microdatos
<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>
Tarjeta de embarque y entrada
Además de la confirmación de la reserva, puedes activar una tarjeta de confirmación de embarque en un correo electrónico aparte.
Las tarjetas de confirmación no solo pueden ayudar al usuario a llegar a la parada de autobús a tiempo, sino que también le muestran el boleto durante el viaje. Para ello, se deben incluir algunos campos adicionales en el marcado. Si hay campos adicionales que se requieren para abordar a los pasajeros, inclúyelos en el campo additionalTicketText.
En el caso de los boletos sin asientos reservados, estos campos son : 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>
Microdatos
<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 las entradas con asientos reservados, estos campos son : 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>
Microdatos
<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>
Ejemplo con todos los campos admitidos
Como referencia, aquí tienes un ejemplo con todos los campos admitidos completados:
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>
Microdatos
<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>
Prueba tu lenguaje de marcado
Puedes validar tu lenguaje de marcado con la Herramienta de prueba de lenguaje de marcado de correo electrónico. Pega tu código de lenguaje de marcado y haz clic en el botón Validar para analizar el contenido y recibir un informe sobre los errores presentes.
Especificación
Revisa los detalles de tu correo electrónico para ver si alguna de estas propiedades se aplica a tu reserva de autobús. Si marcas estas propiedades adicionales, permites que Google muestre una descripción mucho más detallada de la reserva de autobús al usuario.
| Propiedad | Tipo | Descripción |
|---|---|---|
| reservationNumber | Texto | (obligatorio) Es el número o ID de la reserva. |
| url | URL | Página web en la que se puede ver la reserva. |
| underName | Person o Organization | (Obligatorio) Es el pasajero. |
| underName.name | Texto | (obligatorio) Nombre de la persona. |
| underName.email | Texto | Dirección de correo electrónico. |
| programMembership | ProgramMembership | Cualquier membresía en un programa de pasajero frecuente, un programa de lealtad de hotel, etc., que se aplique a la reserva |
| programMembership.memberNumber | Texto | Es el identificador de la membresía. |
| programMembership.program | Texto | Indica el nombre del programa. |
| bookingAgent | Organization o Person | Agencia o agente de reservas. También acepta una cadena (p.ej., ""). |
| bookingAgent.name | Texto | Nombre del agente o servicio. |
| bookingAgent.url | URL | Sitio web del agente o servicio. |
| bookingTime | DateTime | Fecha en la que se hizo la reservación. |
| modifiedTime | DateTime | (Recomendado para tarjetas de confirmación o Respuestas en la Búsqueda) Es la fecha y hora en que se modificó la reserva por última vez. |
| confirmReservationUrl | URL | Página web en la que se puede confirmar la reserva. |
| cancelReservationUrl | URL | Página web en la que se puede cancelar la reserva. |
| modifyReservationUrl | URL | (Recomendado para tarjetas de confirmación o Respuestas en la Búsqueda) Página web en la que se puede modificar la reserva. |
| checkinUrl | URL | Página web en la que el pasajero puede registrarse. |
| reservationStatus | ReservationStatus | (obligatorio) Es el estado actual de la reserva. |
| reservationFor | BusTrip | (Obligatorio) Es la información sobre el viaje en autobús. |
| reservationFor.name | Texto | Nombre del BusTrip. |
| reservationFor.busNumber | Texto | p.ej., 101. |
| reservationFor.busName | Texto | p.ej., Bolt Express. |
| reservationFor.busCompany | Organization | (Obligatorio) p.ej., Bolt NYC. También acepta una cadena (p.ej., "Bolt NYC"). |
| reservationFor.busCompany.name | Texto | (obligatorio) Nombre de la organización. |
| reservationFor.departureBusStop | BusStop o BusStation | (Obligatorio) Lugar de partida del autobús. |
| reservationFor.departureBusStop.name | Texto | (Obligatorio) Nombre de la parada de autobús. |
| reservationFor.departureBusStop.address | PostalAddress | Dirección de la parada o estación de autobús de salida. |
| reservationFor.departureBusStop.address.calle | Texto | (Recomendado para las tarjetas de confirmación y las respuestas de la Búsqueda) Dirección de la parada o estación de autobús de salida. |
| reservationFor.departureBusStop.address.addressLocality | Texto | (Recomendado para tarjetas de confirmación o Respuestas en la Búsqueda) Localidad (p.ej., ciudad) de la parada o estación de autobús de salida. |
| reservationFor.departureBusStop.address.addressRegion | Texto | (Recomendado para tarjetas de confirmación o Respuestas de la Búsqueda) Región (p.ej., estado) de la parada o estación de autobús de salida. |
| reservationFor.departureBusStop.address.postalCode | Texto | (Recomendado para tarjetas de confirmación o respuestas de la Búsqueda) Código postal de la parada o estación de autobús de salida. |
| reservationFor.departureBusStop.address.addressCountry | Texto o País | (Recomendado para tarjetas de confirmación o Respuestas en la Búsqueda) Parada o estación de autobús del país de salida. |
| reservationFor.departureBusStop.directions | Texto | Indicaciones para llegar a la parada de autobús |
| reservationFor.departureTime | DateTime | (Obligatorio) Hora de salida del autobús. |
| reservationFor.arrivalBusStop | BusStop o BusStation | (obligatorio) Parada a la que llega el autobús. |
| reservationFor.arrivalBusStop.name | Texto | (Obligatorio) Nombre de la parada de autobús. |
| reservationFor.arrivalBusStop.address | PostalAddress | Dirección de la parada o estación de autobús de llegada. |
| reservationFor.arrivalBusStop.address.streetAddress | Texto | (Se recomienda para las tarjetas de confirmación y las respuestas de la Búsqueda) Dirección de la calle de la parada o estación de autobús de llegada. |
| reservationFor.arrivalBusStop.address.addressLocality | Texto | (Recomendado para tarjetas de confirmación o Respuestas en la Búsqueda) Es la localidad (p.ej., ciudad) de la parada o estación de autobús de llegada. |
| reservationFor.arrivalBusStop.address.addressRegion | Texto | (Recomendado para tarjetas de confirmación o Respuestas de la Búsqueda) Región (p.ej., estado) de la parada o estación de autobús de llegada. |
| reservationFor.arrivalBusStop.address.postalCode | Texto | (Recomendado para tarjetas de confirmación o Respuestas de la Búsqueda) Código postal de la parada o estación de autobús de llegada. |
| reservationFor.arrivalBusStop.address.addressCountry | Texto o País | (Recomendado para tarjetas de confirmación o Respuestas en la Búsqueda) País de la parada o estación de autobús de llegada. |
| reservationFor.arrivalBusStop.directions | Texto | Indicaciones para llegar a la parada de autobús |
| reservationFor.arrivalTime | DateTime | (Obligatorio) Hora de llegada del autobús. |
| reservedTicket | Ticket | Información del boleto |
| reservedTicket.ticketNumber | Texto | Es el número o ID del ticket. |
| reservedTicket.downloadUrl | URL | . |
| reservedTicket.printUrl | URL | . |
| reservedTicket.ticketToken | Texto o URL | Si la imagen del código de barras está alojada en tu sitio, el valor del campo es la URL de la imagen o un URI de código de barras o QR, como "barcode128:AB34" (códigos de barras ISO-15417), "qrCode:AB34" (códigos QR), "aztecCode:AB34" (códigos Aztec), "barcodeEAN:1234" (códigos EAN) y "barcodeUPCA:1234" (códigos UPCA). |
| reservedTicket.additionalTicketText | Texto | Es el texto explicativo adicional sobre el ticket. |
| reservedTicket.price | Texto | Precio total del boleto. |
| reservedTicket.priceCurrency | Texto | Moneda (en formato ISO 4217 de 3 letras) del precio del ticket. |
| reservedTicket.underName | Person o Organization | Organización o persona para la que se creó el ticket. |
| reservedTicket.underName.name | Texto | Nombre de la persona. |
| reservedTicket.ticketedSeat | Asiento | Ubicación del asiento reservado (p. ej., 27B) . |
| reservedTicket.ticketedSeat.seatingType | Texto | Es el tipo o la clase del asiento. |
| reservedTicket.ticketedSeat.seatNumber | Texto | Ubicación del asiento reservado. |
| reservedTicket.ticketedSeat.seatRow | Texto | Ubicación de la fila del asiento reservado. |