本页将介绍属性和子元素的说明、值和要求。这些值仅适用于民宿房源。
常规 XML 结构与酒店商家信息 Feed 的格式类似。请参阅酒店列表 XML 参考文档。
如果未能包含以下必需项,列表会自动停用:
- 必需的 XML 子元素:
id
、name
、latitude
、longitude
、address
。 - 必需属性:
capacity
和website
。请参阅房源 Feed 中的民宿直接链接。这样,用户就有机会访问房源网站。
如需详细了解必需的 XML 子元素,请参阅 XML 子元素。
如需详细了解民宿,请参阅民宿独有的属性。
最后,当 Google 从其他来源确定某个属性的值与在民宿商家信息 Feed 中指定的值不同时,Google 会显示该商家信息的值。例如,如果 Google 根据商家信息的照片确定它设有厨房,但 kitchen
属性不存在或设置为 No
,则 Google 会将该商家信息视为配备厨房。这些属性称为“推断属性”,只有在推断准确率非常高时才会显示。
attribute_name 占位符的值
下表列出了 <client_attr name="attribute_name">
元素中的 attribute_name
的有效值;不过,建议您提供额外的 attribute_name
(如果有)。
attribute_name 的值 |
是否必需? | 说明 | 有效的内容值 |
---|---|---|---|
capacity | Required | 酒店可容纳的房客数量上限。此值应等于或大于“卧室数量”。 | Non-negative integer value |
website | Required | 房源的网站网址。 | Free text |
partner_hygiene_link | Strongly recommended | 指向外部合作伙伴网站的链接,该网站提供了有关商家信息健全度详情的更多信息。 | Free text (the site's URL) |
number_of_bathrooms | Strongly recommended | 浴室数量。 | Non-negative float value, for example, 1, 1.5, 2 |
number_of_bedrooms | Strongly recommended | 卧室数量。 | Non-negative integer value |
number_of_beds | Strongly recommended | 所有客房的床数。 | Non-negative integer value |
self_checkin_checkout | Recommended | 房源是否允许自行入住和退房。 | Yes/No/Unknown |
rating | Strongly recommended | 表示总体房源评分的浮点数。这个数字通常介于 0-5、0-10 或 0-100 之间,但您可以使用任何能代表您的分级制度的范围。 | Non-negative float value |
rating_num | Strongly recommended | 房源获得的评分数量。 | Non-negative integer value |
rating_scale | Strongly recommended | 房源可能的最高评分 | Non-negative integer value |
instant_bookable | Strongly recommended | 在退房过程中,房源是否可立即预订。 备选方案正在等待批准。 | Yes/No/Unknown |
description | Strongly recommended | 描述房产独特特性的自由格式文本 | Free text |
category | Strongly recommended | 房产类型,如别墅、平房、小木屋或公寓 | Free text |
ac | Recommended | 房源是否有空调。 | Yes/No/Unknown |
beach_access | Recommended | 房源是否可通往附近公共海滩。 | Yes/No/Unknown |
check_in_time | Recommended | 入住酒店的确切时间。接受 HHMM、HH:MM 或 HH:MM:SS 格式;例如,使用 14:00,而不是 2pm 或 2:00pm。所有其他格式均无法解析或显示。 | Time |
check_out_time | Recommended | 从酒店退房的确切时间。接受 HHMM、HH:MM 或 HH:MM:SS 格式;例如,使用 11:00,而不是 11am 或 11:00am。所有其他格式均无法解析或显示。 | Time |
child_friendly | Recommended | 房源是否适合儿童。 | Yes/No/Unknown |
crib | Recommended | 房源是否提供婴儿床。 | Yes/No/Unknown |
elevator | Recommended | 房源是否有电梯。 | Yes/No/Unknown |
gym_fitness_equipment | Recommended | 房源是否有健身房或任何健身器材。 | Yes/No/Unknown |
heating | Recommended | 房源是否有供暖。 | Yes/No/Unknown |
hot_tub | Recommended | 房源是否有热水浴缸。 | Yes/No/Unknown |
ironing_board | Recommended | 房源是否提供熨衣板。 | Yes/No/Unknown |
kitchen | Recommended | 房源是否有厨房。 | Yes/No/Unknown |
microwave | Recommended | 房源是否有微波炉。 | Yes/No/Unknown |
min_days_advance_purchase | Recommended | 可提前预订酒店的最短天数。 | Non-negative integer value |
min_night_stay | Recommended | 房客可以预订酒店的最少住宿晚数。 | Positive integer (more than zero) |
max_night_stay | Recommended | 房客可以预订酒店的住宿晚数上限。 | Positive integer (more than zero) |
outdoor_grill | Recommended | 房源是否有烧烤架。 | Yes/No/Unknown |
oven_stove | Recommended | 房源是否有炉子。 | Yes/No/Unknown |
parking_type | Recommended | 房源提供的停车位类型。 | Free/Paid/None |
patio | Recommended | 房源是否有露台。 | Yes/No/Unknown |
pets_allowed | Recommended | 部分或全部客房允许房客携带宠物(狗或猫,非服务型动物)。 | Yes/No/Unknown |
pool_type | Recommended | 房源拥有的泳池(泳池通道)类型。 | Indoors, Outdoors, Indoors/Outdoors, None |
smoking_free_property | Recommended | 酒店是否禁止吸烟。 | Yes/No/Unknown |
special_service_level | Recommended | 商家信息的服务级别是否在某种程度上特别。
例如 verified 、luxury 、premium |
Yes/No/Unknown |
square_footage | Recommended | 房源面积(以平方英尺为单位)。 | Non-negative float value |
square_meters | Recommended | 房屋的面积(以平方米为单位)。 | Non-negative float |
tv | Recommended | 房源是否有电视。 | Yes/No/Unknown |
washer_dryer | Recommended | 房源是否提供洗衣机。 | Yes/No/Unknown |
wheelchair_accessible | Recommended | 房源是否轮椅无障碍。 | Yes/No/Unknown |
internet_type | Recommended | 酒店提供的 Wi-Fi 互联网访问类型。 | Free/Paid/None |
airport_shuttle | Optional | 主机是否提供往返机场或其他航站楼的交通服务。 | Yes/No/Unknown |
balcony | Optional | 房源是否有阳台。 | Yes/No/Unknown |
fire_place | Optional | 房源是否有壁炉。 | Yes/No/Unknown |
free_breakfast | Optional | 酒店是否提供免费早餐。 | Yes/No/Unknown |
host_description | Optional | 民宿托管方的说明。 | Free text |
host_language | Optional | 主持人可以使用的语言。 | 以英文逗号分隔的语言代码列表;例如:de , en |
host_name | Optional | 民宿托管方的名称。 | Free text |
host_response_rate | Optional | 主机的平均响应率。 | Non-negative float value, for example, 1, 0.75, 0.5 |
host_response_time | Optional | 主机的平均响应时间。 | Free text |
license_num | Optional | 必须为世界上某些地区的房源显示执照号(游客或企业)。它可以重复,如果存在多个许可,我们建议添加许可授权作为上下文,例如:“Paris: 123456ABC”。 | Free text |
number_of_half_bathrooms | Optional | 半浴室的数量。 | Non-negative integer value |
number_of_living_rooms | Optional | 客厅数量。 | Non-negative integer value |
private_beach_access | Optional | 房源是否有专属非公共海滩。 | Yes/No/Unknown |
refund_policy | Optional | 房源的退款政策。 | Free text |
XML 子元素
必须提供以下 XML 子元素:
子元素 | 是否必需? | 类型 | 说明 |
---|---|---|---|
<country> | Strongly recommended | string | 此商家信息所在的国家/地区。此值必须是两个字母的 ISO 3116 国家/地区代码;例如,美国为 US ,加拿大为 CA : <country>US</country> |
<id> | Required | string | 房源的唯一标识符。请注意,每个民宿必须具有您的网站独有的 ID,并且不得重复使用此 ID。 |
<latitude> | Required | float | 与商家信息中所列位置对应的纬度,例如:
<latitude>37.423738</latitude> 此值可使用 Google Maps API 等 GeoCoding 工具生成。 |
<longitude> | Required | float | 与商家信息中所列位置对应的经度,例如:
<longitude>-122.090101</longitude> 此值可使用 Google Maps API 等 GeoCoding 工具生成。 |
<name> | Required | string | 属性的名称。最多 300 个字符。 |
<address> | Required | Object or string | 房源的实际位置。 此元素接受单个属性 您必须至少提供该房源的街道地址、城市、州/省/自治区/直辖市或区域以及邮政编码。使用
例如: <address format="simple"> <component name="addr1">6 Acacia Ave</component> <component name="addr2">Floor 5</component> <component name="city">London</component> <component name="province">Greater London</component> <component name="postal_code">SW1W 9TQ</component> </address> 或者,您也可以提供“自由格式”地址,但我们不建议这样做。例如: <address>6 Elm Ave Unit 3, Boston, MA, 02472</address> 请注意,邮政信箱或其他仅用于邮寄的地址不属于完整的实际地址。 |
民宿商家信息示例
<?xml version="1.0" encoding="UTF-8"?> <listings> <language>en</language> <listing> <id>123456</id> <name>Apartment Name</name> <address format="simple"> <component name="addr1">18733 Clark Way</component> <component name="addr2">#C10</component> <component name="city">Mountain View</component> <component name="postal_code">94043</component> <component name="province">California</component> </address> <country>US</country> <latitude>37.4182515</latitude> <longitude>-122.0742354</longitude> <phone type="main">12345678</phone> <category>vacation_villa</category> <date day="21" month="12" year="2017"/> <content> <text type="description"> <link>https://list_url</link> <title>Description Title</title> <body>Description Body</body> </text> <review type="editorial"> <link>https://example.com/reviews/42</link> <title>A little piece of heaven</title> <author>EXAMPLE</author> <rating>8</rating> <body>This place is really good.</body> </review> <review type="user"> <link>https://exampleperson.org/reviews/82</link> <author>Susan von Trapp</author> <rating>6</rating> <body>Not a bad place, but I prefer to be closer to the beach.</body> <date day="6" month="7" year="2017"/> <servicedate day="16" month="6" year="2017"/> </review> <attributes> <website>https://hotel.example.com/123456</website> <client_attr name="capacity">7</client_attr> <client_attr name="cleaning_disinfection">Yes</client_attr> <client_attr name="min_days_between_stays">3</client_attr> <client_attr name="enhanced_cleaning_practices">Yes</client_attr> <client_attr name="partner_hygiene_link">http://www.example.com/hygiene/</client_attr> <client_attr name="number_of_bathrooms">2</client_attr> <client_attr name="number_of_bedrooms">3</client_attr> <client_attr name="number_of_beds">4</client_attr> <client_attr name="self_checkin_checkout">Yes</client_attr> <client_attr name="rating">4.8</client_attr> <client_attr name="rating_num">5373</client_attr> <client_attr name="rating_scale">5</client_attr> <client_attr name="ac">Yes</client_attr> <client_attr name="airport_shuttle">Yes</client_attr> <client_attr name="balcony">No</client_attr> <client_attr name="beach_access">Yes</client_attr> <client_attr name="check_in_time">15:00</client_attr> <client_attr name="check_out_time">11:00</client_attr> <client_attr name="child_friendly">Yes</client_attr> <client_attr name="crib">Unknown</client_attr> <client_attr name="elevator">Yes</client_attr> <client_attr name="fire_place">Unknown</client_attr> <client_attr name="free_breakfast">Yes</client_attr> <client_attr name="gym_fitness_equipment">Yes</client_attr> <client_attr name="heating">Yes</client_attr> <client_attr name="host_description">A short description about the host and their interests</client_attr> <client_attr name="host_name">The name of the host</client_attr> <client_attr name="host_language">en, da, el</client_attr> <client_attr name="host_response_rate">0.75</client_attr> <client_attr name="host_response_time">1 hour</client_attr> <client_attr name="hot_tub">Yes</client_attr> <client_attr name="instant_bookable">Yes</client_attr> <client_attr name="internet_type">Free</client_attr> <client_attr name="ironing_board">No</client_attr> <client_attr name="kitchen">Yes</client_attr> <client_attr name="license_num">Free text. If multiple licenses exist, we suggest adding authority of the licence as context</client_attr> <client_attr name="license_num">Paris: 123456ABC</client_attr> <client_attr name="microwave">Yes</client_attr> <client_attr name="max_night_stay">7</client_attr> <client_attr name="min_days_advance_purchase">2</client_attr> <client_attr name="min_night_stay">3</client_attr> <client_attr name="number_of_living_rooms">1</client_attr> <client_attr name="outdoor_grill">No</client_attr> <client_attr name="oven_stove">Yes</client_attr> <client_attr name="parking_type">Free</client_attr> <client_attr name="patio">Unknown</client_attr> <client_attr name="pets_allowed">Yes</client_attr> <client_attr name="pool_type">Indoors</client_attr> <client_attr name="private_beach_access">Unknown</client_attr> <client_attr name="room_type">Entire Place</client_attr> <client_attr name="refund_policy">The refund policy for the property</client_attr> <client_attr name="smoking_free_property">Yes</client_attr> <client_attr name="special_service_level">No</client_attr> <client_attr name="square_footage">1200</client_attr> <client_attr name="tv">Yes</client_attr> <client_attr name="washer_dryer">Yes</client_attr> <client_attr name="wheelchair_accessible">Yes</client_attr> </attributes> </content> </listing> </listings>