ユースケース
次のユースケースでは、BusReservation スキーマの一般的な使用例を示します。以下の例を使用して、マークアップが適切に構造化されていることを確認します。
予約に関する基本的な確認
予約確認を送信する際に、次のマークアップをメールに埋め込む。
Google アプリでは、移動当日に予約の詳細が表示され、（交通手段や交通状況などを考慮して）定刻に出発する出発時刻がユーザーに表示されます。以下の例のようなチェックイン URL を指定すると、ユーザーが訪問する 24 時間前までに Google アプリがユーザーにこの URL を表示します。
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>
搭乗券とチケット
予約確認メールに加えて、確認カードの搭乗券を別途メールでトリガーすることもできます。
確認カードは、時間どおりにバス停に到着できるようにするだけでなく、移動中にチケットをユーザーに表示することもできます。そのためには、いくつかの追加フィールドをマークアップに含める必要があります。乗客の搭乗に追加が必要なフィールドがある場合は、additionalTicketText フィールドに追加します。
座席が予約されていないチケットの場合、このフィールドは 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>
座席が予約済みのチケットの場合、このフィールドは 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>
サポートされているすべてのフィールドの例
サポートされているすべてのフィールドが入力された例を次に示します。
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>
マークアップをテスト
マークアップの検証には、メール マークアップ テスター ツールを使用できます。マークアップ コードを貼り付けて [検証] ボタンをクリックすると、コンテンツがスキャンされ、エラーが見つかった場合はレポートが届きます。
仕様
メールの詳細を確認し、下記のプロパティがバスの予約に適用されるかどうかを確認します。これらの追加プロパティをマークアップすることで、バスの予約の詳細を Google でユーザーに表示できます。
| プロパティ | タイプ | 説明 |
|---|---|---|
| 予約番号 | Text | （必須）予約の番号または ID。 |
| URL | URL | 予約を表示できるウェブページ。 |
| UnderName | Person または Organization | （必須）同乗者。 |
| underName | Text | （必須）担当者の名前。 |
| underName.メールアドレス | Text | メールアドレス。 |
| プログラム メンバーシップ | プログラムのメンバー | マイレージ、ホテル向けポイント プログラムなどのメンバーシップが予約に適用されます。 |
| programMembership.memberNumber | Text | メンバーシップの ID。 |
| programMembership.program | Text | プログラムの名前。 |
| BookAgent | Organization または Person | 予約エージェントまたは代理店。文字列（「.」など）も使用できます。 |
| bookingAgent.名前 | Text | エージェント/サービスの名前。 |
| bookingAgent.URL | URL | エージェント/サービスのウェブサイト。 |
| 予約時間 | DateTime | 予約が行われた日付。 |
| 変更日時 | DateTime | （確認カード / 検索の回答に推奨）予約の最終更新日時。 |
| confirmReservationUrl | URL | 予約を確認できるウェブページです。 |
| cancelReservationUrl | URL | 予約をキャンセルできるウェブページです。 |
| changeReservationUrl | URL | （確認カード / 検索での回答に推奨）予約を変更できるウェブページです。 |
| チェックイン URL | URL | 乗客がチェックインできるウェブページ。 |
| 予約ステータス | ReservationStatus | （必須）予約の現在のステータス。 |
| 予約 | 旅行 | （必須）バスのルートに関する情報。 |
| reservationFor の名前 | Text | BusTrip の名前。 |
| reservationFor.busNumber | Text | 例: 101. |
| reservationFor.bus の名前 | Text | 例: Bolt Express。 |
| reservationFor.busCompany | 組織 | （必須）例: Bolt NYC文字列で指定できます（例:「Bolt NYC」）。 |
| reservationFor.busCompany.名前 | Text | （必須）組織の名前。 |
| reservationFor出発のバス停 | BusStop または BusStation | （必須）バスの出発地。 |
| reservationFor.exitBusStop. | Text | （必須）BusStop の名前。 |
| reservationFor.exitBusStop. のアドレス | PostalAddress | 出発バス停または駅の住所。 |
| reservationFor.exitBusStop.address.番地 | Text | （確認カード / 検索での回答で推奨）出発バス停または駅の番地。 |
| reservationFor.exitBusStop.address.address | Text | （確認カード / 検索での回答に推奨）出発バス停 / 駅の地域区分（市区町村など）。 |
| reservationFor.exitBusStop.address.住所の地域 | Text | （確認カード/検索での回答に推奨）出発バス停 / 駅の地域（州など）。 |
| reservationFor.exitBusStop.address.postalCode | Text | （確認カード/検索での回答で推奨）出発バス停 / 駅の郵便番号。 |
| reservationFor.exitBusStop.address.住所国 | テキストまたは国 | （確認カード / 検索での回答に推奨）出発バス停または駅がある国。 |
| reservationFor.deliveryBusStop. | Text | バス停までの経路。 |
| reservationFor の出発時刻 | DateTime | （必須）バスの出発時刻。 |
| reservationFor.arrivalBusStop | BusStop または BusStation | （必須）バスの到着地。 |
| reservationFor.arrivalBusStop. 名 | Text | （必須）BusStop の名前。 |
| reservationFor.arrivalBusStop. アドレス | PostalAddress | 到着するバス停または駅の住所。 |
| reservationFor.arrivalBusStop.address.ストリート住所 | Text | （確認カード / 検索の回答に推奨）到着バス停 / 駅の番地。 |
| reservationFor.arrivalBusStop.address.addressLocality. | Text | （確認カード / 検索の回答に推奨）到着するバス停 / 駅の地域（都市など）。 |
| reservationFor.arrivalBusStop.address.addressRegion | Text | （確認カード/検索の回答に推奨）到着バス停 / 駅の地域（州など）。 |
| reservationFor.arrivalBusStop.address.postalCode | Text | （確認カード / 検索での回答に推奨）到着バス停 / 駅の郵便番号。 |
| reservationFor.arrivalBusStop.address.addressCountry | テキストまたは国 | （確認カード / 検索での回答で推奨）到着するバス停または駅がある国。 |
| reservationFor.arrivalBusStop. | Text | バス停までの経路。 |
| reservationFor.arrivalTime | DateTime | （必須）バスの到着時刻。 |
| 予約済みのチケット | チケット | チケット情報。 |
| reservedTicket.ticketNumber | Text | チケットの番号または ID。 |
| reservedTicket.downloadUrl | URL | . |
| reservedTicket.printUrl | URL | . |
| reservedTicket.ticketToken | テキストまたは URL | バーコード画像がサイトでホストされている場合、フィールドの値は画像の URL、またはバーコードまたは QR URI（「barcode128:AB34」（ISO-15417 バーコード）、「qrCode:AB34」（QR コード）、「aztecCode:AB34」（Aztec コード）、「bar4EAN:13UP2.CA:13UP」（コード 12:13UP） |
| reservedTicket.additionalTicketText | Text | チケットに関するその他の説明テキスト。 |
| reservedTicket | Text | チケットの合計金額。 |
| reservedTicket.priceCurrency | Text | チケットの価格の通貨（3 文字の ISO 4217 形式）。 |
| reservedTicket.underName | Person または Organization | チケットが適用される個人または組織。 |
| reservedTicket.underName名前 | Text | 担当者の名前。 |
| reservedTicket.チケット制シート | 座席: | 予約済みの座席の場所（例:27B）。. |
| reservedTicket.ticketedSeat.seatingType | Text | 座席の種類/クラス。 |
| reservedTicket.ticketedSeat.seatNumber | Text | 予約済みの座席の場所。 |
| reservedTicket.ticketedSeat.seatRow | Text | 予約済みシートの行の場所。 |