用途
以下應用實例說明瞭 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. 電子郵件 | 文字 | 電子郵件地址。 |
計畫成員資格 | 計畫成員資格 | 預訂大量機票、飯店會員方案等會員資格。 |
programMEMBERS.memberNumber | 文字 | 成員資格的識別碼。 |
programMembership. 計畫 | 文字 | 學程計畫名稱。 |
預訂代理程式 | 組織或人員 | 預訂代理商或代理商。同時也接受字串 (例如 "")。 |
bookingAgent.name | 文字 | 服務專員/服務的名稱。 |
bookingAgent.url | 網址 | 服務專員/服務的網站。 |
預訂時間 | DateTime | 進行預訂的日期。 |
修改時間 | DateTime | (建議用於確認資訊卡/搜尋答案) 保留上次修改時間的時間。 |
確認預訂網址 | 網址 | 可確認預訂的網頁。 |
cancelReservationUrl | 網址 | 可取消預訂的網頁。 |
修改預訂網址 | 網址 | (建議用於確認資訊卡/搜尋解答) 可供修改預訂的網頁。 |
checkinUrl | 網址 | 乘客可以登機的網頁。 |
預訂狀態 | Reservation Status | (必填) 預訂的目前狀態。 |
預訂 | BusTrip | (必填) 公車行程的相關資訊。 |
reservationFor. 名稱 | 文字 | BusTrip 的名稱。 |
reservationFor.busNumber | 文字 | 例如 101 |
reservationFor.busName | 文字 | 例如:Bolt Express。 |
reservationFor.busCompany | 機構組織 | (必填),例如 Bolt NYC。系統也接受字串 (例如「Bolt NYC」)。 |
reservationFor.busCompany.name | 文字 | (必要) 機構名稱。 |
reservationFor.flightBusStop | BusStop 或 BusStation | (必填) 公車的發車地點。 |
reservationFor.flightBusStop.name | 文字 | (必要) BusStop 的名稱。 |
reservationFor.exitBusStop. 位址 | 郵寄地址 | 出發公車站 / 車站的出發站點地址。 |
reservationFor.flightBusStop.address.streetAddress | 文字 | (建議用於確認卡片/搜尋答案) 發車地點/車站的街道地址。 |
reservationFor.flightBusStop.address.addressLocality | 文字 | (建議用於確認卡片/搜尋答案) 發車的停靠站/車站 (例如城市)。 |
reservationFor.flightBusStop.address.addressRegion | 文字 | (建議用於確認卡片/搜尋答案) 發車站/車站的所在地區 (例如州/省)。 |
reservationFor.flightBusStop.address.postalCode | 文字 | (建議用於確認卡片/搜尋答案) 發車地點 / 車站的郵遞區號。 |
reservationFor.exitBusStop.address.addressCountry | 文字或國家/地區 | (建議用於確認卡片/搜尋答案) 發車的停靠站 / 車站。 |
reservationFor.班次 BusStop.路線 | 文字 | 前往公車停靠站的路線。 |
reservationFor. 出發時間 | DateTime | (必填) 公車出發時間。 |
reservationFor.arrivalBusStop | BusStop 或 BusStation | (必填) 公車的發車地點。 |
reservationFor.arrivalBusStop.name | 文字 | (必要) BusStop 的名稱。 |
reservationFor.arrivalBusStop.位址 | 郵寄地址 | 抵達公車停靠站 / 車站的地址。 |
reservationFor.arrivalBusStop.address.streetAddress | 文字 | (建議用於確認卡片/搜尋解答) 抵達公車停靠站 / 車站的街道地址。 |
reservationFor.arrivalBusStop.address.addressLocality | 文字 | (建議用於確認卡片/搜尋答案) 抵達公車停靠站 / 車站的地區 (例如城市)。 |
reservationFor.arrivalBusStop.address.addressRegion | 文字 | (建議用於確認卡片/搜尋答案) 抵達公車停靠站/車站的地區 (例如州 / 省)。 |
reservationFor.arrivalBusStop.address.postalCode | 文字 | (建議用於確認卡片/搜尋答案) 抵達公車停靠站 / 車站的郵遞區號。 |
reservationFor.arrivalBusStop.address.addressCountry | 文字或國家/地區 | (建議用於確認卡片/搜尋解答) 抵達公車停靠站/車站的國家/地區。 |
reservationFor.arrivalBusStop.路線 | 文字 | 前往公車停靠站的路線。 |
reservationFor.arrivalTime | DateTime | (必填) 公車抵達時間。 |
預訂票 | 票券 | 票券資訊。 |
reserveTicket.TicketNumber | 文字 | 票券的編號或 ID。 |
reserveTicket.downloadUrl | 網址 | . |
reserveTicket.printUrl | 網址 | . |
reserveTicket.TicketToken | 文字或網址 | 如果條碼是由您的網站代管,欄位值就是圖片的網址,或是條碼或 QR URI,例如「barcode128:AB34」(ISO-15417 條碼)、「qrCode:AB34」(QrCode)、「QR 碼」、「azcode」(E3) 與「BIC:1:3」代碼 |
reserveTicket.additionalTicketText | 文字 | 票證的其他說明文字。 |
reserveTicket.價格 | 文字 | 車票總價。 |
reserveTicket.priceCurrency | 文字 | 車資價格的貨幣 (以 3 個英文字母組成的 ISO 4217 格式)。 |
reserveTicket.underName | Person 或 Organization | 車票所屬的人或機構。 |
reserveTicket.underName.name | 文字 | 人名。 |
reserveTicket.TicketedSeat | 座位: | 預留座位的位置 (例如27B)。. |
reserveTicket.TicketedSeat.seatingType | 文字 | 座位的類型/類別。 |
reserveTicket.TicketedSeat.seatNumber | 文字 | 訂位座位的所在地。 |
reserveTicket.TicketedSeat.seatRow | 文字 | 預留座位的列位置。 |