屬性

本頁面說明屬性和子元素的說明、值和規定。這些值僅適用於度假民宿房源。

一般 XML 結構採用與飯店房源資訊動態饋給類似的格式。請參閱飯店清單 XML 參考資料。

如未加入下列必要項目，產品資訊將自動停用。

  • 必要的 XML 子元素：id、name、latitude、longitude、address。
  • 必要屬性：capacity 和 website。

如要進一步瞭解必要的 XML 子元素，請參閱 XML 子元素。

如要進一步瞭解度假民宿，請參閱度假民宿的專用屬性。

最後，如果 Google 透過其他來源判定屬性的值與度假民宿商家資訊中的值不同，我們就會顯示房源資訊的值。舉例來說，如果系統根據商家資訊相片判定設有廚房，但 kitchen 屬性不存在或設為 No，我們就會將商家資訊視為設有廚房。這些屬性稱為「推測屬性」，只有在我們確信推論能夠準確無誤時才會顯示。

屬性名稱預留位置的值

此表格提供 <client_attr name="attribute_name"> 元素中 attribute_name 的有效值清單。不過，我們建議合作夥伴提供他們可能擁有的任何其他 attribute_name。

attribute_name 的值 必填與否 說明 有效內容值
capacity Required 房源可容納的房客人數上限。這個值應大於或等於「number_of_rooms」。 Non-negative integer
website Required 資源的網站網址。 Free text
min_days_between_stays Optional (strongly recommended) 前一個乘客離開後，租借項目的「緩衝天數」下限必須留空。 Non-negative integer
enhanced_cleaning_practices Optional (strongly recommended) 房源是否採用強化的清潔方式，並在合作夥伴網站上附上說明。 Yes/No/Unknown
partner_hygiene_link Optional (strongly recommended) 連結至外部合作夥伴網站，提供與房源資訊健全度詳細資料相關的詳情。 Free text (the site's URL)
number_of_bathrooms Optional (strongly recommended) 浴室數量。 Non-negative float value, for example, 1, 1.5, 2
number_of_bedrooms Optional (strongly recommended) 臥室數量。 Non-negative integer value
number_of_beds Optional (strongly recommended) 所有客房內的床數。 Non-negative integer value
self_checkin_checkout Optional (strongly recommended) 房源是否允許使用者自行入住和退房。 Yes/No/Unknown
rating Optional (strongly recommended) 代表匯總屬性評分的浮點數。這個數字通常是 0-5、0-10 或 0-100，但您可以使用任何代表評分系統的範圍。 Non-negative float value
rating_num Optional (strongly recommended) 房源獲得的評分次數。 Non-negative integer
ac Optional 資源是否有空調。 Yes/No/Unknown
airport_shuttle Optional 主機是否提供機場或其他航廈的載客服務。 Yes/No/Unknown
balcony Optional 資源是否有陽台。 Yes/No/Unknown
beach_access Optional 指出房源是否能存取鄰近的公共海灘。 Yes/No/Unknown
check_in_time Optional 入住房源的確切時間。系統接受 HHMM、HH:MM 或 HH:MM:SS 格式。例如，請使用 14:00，而不要使用 2pm 或 2:00pm。系統不會剖析或顯示所有其他格式。 Time
check_out_time Optional 物業退房的確切時間。系統接受 HHMM、HH:MM 或 HH:MM:SS 格式，例如應使用 11:00 而非 11:00 或 11:00am。系統不會剖析或顯示所有其他格式。 Time
child_friendly Optional 資源是否適合兒童。 Yes/No/Unknown
crib Optional 資源是否提供嬰兒床。 Yes/No/Unknown
elevator Optional 資源是否有電梯。 Yes/No/Unknown
fire_place Optional 資源是否有壁爐。 Yes/No/Unknown
free_breakfast Optional 飯店是否供應免費早餐。 Yes/No/Unknown
gym_fitness_equipment Optional 房源是否有健身房或任何健身器材。 Yes/No/Unknown
heating Optional 資源是否有暖氣。 Yes/No/Unknown
hot_tub Optional 資源是否有熱水浴缸。 Yes/No/Unknown
instant_bookable Optional 房源是否可透過結帳程序立即預訂。替代方案正在等待核准。 Yes/No/Unknown
ironing_board Optional 資源是否提供熨衣板。 Yes/No/Unknown
kitchen Optional 資源是否有廚房。 Yes/No/Unknown
license_num Optional 在世界上特定區域的物業中，必須出示執照號碼 (旅遊或公司)。您可以重複使用這些執照，如果存在多個執照，建議加入授權授權來提供背景資訊，例如：「巴黎：123456ABC」。 Free text
microwave Optional 資源是否有微波爐。 Yes/No/Unknown
minimum_days_advance_purchase Optional 最早可預訂房源的最短天數。 Non-negative integer
minimum_night_stay Optional 房客可訂房的最短天數。 Positive integer (more than zero)
max_night_stay Optional 房客預訂房源的住宿晚數上限。 Positive integer (more than zero)
number_of_living_rooms Optional 客廳數量。 Non-negative integer value
outdoor_grill Optional 資源是否有燒烤架。 Yes/No/Unknown
oven_stove Optional 房源是否有爐具。 Yes/No/Unknown
parking_type Optional 飯店內提供的停車位類型。 Free/Paid/None
patio Optional 資源是否有露台。 Yes/No/Unknown
pets_allowed Optional 部分或所有客房可讓房客攜帶非服務動物的寵物 (狗或貓)。 Yes/No/Unknown
pool_type Optional 資源擁有的集區類型 (集區存取權)。 Indoors, Outdoors, Indoors/Outdoors, None
private_beach_access Optional 資源是否擁有專屬的非公共海灘。 Yes/No/Unknown
room_type Optional 與 Google 共用的資源類型。

注意：目前只接受整個地點。

 Entire Place, Shared room, Private Room
smoking_free_property Optional 房源是否禁菸。 Yes/No/Unknown
square_footage Optional 房源面積，以平方英尺。 Non-negative float value
square_meters Optional 房源面積 (以平方公尺為單位)。 Non-negative float
tv Optional 資源是否有電視。 Yes/No/Unknown
washer_dryer Optional 資源是否提供洗衣機。 Yes/No/Unknown
wheelchair_accessible Optional 資源是否提供無障礙設施。 Yes/No/Unknown
internet_type Optional 資源提供的 Wi-Fi 網際網路連線類型。 Free/Paid/None
host_language Optional 主持人使用的語言。 以半形逗號分隔的語言代碼清單，例如：de、en

XML 子元素

必須提供下列 XML 子元素：

子元素 必填與否 類型 說明
<country> Optional (strongly recommended) string 這個商家資訊所在的國家/地區。這個值必須是由 2 個大寫字母構成的 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

房源的完整實際地點。

這個元素採用單一屬性 format，您必須將該屬性設為 simple。

您至少必須提供房源的街道地址、城市、州/省或區域，以及郵遞區號。請使用 <component> 子元素來說明地址的下列各個部分：

  • addr1：房源的主要街道地址。
  • addr2：必要時，包含次要街道地址，包含門牌號碼。
  • addr3：街道地址的第三部分，如有必要，包括門牌號碼。
  • city：房源所在城市的名稱。
  • province：房源的州、區域或省的名稱。
  • postal_code：屬性的郵遞區號。

例如：

<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="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="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="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="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="smoking_free_property">Yes</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>