属性

本页将介绍属性和 子元素。这些值仅适用于民宿房源。

常规 XML 结构与酒店商家信息 Feed 的格式类似。请参阅 酒店列表 XML 参考文件

如果未能包含以下必需项,系统将自动停用 商家信息:

  • 必需的 XML 子元素:idnamelatitudelongitudeaddress
  • 必需属性:capacitywebsite。请参阅民宿直接链接 。这样,用户就有机会访问相应媒体资源 网站。

有关必需的 XML 子元素的详细信息,请参阅 XML 子元素 元素

如需详细了解民宿,请参阅 民宿独有的属性

最后,如果 Google 根据其他来源确定 attribute不同于 指定了民宿商家信息 Feed 中指定的内容,Google 会显示 值。例如,如果 Google 根据商家信息的照片确定 它有厨房,但 kitchen 属性不存在或设置为 No, Google 将商家信息视为设有厨房。这些属性称为 “推断的属性”: 推理准确率降低。

attribute_name 占位符的值

下表提供了 attribute_name<client_attr 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,而不是下午 2:00 或下午 2:00。全部 其他格式将无法解析或显示。 Time
check_out_time Recommended 从酒店退房的确切时间。HHMM、HH:MM 或 HH:MM:SS 格式;例如,使用 11:00,而不是 11am 或 11:00。全部 其他格式将无法解析或显示。 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 商家信息的服务水平是否在某种程度上特别。 例如 verifiedluxurypremium 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 主持人可以使用的语言。 以逗号分隔的 语言 代码;例如:deen
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 由 2 个字母组成的国家/地区代码;例如,美国为 US 加拿大为 CA
    <country>US</country>
<id> Required string 房源的唯一标识符。请注意,每家民宿 必须具有您网站独有的 ID,并且此 ID 绝不能是 资源。
<latitude> Required float 与商家信息中所列位置对应的纬度,对于 示例:
    <latitude>37.423738</latitude>

这个值可以使用 GeoCoding 工具生成,例如 Google Maps API

<longitude> Required float 与商家信息中所列位置对应的经度,对于 示例:
    <longitude>-122.090101</longitude>

这个值可以使用 GeoCoding 工具生成,例如 Google Maps API

<name> Required string 属性的名称。最多 300 个字符。
<address> Required string or Object

属性的完整实际位置,以字符串表示。地址中必须包含街道名称和门牌号。如果不存在,则地址中应包含 plus 代码。如果适用,还必须添加公寓或单元号。

或者,您可以提供一个“复合”地址。使用 <component> 个子级 元素来描述地址的以下各个部分:

  • addr1:主要街道地址。
  • addr2:如有必要,请提供次要街道地址,包括单元号。
  • city:城市。
  • province:州、地区或省(如有必要)。
  • postal_code:邮政编码。
  • country:国家/地区。

请注意,P.O.邮箱或其他仅用于邮寄的地址 视为完整的物理地址。

以下是完整地址的示例:

<address> 6 Acacia Ave Apt. 2, Sidney, V8L 3B8, Canada</address>
<address>
  <component name="addr1">6 Acacia Ave</component>
  <component name="addr2">Apt. 2</component>
  <component name="city">Sidney</component>
  <component name="postal_code">V8L 3B8 9TQ</component>
  <component name="country">Canada</component>
</address>

以下是使用 Plus 代码的完整地址示例:

<address>84WRMJ53+HM, Sidney, V8L 3B8, Canada</address>
<address>
  <component name="addr1">84WRMJ53+HM</component>
  <component name="city">Sidney</component>
  <component name="postal_code">V8L 3B8 9TQ</component>
  <component name="country">Canada</component>
</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>