Cas d'utilisation
Les cas d'utilisation suivants illustrent des exemples courants d'utilisation du schéma BusReservation. Utilisez ces exemples pour vous assurer que votre balisage est correctement structuré.
Confirmation de réservation basique
Intégrez le balisage suivant à votre e-mail lorsque vous envoyez une confirmation de réservation.
L'appli Google affichera les détails de la réservation le jour du trajet et informera l'utilisateur de l'heure à laquelle il doit partir pour arriver à l'arrêt de bus à l'heure (en tenant compte du mode de transport, du trafic, etc.). Si vous fournissez une URL d'enregistrement comme dans l'exemple ci-dessous, l'appli Google la présentera à l'utilisateur 24 heures avant son voyage.
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>
Microdonnées
<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>
Carte d'embarquement et billet
En plus de la confirmation de réservation, vous pouvez afficher une carte d'embarquement pour une carte de confirmation dans un e-mail distinct.
Les cartes de confirmation peuvent non seulement aider l'utilisateur à se rendre à l'arrêt de bus à l'heure, mais aussi lui présenter le billet pendant le trajet. Pour cela, vous devez inclure des champs supplémentaires dans le balisage. Si des champs supplémentaires sont requis pour embarquer des passagers, indiquez-les dans le champ additionalTicketText.
Pour les billets sans places réservées, les champs suivants sont : numSeats, ticketNumber et 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>
Microdonnées
<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>
Pour les billets avec places réservées, les champs suivants sont les suivants : seatNumber, seatingType, ticketNumber et 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>
Microdonnées
<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>
Exemple avec tous les champs acceptés
Pour référence, voici un exemple où tous les champs acceptés sont renseignés:
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>
Microdonnées
<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>
Tester le balisage
Vous pouvez valider votre balisage à l'aide de l'outil de test du balisage des e-mails. Collez votre code de balisage, puis cliquez sur le bouton Valider pour analyser le contenu et recevoir un rapport sur les éventuelles erreurs.
Spécification
Consultez les détails de votre e-mail pour voir si l'un de ces établissements s'applique à votre réservation de bus. En marquant ces propriétés supplémentaires, vous permettez à Google d'offrir une description beaucoup plus détaillée de la réservation de bus à l'utilisateur.
| Propriété | Type | Description |
|---|---|---|
| reservationNumber | Texte | (Obligatoire) Numéro ou identifiant de la réservation. |
| url | URL | Page Web sur laquelle la réservation peut être affichée. |
| underName | Personne ou organisation | (Obligatoire) Le passager. |
| underName.name | Texte | (obligatoire) Nom de la personne. |
| underName.email | Texte | Adresse e-mail. |
| programMembership | ProgramMembership | Abonnement à un grand voyageur, programme de fidélité d'un hôtel, etc. appliqué à la réservation. |
| programMembership.memberNumber | Texte | Identifiant de l'appartenance. |
| programMembership.program | Texte | Nom du programme. |
| bookingAgent | Organisation ou personne | Agent de réservation ou agence. Accepte également une chaîne (par exemple, ""). |
| bookingAgent.name | Texte | Nom de l'agent/du service. |
| bookingAgent.url | URL | Site Web de l'agent/du service. |
| bookingTime | Date et heure | Date à laquelle la réservation a été effectuée. |
| modifiedTime | Date et heure | (Recommandé pour les fiches de confirmation/les réponses à la recherche) Heure de la dernière modification de la réservation. |
| confirmReservationUrl | URL | Page Web sur laquelle la réservation peut être confirmée. |
| cancelReservationUrl | URL | Page Web sur laquelle la réservation peut être annulée. |
| modifyReservationUrl | URL | (recommandé pour les fiches de confirmation/les réponses à la recherche) : page Web sur laquelle la réservation peut être modifiée. |
| checkinUrl | URL | Page Web sur laquelle le passager peut signaler son arrivée. |
| reservationStatus | ReservationStatus | (Obligatoire) État actuel de la réservation. |
| reservationFor | BusTrip | (Obligatoire) Informations sur le trajet en bus. |
| reservationFor.name | Texte | Nom du trajet en bus. |
| reservationFor.busNumber | Texte | Ex. : 101. |
| reservationFor.busName | Texte | Ex. : Bolt Express. |
| reservationFor.busCompany | Entreprise | (obligatoire) p.ex., Bolt NYC. Accepte également une chaîne (par exemple, "Bolt NYC"). |
| reservationFor.busCompany.name | Texte | (Obligatoire) Nom de l'organisation. |
| reservationFor.departureBusStop | BusStop ou BusStation | (Obligatoire) Lieu de départ du bus. |
| reservationFor.departureBusStop.name | Texte | (obligatoire) Nom de l'arrêt de bus. |
| reservationFor.departureBusStop.address | PostalAddress | Adresse de l'arrêt ou de la station de bus de départ. |
| reservationFor.departureBusStop.address.streetAddress | Texte | (Recommandé pour les cartes de confirmation/les réponses à la recherche) Adresse postale de l'arrêt ou de la station de départ. |
| reservationFor.departureBusStop.address.addressLocality | Texte | (Recommandé pour les fiches de confirmation/les réponses à la recherche) Localité (par exemple, la ville) de l'arrêt ou de la gare de départ. |
| reservationFor.departureBusStop.address.addressRegion | Texte | (Recommandé pour les fiches de confirmation/les réponses à la recherche) Région (par exemple, l'État) de l'arrêt ou de la station de départ. |
| reservationFor.departureBusStop.address.postalCode | Texte | (recommandé pour les cartes de confirmation/les réponses à la recherche) Code postal de l'arrêt de bus ou de la station de départ. |
| reservationFor.departureBusStop.address.addressCountry | Texte ou Pays | (Recommandé pour les fiches de confirmation/les réponses à la recherche) Pays de l'arrêt ou de la station de départ. |
| reservationFor.departureBusStop.directions | Texte | Itinéraire jusqu'à l'arrêt de bus. |
| reservationFor.departureTime | Date et heure | (Obligatoire) Heure de départ du bus. |
| reservationFor.arrivalBusStop | BusStop ou BusStation | (obligatoire) Lieu d'arrivée du bus. |
| reservationFor.arrivalBusStop.name | Texte | (obligatoire) Nom de l'arrêt de bus. |
| reservationFor.arrivalBusStop.address | PostalAddress | Adresse de l'arrêt ou de la gare d'arrivée. |
| reservationFor.arrivalBusStop.address.streetAddress | Texte | (Recommandé pour les cartes de confirmation/les réponses à la recherche) Adresse postale de l'arrêt ou de la gare d'arrivée |
| reservationFor.arrivalBusStop.address.addressLocality | Texte | (Recommandé pour les fiches de confirmation/les réponses à la recherche) Localité (par exemple, la ville) de l'arrêt ou de la gare / station d'arrivée. |
| reservationFor.arrivalBusStop.address.addressRegion | Texte | (Recommandé pour les fiches de confirmation/les réponses à la recherche) Région (par exemple, l'État) de l'arrêt ou de la gare / station de bus d'arrivée. |
| reservationFor.arrivalBusStop.address.postalCode | Texte | (recommandé pour les cartes de confirmation/les réponses à la recherche) Code postal de l'arrêt ou de la station de bus d'arrivée. |
| reservationFor.arrivalBusStop.address.addressCountry | Texte ou Pays | (Recommandé pour les fiches de confirmation/les réponses à la recherche) Pays d'arrivée. |
| reservationFor.arrivalBusStop.directions | Texte | Itinéraire jusqu'à l'arrêt de bus. |
| reservationFor.arrivalTime | Date et heure | (Obligatoire) Heure d'arrivée du bus. |
| reservedTicket | Ticket (Demande d'assistance) | Informations sur les billets. |
| reservedTicket.ticketNumber | Texte | Numéro ou ID du billet. |
| reservedTicket.downloadUrl | URL | . |
| reservedTicket.printUrl | URL | . |
| reservedTicket.ticketToken | Texte ou URL | Si l'image du code-barres est hébergée sur votre site, la valeur du champ est l'URL de l'image, ou un code-barres ou un URI de type QR, tel que "barcode128:AB34". (codes-barres ISO-15417), "qrCode:AB34" (codes QR), "aztecCode:AB34" (codes aztèques), "code-barresEAN:1234" (codes EAN) et "code-barresUPCA:1234" (codes UPCA). |
| reservedTicket.additionalTicketText | Texte | Texte explicatif supplémentaire concernant la demande. |
| reservedTicket.price | Texte | Prix total du billet. |
| réservéTicket.priceCurrency | Texte | Devise (au format ISO 4217 à trois lettres) du prix du billet. |
| reservedTicket.underName | Personne ou organisation | Personne ou organisation à laquelle le billet est destiné. |
| reservedTicket.underName.name | Texte | Nom de la personne. |
| reservedTicket.ticketedSeat | Siège | L'emplacement du siège réservé (par exemple, 27B). . |
| reservedTicket.ticketedSeat.seatingType | Texte | Type et classe du siège. |
| reservedTicket.ticketedSeat.seatNumber | Texte | Emplacement du siège réservé. |
| reservedTicket.ticketedSeat.seatRow | Texte | Position sur la ligne du siège réservé. |