属性

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

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

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

  • 必需的 XML 子元素：id、name、latitude、longitude、address。
  • 必需属性：capacity 和 website。请参阅民宿直接链接 。这样，用户就有机会访问相应媒体资源 网站。

有关必需的 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 商家信息的服务水平是否在某种程度上特别。 例如 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 由 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>