本頁面將說明屬性和子元素的說明、值和規定。這些值僅適用於度假民宿房源。
一般 XML 結構的格式與飯店房源資訊動態饋給類似。請參閱飯店清單 XML 參考資料。
如未加入下列必要項目,系統將自動停用清單:
- 必要的 XML 子元素:
id
、name
、latitude
、longitude
、address
。 - 必要屬性:
capacity
和website
。請參閱房源資訊動態饋給中的度假民宿直接連結。讓使用者能造訪房源網站。
如要進一步瞭解必要的 XML 子元素,請參閱 XML 子項元素。
如要進一步瞭解度假民宿,請參閱度假民宿專屬屬性。
最後,如果 Google 透過其他來源判定屬性值的值與度假民宿商家資訊動態饋給中指定的值不同,Google 就會顯示商家資訊的值。舉例來說,如果 Google 從商家資訊相片中判定該地點有廚房,但 kitchen
屬性不存在或設為 No
,Google 就會將這則商家資訊視為有廚房。這些屬性稱為「推測屬性」,只有在推論準確度極高時,才會顯示這些屬性。
屬性名稱預留位置的值
下表提供 <client_attr name="attribute_name">
元素中 attribute_name
的有效值清單;不過,建議您盡可能提供額外的 attribute_name
(如果有的話)。
attribute_name 的值 |
必填與否 | 說明 | 有效的內容值 |
---|---|---|---|
capacity | Required | 飯店可容納的房客人數上限。這個值應大於或等於「number_of_rooms」。 | 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,而不是 11:00 或 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 | 必須在世界各地特定區域的房源顯示執照號碼 (旅遊業者或公司)。可以是重複授權。如有多個授權,建議您新增授權授權做為背景資訊,例如「巴黎: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>