用途
以下應用實例是 BusReservation 結構定義的常見使用方式範例。請參考以下範例，確保標記的結構正確。
基本預訂確認
傳送預訂確認信時，請將下列標記嵌入電子郵件中。
Google 應用程式會在旅程當天顯示預訂詳情，並通知使用者準時抵達公車站牌的時間 (將交通方式、路況等因素納入考量)。如果您提供與下例類似的簽到網址，Google 應用程式會在行程前 24 小時內向使用者顯示這項資訊。
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>
微資料
<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>
微資料
<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>
微資料
<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>
微資料
<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 向使用者顯示更豐富的客運預訂資訊。
| 屬性 | 類型 | 說明 |
|---|---|---|
| reservationNumber | 文字 | (必要) 預留項目的編號或 ID。 |
| 網址 | 網址 | 可以檢視預訂項目的網頁。 |
| underName | Person 或 Organization | (必要) 乘客。 |
| underName.name | 文字 | (必要) 姓名 |
| underName.email | 文字 | 電子郵件地址。 |
| programMembership | ProgramMembership | 系統會將常客傳單、飯店會員方案等使用者的會員資格套用至預訂。 |
| programMembership.memberNumber | 文字 | 會員的 ID。 |
| programMembership.program | 文字 | 學程計畫名稱。 |
| bookingAgent | 機構或 Person | 預訂代理商或代理商。也接受字串 (例如「」)。 |
| bookingAgent.name | 文字 | 虛擬服務專員/服務的名稱。 |
| bookingAgent.url | 網址 | 服務專員/服務的網站。 |
| bookingTime | DateTime | 訂位日期。 |
| modifiedTime | DateTime | (適用於確認資訊卡/搜尋解答) 上次修改預訂的時間。 |
| confirmReservationUrl | 網址 | 可確認預訂網頁。 |
| cancelReservationUrl | 網址 | 可取消預訂的網頁。 |
| modifyReservationUrl | 網址 | (建議用於確認資訊卡/搜尋答案) 預訂頁面 (可修改)。 |
| checkinUrl | 網址 | 乘客可以報到的網頁。 |
| reservationStatus | ReservationStatus | (必填) 預留項目的目前狀態。 |
| reservationFor | BusTrip | (必要) 公車行程的相關資訊。 |
| reservationFor.name | 文字 | BusTrip 的名稱。 |
| reservationFor.busNumber | 文字 | 例如：101： |
| reservationFor.busName | 文字 | 例如：螺栓快速。 |
| reservationFor.busCompany | 機構組織 | (必要)，例如：Bolt NYC。也接受字串 (例如「Bolt NYC」)。 |
| reservationFor.busCompany.name | 文字 | (必要) 機構名稱。 |
| reservationFor.departureBusStop | BusStop 或 BusStation | (必要) 公車的發車地點。 |
| reservationFor.departureBusStop.name | 文字 | (必要) BusStop 的名稱。 |
| reservationFor.departureBusStop.address | PostalAddress | 出發公車站 / 車站的地址。 |
| reservationFor.departureBusStop.address.streetAddress | 文字 | (適用於確認卡/搜尋解答) 出發公車站 / 車站的街道地址。 |
| reservationFor.departureBusStop.address.addressLocality | 文字 | (適用於確認資訊卡/搜尋答案) 出發公車站 / 車站的位置 (例如城市)。 |
| reservationFor.departureBusStop.address.addressRegion | 文字 | (適用於確認資訊卡/搜尋解答) 出發公車站 / 車站的區域 (例如州)。 |
| reservationFor.departureBusStop.address.postalCode | 文字 | (適用於確認卡/搜尋答案) 出發公車站 / 車站的郵遞區號。 |
| reservationFor.departureBusStop.address.addressCountry | 文字或國家/地區 | (適用於確認卡/搜尋解答) 出發公車站/車站的國家/地區。 |
| reservationFor.departureBusStop.directions | 文字 | 前往公車站的路線。 |
| reservationFor.departureTime | DateTime | (必填) 公車出發時間。 |
| reservationFor.arrivalBusStop | BusStop 或 BusStation | (必要) 公車抵達的地點。 |
| reservationFor.arrivalBusStop.name | 文字 | (必要) BusStop 的名稱。 |
| reservationFor.arrivalBusStop.address | PostalAddress | 抵達公車站 / 車站的地址。 |
| reservationFor.arrivalBusStop.address.streetAddress | 文字 | (適用於確認卡/搜尋解答) 抵達公車站 / 車站的街道地址。 |
| reservationFor.arrivalBusStop.address.addressLocality | 文字 | (適用於確認資訊卡/搜尋答案) 抵達公車站 / 車站的位置 (例如城市)。 |
| reservationFor.arrivalBusStop.address.addressRegion | 文字 | (適用於確認資訊卡/搜尋解答) 抵達公車站 / 車站的區域 (例如州)。 |
| reservationFor.arrivalBusStop.address.postalCode | 文字 | (適用於確認卡/搜尋答案) 抵達公車站 / 車站的郵遞區號。 |
| reservationFor.arrivalBusStop.address.addressCountry | 文字或國家/地區 | (適用於確認卡/搜尋解答) 抵達公車站/車站的國家/地區。 |
| reservationFor.arrivalBusStop.directions | 文字 | 前往公車站的路線。 |
| reservationFor.arrivalTime | DateTime | (必填) 公車抵達時間。 |
| reservedTicket | 票券 | 票券資訊。 |
| reservedTicket.ticketNumber | 文字 | 票券的編號或 ID。 |
| reservedTicket.downloadUrl | 網址 | 。 |
| reservedTicket.printUrl | 網址 | 。 |
| reservedTicket.ticketToken | 文字或網址 | 如果條碼圖片是由您的網站代管，該欄位的值就是圖片的網址，或是條碼或 QR code (例如「barcode128:AB34」)(ISO-15417 條碼)、「qrCode:AB34」(QR code)、「aztecCode:AB34」(Aztec code)、「barcodeEAN:1234」(EAN 代碼) 和「barcodeUPCA:1234」(UPCA 代碼)。 |
| reservedTicket.additionalTicketText | 文字 | 關於票券的其他說明文字。 |
| reservedTicket.price | 文字 | 票券總價。 |
| rereserveTicket.priceCurrency | 文字 | 票券價格的幣別 (3 個英文字母組成的 ISO 4217 格式)， |
| reservedTicket.underName | Person 或 Organization | 支援單的個人或機構。 |
| reservedTicket.underName.name | 文字 | 人名。 |
| reservedTicket.ticketedSeat | 座位： | 預留席位 (例如27B)。。 |
| reservedTicket.ticketedSeat.seatingType | 文字 | 座位的類型/類別。 |
| reservedTicket.ticketedSeat.seatNumber | 文字 | 預留座位的位置。 |
| reservedTicket.ticketedSeat.seatRow | 文字 | 預留座位的排行位置。 |