本页将提供参考,供您向酒店的 价格数据。
概览
酒店价格结构化数据用于详细解释、验证和显示 您网站上列出的酒店价格,而不考虑界面。这个 还包括基本价格、费率、客房、费用与税费和价格相关的字段。
Google 建议合作伙伴在自己的网页中使用标准化 可供抓取工具识别的结构化数据;提供方 schema.org,用于准确抓取价格 。
这样,您就可以通过改进 抓取工具的可靠性。这对您来说 价格准确性验证以及调试价格准确性问题的能力 并获得一致的价格准确性得分
如果您刚开始接触结构化数据,请详细了解结构化数据词汇 和格式。
Google 酒店推荐使用 JSON-LD
格式为您的网页添加注释。请参阅
支持的格式
,详细了解其他可接受的格式。本文档提供了
特定于 Google 酒店中的结构化数据实现的详细参考内容。
Hotel
结构化数据用于为您的酒店专用字段添加注释,
网页中。Hotel
结构化数据具有以下属性:
makesOffer
媒体资源eligibleCustomerType
媒体资源
HotelRoom
结构化数据用于为以下文件中特定于房间的字段添加注释
。
HotelRoom
结构化数据具有以下属性:
offers
媒体资源includesObject
媒体资源availability
媒体资源amenityFeature
媒体资源
酒店结构化数据
name
和 address
属性
name
和 address
属性用于为酒店的名称和
位置。以下是 name
和 address
属性:
"@type": "Hotel",
"name": "hotel-name",
"identifier": "hotel-id-1234",
"address": {
"@type": "PostalAddress",
"addressCountry": "XX",
"addressLocality": "City Name",
"addressRegion": "State Name",
"postalCode": "01234",
"streetAddress": "1234 Main St."
},
语法
name
和 address
属性使用以下语法:
JSON-LD
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "hotel-name",
"identifier": "hotel-id-1234",
"address": {
"@type": "PostalAddress",
"addressCountry": "XX",
"addressLocality": "City Name",
"addressRegion": "State Name",
"postalCode": "01234",
"streetAddress": "1234 Main St."
},
"makesOffer": {
"@type": ["Offer", "LodgingReservation"]
...
}
}
属性
以下是 name
和 address
属性:
属性 | 是否必需? | 类型 | 说明 |
---|---|---|---|
Hotel.name | Required | string | 酒店名称 |
Hotel.identifier | Required | string | 合作伙伴的酒店 ID。 每个酒店的标识符必须是唯一的字符串,且应完全匹配 替换为价格 Feed 中使用的字符串。 |
Hotel.address | Optional | PostalAddress | 酒店的地址或位置。 |
示例
姓名和地址
以下是添加 name
和 address
注解的基本示例:
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "Mountain Hotel",
"identifier": "hotel-id-1234",
"address": {
"@type": "PostalAddress",
"addressCountry": "AT",
"addressLocality": "Innsbruck",
"addressRegion": "Tyrol",
"postalCode": "6020",
"streetAddress": "Technikerstrasse 21"
},
"makesOffer": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1222.74,
"priceCurrency": "USD"
}
}
}
makesOffer
个房源
makesOffer
注解用于标记
您的酒店行程。
"makesOffer": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "YYYY-MM-DD[THH:mm:ss]",
"checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
"availability": "https://schema.org/InStock",
...
}
语法
makesOffer
属性使用以下语法:
JSON-LD
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "hotel-name",
"identifier": "hotel-id-1234",
"address": { ... },
"makesOffer": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "YYYY-MM-DD[THH:mm:ss]",
"checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
"availability": "https://schema.org/InStock",
"priceSpecification": { ... }
}
}
属性
以下是 makesOffer
属性:
属性 | 是否必需? | 类型 | 说明 |
---|---|---|---|
makesOffer | Required | Offer and LodgingReservation | 指定行程的酒店优惠。
|
LodgingReservation.checkinTime | Required | DateTime | 用户所在时区的入住时间。如果您所在的时区不是 系统会考虑酒店时区。 |
LodgingReservation.checkoutTime | Required | DateTime | 退房时间(采用用户所在时区)。如果您所在的时区不是 系统会考虑酒店时区。 |
示例
makesOffer
以下是为酒店优惠添加注释的基本示例。您可以 为行程指定多项优惠,但您应指定 Google 会先显示费率,然后再显示其他费率。价格金额 包含所有适用的税款。
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "Mountain Hotel",
"identifier": "hotel-id-1234",
"address": { ... },
"makesOffer": [
{
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1222.74,
"priceCurrency": "USD"
}
},
{
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1200.74,
"priceCurrency": "USD"
}
}
]
}
Hotel priceSpecification
个房源
此属性用于为酒店或酒店的价格信息添加注释
房间。为了对您的
价格和税费。您应该使用 CompoundPriceSpecification
以指定总定价信息,例如基本费率、税费和折扣。
使用 UnitPriceSpecification
指定其他税费或特殊收费类型
例如 ResortFee
、GenericTax
和 ServiceFee
。priceSpecification
属性与 Offer
属性捆绑在一起。
{
...
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": "float",
"priceCurrency": "currency",
"priceComponent": [
{
"@type": "UnitPriceSpecification",
"name": "GenericTax",
"price": "float",
"priceCurrency": "currency"
},
...
]
}
}
语法
Hotel priceSpecification
属性使用以下语法:
JSON-LD
{
"@context": "https://schema.org",
"@type": "Hotel",
...
"makesOffer": {
"@type": ["Offer", "LodgingReservation"],
...
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": "float",
"priceCurrency": "currency",
"priceComponent": [
{
"@type": "UnitPriceSpecification",
"name": "",
"price": "float",
"priceCurrency": "currency"
},
{
"@type": "UnitPriceSpecification",
"name": "GenericTax",
"price": "float",
"priceCurrency": "currency",
"priceComponentType": "GenericTax",
"potentialAction": {
"@type": "https://schema.org/PayAction",
"recipient": {
"@type": "OnlineBusiness",
"name": "name-of-the-business"
}
}
},
{
"@type": "UnitPriceSpecification",
"name": "Discount",
"price": "float",
"priceCurrency": "currency",
"priceComponentType": "Discount"
}
]
}
}
}
微数据
<div itemscope itemtype="https://schema.org/Hotel">
<meta itemprop="name" content="hotel-name"/>
...
<div itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation" itemprop="makesOffer">
...
<div itemscope itemtype="https://schema.org/CompoundPriceSpecification" itemprop="priceSpecification">
<meta itemprop="price" content="float"/>
<meta itemprop="priceCurrency" content="currency"/>
<div itemscope itemtype="https://schema.org/UnitPriceSpecification" itemprop="priceComponent">
<meta itemprop="name" content=""/>
<meta itemprop="price" content="float"/>
<meta itemprop="priceCurrency" content="currency"/>
</div>
<div itemscope itemtype="https://schema.org/UnitPriceSpecification" itemprop="priceComponent">
<meta itemprop="name" content="GenericTax" />
<meta itemprop="price" content="float"/>
<meta itemprop="priceCurrency" content="currency"/>
<meta itemprop="priceComponentType" content="GenericTax"/>
</div>
<div itemscope itemtype="https://schema.org/UnitPriceSpecification" itemprop="priceComponent">
<meta itemprop="name" content="Discount"/>
<meta itemprop="price" content="float"/>
<meta itemprop="priceCurrency" content="currency"/>
<meta itemprop="priceComponentType" content="Discount"/>
</div>
</div>
</div>
</div>
属性
以下是 hotel priceSpecification
属性:
属性 | 是否必需? | 类型 | 说明 |
---|---|---|---|
Hotel.Offer.priceSpecification.price | Required | float | 酒店总价(含税费及其他费用)。 您的着陆页上应始终标注 Google 费率以及 提供完整的房价详情通过注释费率详情 价格准确性检查。Google 接受酒店级和客房级两种费用 价格。 |
Hotel.Offer.priceSpecification.priceCurrency | Required | currency | 指定价格的货币代码,由三个字母组成。例如:"USD"
。 |
Hotel.Offer.priceSpecification.priceComponent | Optional | UnitPriceSpecification[] | 总价的明细,包括酒店税费和其他费用。 价格结构化数据有两种类型:
您必须在 |
Hotel.Offer.priceSpecification.priceComponent. potentialAction | Optional | PayAction | 酒店的付款方式。酒店付款流程包括价格 退房时间在预订网站和 在办理入住手续时联系酒店。 您应使用与 Google 支持
|
示例
JSON-LD 示例
价格
以下是将价格结构化数据添加到
网页中。您可以在
makesOffer
属性。
PostalAddress
类型,例如 addressCountry
、postalCode
、
streetAddress
如果您选择指定
address
属性。在
makesOffer
属性。指定的价格金额包含所有适用的
税费。
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "ACME Hotel",
"identifier": "hotel-id-1234",
"address": {
"@type": "PostalAddress",
"addressCountry": "AT",
"addressLocality": "Innsbruck",
"addressRegion": "Tyrol",
"postalCode": "6020",
"streetAddress": "Technikerstrasse 21"
},
"makesOffer": [
{
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1222.74,
"priceCurrency": "USD"
}
},
{
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1200.74,
"priceCurrency": "USD"
}
},
...
]
}
价格明细
以下是 priceSpecification
属性的示例,包含
价格明细。基本费率、一般税费和折扣等税费为
使用 UnitPriceSpecification
组件进行定义。务必将
priceComponentType
字段,其中包含对应于
UnitPriceSpecification
组件。
必须在
CompoundPriceSpecification
属性。价格明细应该是
(在 priceComponent
属性中指定)。
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "ACME Hotel",
"identifier": "hotel-id-1234",
"address": {...},
"makesOffer": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1222.74,
"priceCurrency": "USD",
"priceComponent": [
{
"@type": "UnitPriceSpecification",
"name": "",
"price": 1150,
"priceCurrency": "USD"
},
{
"@type": "UnitPriceSpecification",
"name": "GenericTax",
"price": 172.74,
"priceCurrency": "USD",
"priceComponentType": "GenericTax"
},
{
"@type": "UnitPriceSpecification",
"name": "Discount",
"price": -100,
"priceCurrency": "USD",
"priceComponentType": "Discount"
}
]
}
}
}
付款点
以下是使用 potentialAction
规范的
PayAction
的收件人类型。
套餐总价为 1170 美元,在线网站收取部分费用
预订时,使用
"@type": "OnlineBusiness"
,用户必须支付剩余的 20 美元
使用
@type": "Hotel"
。
您必须指定 potentialAction
组件才能细分
在预订时以及在酒店内付款。如果未指定,则
payAction
会将预订时的付款视为默认付款
付款方式。
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "ACME Hotel",
"identifier": "hotel-id-1234",
"makesOffer": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00]",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1170,
"priceCurrency": "USD",
"priceComponent": [
{
"@type": "UnitPriceSpecification",
"price": 1150,
"priceCurrency": "USD",
"potentialAction": {
"@type": "https://schema.org/PayAction",
"recipient": {
"@type": "OnlineBusiness",
"name": "myonlinebusiness"
}
}
},
{
"@type": "UnitPriceSpecification",
"price": 20,
"priceCurrency": "USD",
"potentialAction": {
"@type": "https://schema.org/PayAction",
"recipient": {
"@type": "Hotel",
"name": "The Langham, Boston",
"address": { ... }
}
}
}
]
}
}
}
微数据示例
价格明细
以下是 priceSpecification
属性的示例,包含
价格明细。基本费率、一般税费和折扣等税费为
使用 UnitPriceSpecification
组件进行定义。务必将
name
属性,其中包含对应于
UnitPriceSpecification
组件。
必须在
CompoundPriceSpecification
属性。价格明细应该是
(在 priceComponent
属性中指定)。
<div itemscope itemtype="https://schema.org/Hotel">
<meta itemprop="name" content="ACME Hotel"/>
<meta itemprop="identifier" content="hotel-id-1234"/>
<div itemscope itemtype="https://schema.org/PostalAddress" itemprop="address">
<meta itemprop="addressCountry" content="US" />
<meta itemprop="addressLocality" content="Mountain View" />
<meta itemprop="addressRegion" content="Santa Clara" />
<meta itemprop="postalCode" content="94040" />
<meta itemprop="streetAddress" content="123 Main street" />
</div>
<div itemscope itemtype="https://schema.org/Offer https://schema.org/LodgingReservation" itemprop="makesOffer">
<meta itemprop="checkinTime" content="2023-03-10 15:00:00" />
<meta itemprop="checkoutTime" content="2023-03-16 10:00:00"/>
<div itemscope itemtype="https://schema.org/CompoundPriceSpecification" itemprop="priceSpecification">
<meta itemprop="price" content="1222.74" />
<meta itemprop="priceCurrency" content="USD" />
<div itemscope itemtype="https://schema.org/UnitPriceSpecification" itemprop="priceComponent">
<meta itemprop="name" content="" />
<meta itemprop="price" content="1150" />
<meta itemprop="priceCurrency" content="USD" />
</div>
<div itemscope itemtype="https://schema.org/UnitPriceSpecification" itemprop="priceComponent">
<meta itemprop="name" content="GenericTax" />
<meta itemprop="price" content="172.74" />
<meta itemprop="priceCurrency" content="USD" />
<meta itemprop="priceComponentType" content="GenericTax" />
</div>
<div itemscope itemtype="https://schema.org/UnitPriceSpecification" itemprop="priceComponent">
<meta itemprop="name" content="Discount" />
<meta itemprop="price" content="-100" />
<meta itemprop="priceCurrency" content="USD" />
<meta itemprop="priceComponentType" content="Discount" />
</div>
</div>
</div>
</div>
hasMerchantReturnPolicy
个房源
此属性用于在行程中标注商家退款政策。
"hasMerchantReturnPolicy": {
"@type": "MerchantReturnPolicy",
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
"refundType": "https://schema.org/FullRefund",
"merchantReturnDays": "YYYY-MM-DD[THH:mm:ss]",
"restockingFee": 0
}
语法
hasMerchantReturnPolicy
具有以下语法:
JSON-LD
{
"@context": "https://schema.org",
"@type": "Hotel",
...
"makesOffer": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "YYYY-MM-DD[THH:mm:ss]",
"checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
"priceSpecification": { ... },
"hasMerchantReturnPolicy": {
"@type": "MerchantReturnPolicy",
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
"refundType": "https://schema.org/FullRefund",
"merchantReturnDays": "YYYY-MM-DD[THH:mm:ss]",
"restockingFee": 0
}
}
}
属性
以下是 hasMerchantReturnPolicy
属性:
属性 | 是否必需? | 类型 | 说明 |
---|---|---|---|
Offer.hasMerchantReturnPolicy | Optional | MerchantReturnPolicy | 商家退款政策。合作伙伴应使用
如果未指定 |
示例
退货政策
下面是一个包含客房的酒店的结构化数据基本示例
详细信息和总价(含税费及其他费用)。此示例表示
此预订在世界协调时间 (UTC) 晚上 11 点之前可以取消,并且不会产生任何费用
2023 年 12 月 18 日。合作伙伴应使用
"MerchantReturnPolicy.restockingFee"
,用于指明取消政策
不全额退还住宿费用。restockingFee
默认值
降至 0 美元。
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "ACME Hotel",
"identifier": "hotel-id-1234",
"description": "Beautiful resort in the outskirts of the city",
"address": {...},
"makesOffer": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "2023-12-15 16:00:00",
"checkoutTime": "2023-12-20 11:00:00",
"priceSpecification": {...},
"hasMerchantReturnPolicy": {
"@type": "MerchantReturnPolicy",
"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
"refundType": "https://schema.org/FullRefund",
"merchantReturnDays": "2023-12-18 23:00:00",
"restockingFee": 0
}
}
}
eligibleCustomerType
个房源
此属性可用于注释为酒店提供的奖励活动 成为会员
"eligibleCustomerType": "RewardsMember",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": "float",
"priceCurrency": "currency"
}
语法
eligibleCustomerType
属性采用以下语法:
JSON-LD
{
"@context": "https://schema.org",
"@type": "Hotel",
...
"makesOffer": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "YYYY-MM-DD[THH:mm:ss]",
"checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
"eligibleCustomerType": "RewardsMember",
"priceSpecification": { ... }
}
}
属性
以下是 eligibleCustomerType
属性:
属性 | 是否必需? | 类型 | 说明 |
---|---|---|---|
Offer.eligibleCustomerType | Optional | BusinessEntityType | 为 客户。 许多酒店页面会同时显示会员房价和公开房价, 鼓励用户注册参加会员回馈活动。设有费率 例如会员费率,可以通过设置Offer.eligibleCustomerType 属性。 |
示例
会员费率
以下是会员价或固定费率的基本示例 (针对会员回馈活动规范)。客户是“奖励会员”/ 酒店。
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "ACME Hotel",
"identifier": "hotel-id-1234",
"address": {...},
"makesOffer": {
"@type": ["Offer", "LodgingReservation"],
"name": "RewardsMember",
"checkinTime": "2023-12-15 16:00:00",
"checkoutTime": "2023-12-20 11:00:00",
"eligibleCustomerType": "RewardsMember",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1342.74,
"priceCurrency": "USD",
"priceComponent": [
{
"@type": "UnitPriceSpecification",
"name": "Base rate",
"price": 1069.98,
"priceCurrency": "USD"
},
{
"@type": "UnitPriceSpecification",
"name": "GenericTax",
"price": 172.74,
"priceCurrency": "currency"
},
{
"@type": "UnitPriceSpecification",
"name": "ResortFee",
"price": 100,
"priceCurrency": "USD"
}
]
}
}
}
成员和常规费率
这是常规价格和会员价格注释的示例。通过 会员价显示在最前面,然后是正常费率。
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "ACME Hotel",
"identifier": "hotel-id-1234",
"address": {...},
"makesOffer": [
{
"@type": ["Offer", "LodgingReservation"],
"name": "RewardsMember",
"checkinTime": "2023-12-15 16:00:00",
"checkoutTime": "2023-12-20 11:00:00",
"eligibleCustomerType": "RewardsMember",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1342.74,
"priceCurrency": "USD",
"priceComponent": [
{
"@type": "UnitPriceSpecification",
"name": "Base rate",
"price": 1069.98,
"priceCurrency": "USD"
},
{
"@type": "UnitPriceSpecification",
"name": "GenericTax",
"price": 172.74,
"priceCurrency": "currency"
},
{
"@type": "UnitPriceSpecification",
"name": "ResortFee",
"price": 100,
"priceCurrency": "USD"
}
]
}
},
{
"@type": ["Offer", "LodgingReservation"],
"name": "regularRate",
"checkinTime": "2023-12-15 16:00:00",
"checkoutTime": "2023-12-20 11:00:00",
"priceSpecification": {
"price": 1572.24,
"priceCurrency": "USD",
"priceComponent": [
{
"@type": "UnitPriceSpecification",
"name": "Base rate",
"price": 1369.98,
"priceCurrency": "USD"
},
{
"@type": "UnitPriceSpecification",
"name": "GenericTax",
"price": 202.26,
"priceCurrency": "currency"
},
{
"@type": "UnitPriceSpecification",
"name": "ResortFee",
"price": 100,
"priceCurrency": "USD"
}
]
}
}
]
}
HotelRoom 结构化数据
offers
个房源
offers
注释用于标记会议室
行程安排。对于 HotelRoom
规范,您应使用 offers
属性。
"offers": {
"@type": ["Offer", "LodgingReservation"],
"identifier": "hotel-room-id-1234",
"checkinTime": "YYYY-MM-DD[THH:mm:ss]",
"checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
"priceSpecification": {...}
}
语法
offers
属性采用以下语法:
JSON-LD
{
"@context": "https://schema.org",
"@type": "HotelRoom",
"identifier": "hotel-room-id-1234",
"offers": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "YYYY-MM-DD[THH:mm:ss]",
"checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": "float",
"priceCurrency": "currency",
...
}
}
}
属性
以下是 offers
属性:
属性 | 是否必需? | 类型 | 说明 |
---|---|---|---|
offers | Required | Offer and LodgingReservation | 指定行程的房价规范。
|
LodgingReservation.checkinTime | Required | DateTime | 用户所在时区的入住时间。如果您所在的时区不是 系统会考虑酒店时区。 |
LodgingReservation.checkoutTime | Required | DateTime | 退房时间(采用用户所在时区)。如果您所在的时区不是 系统会考虑酒店时区。 |
示例
优惠
以下是在 HotelRoom
中指定 offers
的基本示例
属性。
{
"@context": "https://schema.org",
"@type": "HotelRoom",
"identifier": "hotel-room-id-1234",
"offers": {
"@type": ["Offer", "LodgingReservation"],
"identifier": "rate-plan-id-of-member-rate",
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1222.74,
"priceCurrency": "USD"
}
}
}
bed
和 occupancy
属性
bed
属性用于为床型和床位数添加注解
房间里有可用的房间。occupancy
属性用于为数字添加注释
各个房间里的宾客bed
和 occupancy
属性可使用
HotelRoom
属性。
"@type": "Hotel",
"identifier": "hotel-id-1234",
"containsPlace": {
"@type": ["HotelRoom", "Product"],
"identifier": "hotel-room-id",
"bed": {
"@type": "BedDetails",
"numberOfBeds": "integer",
"typeOfBed": "KING"
},
"occupancy": {
"@type": "QuantitativeValue",
"value": "integer"
}
}
语法
bed
和 occupancy
属性的语法如下:
JSON-LD
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "hotel-name",
"identifier": "hotel-id-1234",
"containsPlace": {
"@type": ["HotelRoom", "Product"],
"name": "room-name",
"identifier": "hotel-room-id-1234",
"bed": {
"@type": "BedDetails",
"numberOfBeds": "integer",
"typeOfBed": "KING"
},
"occupancy": {
"@type": "QuantitativeValue",
"value": "integer"
},
"offers": {
"@type": ["Offer", "LodgingReservation"],
"identifier": "rate-plan-id-of-member-rate",
"checkinTime": "YYYY-MM-DD[THH:mm:ss]",
"checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": "float",
"priceCurrency": "currency",
"priceComponent": {
"@type": "UnitPriceSpecification",
"name": "",
"price": "float",
"priceCurrency": "currency"
},
...
}
}
}
}
bed
和 occupancy
属性只能通过 HotelRoom
进行设置
属性。可以包含客房专属信息,包括客房级房价
通过 containsPlace
属性将此属性分配给 Hotel
属性。请参阅
Hotel
和 HotelRoom
规范示例。
属性
以下是 bed
和 occupancy
属性:
属性 | 是否必需? | 类型 | 说明 |
---|---|---|---|
HotelRoom.bed | Optional (Recommended) | bed | 住宿中所含床位的类型以及 人数。 支持的值如下:
|
HotelRoom.occupancy | Optional (Recommended) | QuantitativeValue | 酒店客房的房客人数。入住人数类型是
|
containsPlace | Optional (Recommended) | LocationFeatureSpecification | 它用于注释与特定属性相关联的客房级房价 房间。此字段还可用于指定房间中的设施。 如需详细了解如何使用 |
示例
HotelRoom
下面是一个基本的客房数量和入住人数示例 规范
{
"@context": "https://schema.org",
"@type": ["HotelRoom", "Product"],
"name": "Deluxe Room, 1 King Bed",
"identifier": "hotel-room-id-1234",
"bed": [
{
"@type": "BedDetails",
"numberOfBeds": 1,
"typeOfBed": "KING"
},
{
"@type": "BedDetails",
"numberOfBeds": 1,
"typeOfBed": "SINGLE"
}
],
"occupancy": {
"@type": "QuantitativeValue",
"value": 2
},
"offers": {
"@type": ["Offer", "LodgingReservation"],
"identifier": "rate-plan-id-of-member-rate",
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1222.74,
"priceCurrency": "USD"
}
}
}
Hotel 和 HotelRoom
以下示例展示了如何为 Hotel
和 HotelRoom
添加注解
属性以及 bed
、occupancy
和 priceSpecification
。
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "hotel-name",
"identifier": "hotel-id-1234",
"containsPlace": {
"@type": ["HotelRoom", "Product"],
"name": "Deluxe Room, 1 King Bed",
"identifier": "hotel-room-id",
"bed": {
"@type": "BedDetails",
"numberOfBeds": 1,
"typeOfBed": "KING"
},
"occupancy": {
"@type": "QuantitativeValue",
"value": 2
},
"amenityFeature": {
"@type": "LocationFeatureSpecification",
"name": "Minibar",
"value": true
},
"offers": {
"@type": ["Offer", "LodgingReservation"],
"identifier": "rate-plan-id-of-member-rate",
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1222.74,
"priceCurrency": "USD"
}
}
}
}
HotelRoom priceSpecification
个房源
酒店房价规范与酒店价格规范类似。
不同之处在于,客房价格是使用 Product.offers
属性指定的
而不是 Hotel.makesOffer
属性。
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": "float",
"priceCurrency": "currency",
"priceComponent": {
"@type": "UnitPriceSpecification",
"name": "GenericTax",
"price": "float",
"priceCurrency": "currency"
}
...
}
语法
酒店客房的 priceSpecification
属性使用以下语法:
JSON-LD
{
"@context": "https://schema.org",
"@type": ["HotelRoom", "Product"],
...
"bed": {
"@type": "BedDetails",
"numberOfBeds": "integer",
"typeOfBed": "KING"
},
"occupancy": {
"@type": "QuantitativeValue",
"value": "integer"
},
"offers": {
"@type": ["Offer", "LodgingReservation"],
...
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": "float",
"priceCurrency": "currency",
"priceComponent": [
{
"@type": "UnitPriceSpecification",
"name": "",
"price": "float",
"priceCurrency": "currency"
},
{
"@type": "UnitPriceSpecification",
"name": "GenericTax",
"price": "float",
"priceCurrency": "currency",
"priceComponentType": "GenericTax"
},
{
"@type": "UnitPriceSpecification",
"name": "Discount",
"price": "float",
"priceCurrency": "currency",
"priceComponentType": "Discount"
}
]
}
}
}
属性
以下是 HotelRoom priceSpecification
属性:
属性 | 是否必需? | 类型 | 说明 |
---|---|---|---|
Hotel.Offer.priceSpecification.price | Required | float | 每间客房的价格,包括
您的着陆页上应始终标注 Google 费率以及 提供完整的房价详情通过注释费率详情 价格准确性检查。Google 接受酒店级和客房级两种费用 价格。 |
Hotel.Offer.priceSpecification.priceCurrency | Required | currency | 指定价格的货币代码,由三个字母组成。例如:"USD"
。 |
Hotel.Offer.priceSpecification.priceComponent | Optional | UnitPriceSpecification[] | 酒店总价的明细(包括酒店税费和其他费用)
客房和入住人数与
|
示例
客房总价
下面是一个基本示例,介绍了如何针对不同长度的 住宿价格和每人入住价格。
{
"@context": "https://schema.org",
"@type": ["HotelRoom", "Product"],
"name": "Deluxe Room King, 1 Single Bed",
"identifier": "hotel-room-id-1234",
"bed": [
{
"@type": "BedDetails",
"numberOfBeds": 1,
"typeOfBed": "KING"
},
{
"@type": "BedDetails",
"numberOfBeds": 1,
"typeOfBed": "SINGLE"
}
],
"occupancy": {
"@type": "QuantitativeValue",
"value": 2
},
"offers": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1232.74,
"priceCurrency": "USD"
}
},
...
}
房价明细
以下是每个房间或方案的价格示例。价格明细
定义了房间类型,例如 Deluxe
房间以及 bed
和 occupancy
例如 KING
和 SINGLE
张床以及 2 人入住。
{
"@context": "https://schema.org",
"@type": ["HotelRoom", "Product"],
"name": "Deluxe Room King, 1 Single Bed",
"identifier": "hotel-room-id-1234",
"offers": {
"@type": ["Offer", "LodgingReservation"],
"identifier": "rate-plan-id-of-member-rate",
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"bed": [
{
"@type": "BedDetails",
"numberOfBeds": 1,
"typeOfBed": "KING"
},
{
"@type": "BedDetails",
"numberOfBeds": 1,
"typeOfBed": "SINGLE"
}
],
"occupancy": {
"@type": "QuantitativeValue",
"value": 2
},
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1222.74,
"priceCurrency": "USD",
"priceComponent": [
{
"@type": "UnitPriceSpecification",
"name": "Base rate",
"price": 1150,
"priceCurrency": "USD"
},
{
"@type": "UnitPriceSpecification",
"name": "GenericTax",
"price": 172.74,
"priceCurrency": "USD",
"priceComponentType": "GenericTax"
},
{
"@type": "UnitPriceSpecification",
"name": "Discount",
"price": -100,
"priceCurrency": "USD",
"priceComponentType": "Discount"
}
]
}
}
}
includesObject
个房源
此属性用于为酒店中提供的特定房价服务添加注释
例如餐饮和代客泊车服务。您可以添加注释
Hotel
或 HotelRoom
属性中的 includesObject
。
{
"includesObject": [
{
"@type": "TypeAndQuantityNode",
"typeOfGood": {
"@type": "Service",
"name": "Valet"
}
},
{
"@type": "TypeAndQuantityNode",
"amountOfThisGood": "float",
"unitText": "currency",
"typeOfGood": {
"@type": "FoodService",
"name": "MealCredit"
}
}
]
}
语法
对于特定于费率的服务,includesObject
采用以下语法
会议室:
JSON-LD
{
"@context": "https://schema.org",
...
"@type": ["HotelRoom", "Product"],
...
"offers": {
"@type": ["Offer", "LodgingReservation"],
...
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": "float",
"priceCurrency": "currency"
},
"includesObject": [
{
"@type": "TypeAndQuantityNode",
"typeOfGood": {
"@type": "Service",
"name": "Valet"
}
},
{
"@type": "TypeAndQuantityNode",
"amountOfThisGood": "float",
"unitText": "currency",
"typeOfGood": {
"@type": "FoodService",
"name": "MealCredit"
}
}
]
}
}
属性
includesObject
具有以下属性:
属性 | 是否必需? | 类型 | 说明 |
---|---|---|---|
Offer.includesObject | Optional | TypeAndQuantityNode | 酒店或客房提供的服务。 房价专用功能包含在
基本级别的优惠中也可能包含针对具体价格的功能 或指定为额外收费的附加服务。
|
示例
服务
以下是针对代客泊车费率的专用功能的基本示例
和餐饮服务。特定于费率的功能应使用
"Offer.includesObject"
属性。此页面上的名称字段
"TypeAndQuantityNode.typeOfGood"
用于指明
服务。
{
"@context": "https://schema.org",
"@type": ["HotelRoom", "Product"],
"name": "Deluxe Room, 1 King Bed",
"identifier": "hotel-room-id-1234",
"offers": {
"@type": ["Offer", "LodgingReservation"],
"identifier": "rate-plan-id-of-member-rate",
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1222.74,
"priceCurrency": "USD"
},
"includesObject": [
{
"@type": "TypeAndQuantityNode",
"typeOfGood": {
"@type": "Service",
"name": "Valet"
}
},
{
"@type": "TypeAndQuantityNode",
"amountOfThisGood": 50,
"unitText": "USD",
"typeOfGood": {
"@type": "FoodService",
"name": "MealCredit"
}
}
]
}
}
availability
个房源
offer.availability
属性用于为已售罄的行程添加注解
酒店客房。
"offers": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "YYYY-MM-DD[THH:mm:ss]",
"checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
"availability": "https://schema.org/SoldOut"
}
语法
availability
属性采用以下语法:
JSON-LD
{
"@context": "https://schema.org",
...
"@type": ["HotelRoom", "Product"],
"name": "room-type",
"identifier": "hotel-room-id-1234",
"bed": {
"@type": "BedDetails",
"numberOfBeds": "integer",
"typeOfBed": "KING"
},
"occupancy": {
"@type": "QuantitativeValue",
"value": "integer"
},
"offers": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "YYYY-MM-DD[THH:mm:ss]",
"checkoutTime": "YYYY-MM-DD[THH:mm:ss]",
"availability": "https://schema.org/SoldOut"
}
}
属性
以下是 availability
属性:
属性 | 是否必需? | 类型 | 说明 |
---|---|---|---|
Offer.availability | Optional | ItemAvailability | 酒店或客房的空房情况。 房价提取自
不含
|
示例
可用性
以下是显示酒店客房不可用的基本示例。您 应包含床位类型、床位数和入住人数详细信息 指定房间
{
"@context": "https://schema.org",
"@type": ["HotelRoom", "Product"],
"name": "Deluxe Room, 1 King Bed",
"identifier": "hotel-room-id-1234",
"bed": [
{
"@type": "BedDetails",
"numberOfBeds": 1,
"typeOfBed": "KING"
},
{
"@type": "BedDetails",
"numberOfBeds": 1,
"typeOfBed": "SINGLE"
}
],
"occupancy": {
"@type": "QuantitativeValue",
"value": 2
},
"offers": {
"@type": ["Offer", "LodgingReservation"],
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"availability": "https://schema.org/SoldOut",
"priceSpecification": {...}
}
}
amenityFeature
个房源
可以使用 Hotel
或 HotelRoom
类型指定设施
amenityFeature
属性。您应使用 containsPlace
属性来指定
客房内提供的设施。
{
"@type": "Hotel",
"amenityFeature": [
{
"@type": "LocationFeatureSpecification",
"name": "HotTub",
"hoursAvailable": {
"@type": "OpeningHoursSpecification",
"opens": "HH:mm:ss",
"closes": "HH:mm:ss"
}
},
{
"@type": "LocationFeatureSpecification",
"name": "GymFitnessEquipment",
"value": "boolean"
}
],
"containsPlace": {
"@type": "HotelRoom",
"amenityFeature": [
{
"@type": "LocationFeatureSpecification",
"name": "Minibar",
"value": true
},
{
"@type": "LocationFeatureSpecification",
"name": "Smoking",
"value": false
}
]
}
}
语法
amenityFeature
和 containsPlace
属性具有以下属性:
语法:
JSON-LD
{
"@context": "https://schema.org",
"@type": "Hotel",
...
"amenityFeature": {
"@type": "LocationFeatureSpecification",
"name": "HotTub",
"hoursAvailable": {
"@type": "OpeningHoursSpecification",
"opens": "HH:mm:ss",
"closes": "HH:mm:ss"
}
},
"containsPlace": {
"@type": "HotelRoom",
"amenityFeature": {
"@type": "LocationFeatureSpecification",
"name": "Minibar",
"value": "boolean"
}
}
}
设施
name
属性中允许使用并定义了以下设施。
属性 | 是否必需? | 类型 | 说明 |
---|---|---|---|
amenityFeature.AC | Optional | boolean | 房源是否有空调。 |
amenityFeature.AirportShuttle | Optional | boolean | 托管是否提供往返机场的交通服务? 其他终端。 |
amenityFeature.Balcony | Optional | boolean | 住宿是否设有阳台。 |
amenityFeature.BeachAccess | Optional | boolean | 房源是否可通往房源附近的公共海滩。 |
amenityFeature.ChildFriendly | Optional | boolean | 房源是否适合儿童。 |
amenityFeature.Crib | Optional | boolean | 房源是否提供婴儿床。 |
amenityFeature.Elevator | Optional | boolean | 房源是否有电梯。 |
amenityFeature.FirePlace | Optional | boolean | 住宿是否配有壁炉。 |
amenityFeature.FreeBreakfast | Optional | boolean | 酒店是否为所有房客提供免费早餐。使用 房价功能,用于指明是否仅包含特定房价的早餐 方案。 |
amenityFeature.GymFitnessEquipment | Optional | boolean | 房源是否有健身房或任何健身器材。 |
amenityFeature.Heating | Optional | boolean | 住宿是否供暖。 |
amenityFeature.HotTub | Optional | boolean | 房源是否有热水浴缸。 |
amenityFeature.InstantBookable | Optional | boolean | 酒店是否可在结账时立即预订 过程。备选方案正在等待批准。 |
amenityFeature.IroningBoard | Optional | boolean | 房源是否提供熨衣板。 |
amenityFeature.Kitchen | Optional | boolean | 住宿是否设有厨房。 |
amenityFeature.Microwave | Optional | boolean | 住宿是否提供微波炉。 |
amenityFeature.OpenAirBath(Hotels only) | Optional | boolean | 住宿是否连接露天浴池。如果指定 在房间楼层,洗手间应仅供客房入住使用。 |
amenityFeature.OutdoorGrill | Optional | boolean | 房源是否有烧烤架。 |
amenityFeature.OvenStove | Optional | boolean | 房源是否有炉子。 |
amenityFeature.Patio | Optional | boolean | 房源是否有露台。 |
amenityFeature.Pool | Optional | boolean | 住宿是否设有泳池。 |
amenityFeature.PrivateBeachAccess | Optional | boolean | 房源是否有专属非公共海滩。 |
amenityFeature.SelfCheckinCheckout | Optional | boolean | 房源是否支持自助入住和退房。 |
amenityFeature.WasherDryer | Optional | boolean | 住宿是否配有洗衣机。 |
amenityFeature.Wifi | Optional | boolean | 房源是否有 Wi-Fi。 |
amenityFeature.Smoking | Optional | boolean | 住宿地点是否允许吸烟。 |
amenityFeature.InternetType | Optional | Enum | 房源可用的互联网类型。 支持的值包括:
|
amenityFeature.ParkingType | Optional | Enum | 酒店内可用的停车位类型。 支持的值包括:
|
amenityFeature.PoolType | Optional | Enum | 房源上可用的泳池类型。 支持的值包括:
|
amenityFeature.RoomStyle | Optional | Enum | 指明房间是否采用日式风格。 支持的值包括:
|
amenityFeature.LicenseNum | Required | string | 要在物业上显示的商家的许可证号
特定区域。它可以重复,如果有多个
则建议您添加
许可。例如 |
属性
以下是 amenityFeature
属性:
属性 | 是否必需? | 类型 | 说明 |
---|---|---|---|
amenityFeature | Optional | LocationFeatureSpecification | 酒店或客房提供的设施。您可以指定
使用 可在 |
containsPlace | Optional | LocationFeatureSpecification | 酒店或客房内面向所有酒店房客提供的设施。它
可以使用
|
示例
酒店及客房设施
下例中的酒店配有游泳池,从上午 10 点营业到晚上 10 点 而且没有健身房可用酒店客房无烟 并设有迷你吧。
{
"@context": "https://schema.org",
"@type": "Hotel",
"name": "ACME Hotel",
"address": { ... },
"amenityFeature": [
{
"@type": "LocationFeatureSpecification",
"name": "HotTub",
"hoursAvailable": {
"@type": "OpeningHoursSpecification",
"opens": "10:00:00",
"closes": "22:00:00"
}
},
{
"@type": "LocationFeatureSpecification",
"name": "GymFitnessEquipment",
"value": false
}
],
"containsPlace": {
"@type": "HotelRoom",
"amenityFeature": [
{
"@type": "LocationFeatureSpecification",
"name": "Minibar",
"value": true
},
{
"@type": "LocationFeatureSpecification",
"name": "Smoking",
"value": false
}
],
"offers": {
"@type": ["Offer", "LodgingReservation"],
"identifier": "rate-plan-id-of-member-rate",
"checkinTime": "2023-03-10 15:00:00",
"checkoutTime": "2023-03-16 10:00:00",
"priceSpecification": {
"@type": "CompoundPriceSpecification",
"price": 1222.74,
"priceCurrency": "USD"
}
}
}
}