Trang này trình bày nội dung mô tả, giá trị và yêu cầu đối với các thuộc tính cũng như phần tử con. Các giá trị này chỉ áp dụng cho các cơ sở lưu trú Nhà nghỉ dưỡng cho thuê.
Cấu trúc XML chung có định dạng tương tự như nguồn cấp dữ liệu về trang thông tin khách sạn. Vui lòng xem Tài liệu tham khảo về tệp XML về danh sách khách sạn.
Việc không thêm các mục bắt buộc sau đây sẽ tự động vô hiệu hoá trang thông tin:
- Phần tử con bắt buộc phải có XML:
id
,name
,latitude
,longitude
,address
. - Thuộc tính bắt buộc:
capacity
vàwebsite
. Tham khảo Đường liên kết trực tiếp đến nhà/căn hộ du lịch trong nguồn cấp dữ liệu về trang thông tin. Nhờ đó, người dùng có cơ hội truy cập vào trang web của cơ sở lưu trú.
Để biết thông tin chi tiết về các phần tử con XML bắt buộc, hãy tham khảo Phần tử con XML.
Để biết thêm thông tin về nhà nghỉ dưỡng cho thuê, hãy tham khảo bài viết Các thuộc tính dành riêng cho nhà nghỉ dưỡng cho thuê.
Cuối cùng, khi dựa trên các nguồn khác, Google xác định rằng giá trị của một thuộc tính khác với giá trị được chỉ định trong nguồn cấp dữ liệu của trang thông tin về nhà nghỉ dưỡng cho thuê, Google sẽ cho thấy giá trị của trang thông tin. Ví dụ: Nếu dựa trên ảnh của trang thông tin, Google xác định rằng trang thông tin có bếp, nhưng không có thuộc tính kitchen
hoặc được đặt là No
, thì Google sẽ coi trang thông tin đó là có bếp. Những thuộc tính này được gọi là "thuộc tính suy luận" và chỉ xuất hiện khi có độ tin cậy cao về độ chính xác của suy luận.
Giá trị cho phần giữ chỗ attribute_name
Bảng sau đây cung cấp danh sách các giá trị hợp lệ cho attribute_name
trong phần tử <client_attr name="attribute_name">
. Tuy nhiên, bạn nên cung cấp thêm attribute_name
nếu có.
Giá trị cho attribute_name |
Bắt buộc? | Nội dung mô tả | Giá trị nội dung hợp lệ |
---|---|---|---|
capacity | Required | Số lượng khách tối đa mà khách sạn có thể phục vụ. Giá trị này phải bằng hoặc lớn hơn "number_of_phòng ngủ". | Non-negative integer value |
website | Required | URL của trang web cho cơ sở lưu trú. | Free text |
partner_hygiene_link | Strongly recommended | Đường liên kết đến trang web của đối tác bên ngoài để cung cấp thêm thông tin về vấn đề vệ sinh của cơ sở lưu trú. | Free text (the site's URL) |
number_of_bathrooms | Strongly recommended | Số lượng phòng tắm. | Non-negative float value, for example, 1, 1.5, 2 |
number_of_bedrooms | Strongly recommended | Số lượng phòng ngủ. | Non-negative integer value |
number_of_beds | Strongly recommended | Số giường trong tất cả phòng. | Non-negative integer value |
self_checkin_checkout | Recommended | Cơ sở lưu trú có cho phép tự nhận phòng và trả phòng hay không. | Yes/No/Unknown |
rating | Strongly recommended | Số thực thể hiện điểm xếp hạng tổng hợp của cơ sở lưu trú. Số này thường là từ 0 đến 5, 0 đến 10 hoặc 0 đến 100. Tuy nhiên, bạn có thể sử dụng bất kỳ phạm vi nào đại diện cho hệ thống xếp hạng của mình. | Non-negative float value |
rating_num | Strongly recommended | Số lượng điểm xếp hạng mà cơ sở lưu trú nhận được. | Non-negative integer value |
rating_scale | Strongly recommended | Điểm xếp hạng tối đa có thể cho một cơ sở lưu trú | Non-negative integer value |
instant_bookable | Strongly recommended | Cơ sở lưu trú có cho đặt phòng ngay tức thì thông qua quy trình trả phòng hay không. Một phương thức khác là chờ phê duyệt. | Yes/No/Unknown |
description | Strongly recommended | Văn bản dạng tự do mô tả những đặc điểm độc đáo của cơ sở lưu trú | Free text |
category | Strongly recommended | Loại bất động sản, chẳng hạn như biệt thự, nhà bungalow, nhà gỗ nhỏ hoặc căn hộ | Free text |
ac | Recommended | Cơ sở lưu trú có máy điều hoà không khí hay không. | Yes/No/Unknown |
beach_access | Recommended | Cơ sở lưu trú có lối ra bãi biển công cộng gần cơ sở lưu trú hay không. | Yes/No/Unknown |
check_in_time | Recommended | Thời gian chính xác trong ngày để nhận phòng tại cơ sở lưu trú. Chấp nhận định dạng HHMM, HH:MM hoặc HH:MM:SS; ví dụ: sử dụng định dạng 14:00 thay vì 2:00 CH hoặc 2:00 CH. Mọi định dạng khác sẽ không được phân tích cú pháp hoặc hiển thị. | Time |
check_out_time | Recommended | Thời gian chính xác trong ngày để trả phòng tại cơ sở lưu trú. Chấp nhận định dạng HHMM, HH:MM hoặc HH:MM:SS; ví dụ: sử dụng định dạng 11:00 thay vì 11:00 hoặc 11:00 sáng. Mọi định dạng khác sẽ không được phân tích cú pháp hoặc hiển thị. | Time |
child_friendly | Recommended | Cơ sở lưu trú có phù hợp với trẻ em hay không. | Yes/No/Unknown |
crib | Recommended | Cơ sở lưu trú có giường cũi cho trẻ em hay không. | Yes/No/Unknown |
elevator | Recommended | Cơ sở lưu trú có thang máy hay không. | Yes/No/Unknown |
gym_fitness_equipment | Recommended | Cơ sở lưu trú có phòng tập thể dục hoặc thiết bị tập thể dục hay không. | Yes/No/Unknown |
heating | Recommended | Cơ sở lưu trú có hệ thống sưởi ấm hay không. | Yes/No/Unknown |
hot_tub | Recommended | Cơ sở lưu trú có bồn tắm nước nóng hay không. | Yes/No/Unknown |
ironing_board | Recommended | Cơ sở lưu trú có bàn là hay không. | Yes/No/Unknown |
kitchen | Recommended | Cơ sở lưu trú có khu bếp hay không. | Yes/No/Unknown |
microwave | Recommended | Cơ sở lưu trú có lò vi sóng hay không. | Yes/No/Unknown |
min_days_advance_purchase | Recommended | Số ngày tối thiểu để đặt phòng trước cơ sở lưu trú. | Non-negative integer value |
min_night_stay | Recommended | Số đêm tối thiểu mà khách có thể đặt phòng tại cơ sở lưu trú. | Positive integer (more than zero) |
max_night_stay | Recommended | Số đêm tối đa mà khách có thể đặt phòng tại cơ sở lưu trú. | Positive integer (more than zero) |
outdoor_grill | Recommended | Cơ sở lưu trú có bếp nướng hay không. | Yes/No/Unknown |
oven_stove | Recommended | Cơ sở lưu trú có bếp nấu hay không. | Yes/No/Unknown |
parking_type | Recommended | Loại bãi đỗ xe trong cơ sở lưu trú. | Free/Paid/None |
patio | Recommended | Cơ sở lưu trú có sân hiên hay không. | Yes/No/Unknown |
pets_allowed | Recommended | Một số hoặc tất cả các phòng cho phép khách mang theo thú cưng (chó hoặc mèo) không phải động vật phục vụ. | Yes/No/Unknown |
pool_type | Recommended | Loại bể bơi (lối ra bể bơi) tại cơ sở lưu trú. | Indoors, Outdoors, Indoors/Outdoors, None |
smoking_free_property | Recommended | Cơ sở lưu trú có cho phép hút thuốc hay không. | Yes/No/Unknown |
special_service_level | Recommended | Liệu cấp dịch vụ của danh sách có đặc biệt theo một cách nào đó hay không.
Ví dụ: verified , luxury , premium |
Yes/No/Unknown |
square_footage | Recommended | Diện tích của bất động sản tính theo feet vuông. | Non-negative float value |
square_meters | Recommended | Diện tích của bất động sản tính bằng mét vuông. | Non-negative float |
tv | Recommended | Cơ sở lưu trú có TV hay không. | Yes/No/Unknown |
washer_dryer | Recommended | Cơ sở lưu trú có máy giặt hay không. | Yes/No/Unknown |
wheelchair_accessible | Recommended | Cơ sở lưu trú có lối đi cho xe lăn hay không. | Yes/No/Unknown |
internet_type | Recommended | Loại hình truy cập Internet Wi-Fi do cơ sở lưu trú cung cấp. | Free/Paid/None |
airport_shuttle | Optional | Cơ sở lưu trú có cung cấp dịch vụ đưa đón sân bay hoặc các nhà ga khác hay không. | Yes/No/Unknown |
balcony | Optional | Cơ sở lưu trú có ban công hay không. | Yes/No/Unknown |
fire_place | Optional | Cơ sở lưu trú có lò sưởi hay không. | Yes/No/Unknown |
free_breakfast | Optional | Cơ sở lưu trú có phục vụ bữa sáng miễn phí hay không. | Yes/No/Unknown |
host_description | Optional | Nội dung mô tả về chủ nhà nghỉ dưỡng cho thuê. | Free text |
host_language | Optional | Những ngôn ngữ mà người tổ chức có thể sử dụng. | Danh sách mã ngôn ngữ được phân tách bằng dấu phẩy; ví dụ: de , en |
host_name | Optional | Tên của chủ nhà/căn hộ du lịch. | Free text |
host_response_rate | Optional | Tỷ lệ phản hồi trung bình của máy chủ lưu trữ. | Non-negative float value, for example, 1, 0.75, 0.5 |
host_response_time | Optional | Thời gian phản hồi trung bình của máy chủ lưu trữ. | Free text |
license_num | Optional | Cơ sở lưu trú ở một số khu vực nhất định trên thế giới bắt buộc phải hiển thị số giấy phép (dành cho khách du lịch hoặc doanh nghiệp). Số giấy phép có thể lặp lại và nếu có nhiều giấy phép, bạn nên thêm cơ quan cấp giấy phép để làm rõ bối cảnh; ví dụ: " Paris: 123456ABC". | Free text |
number_of_half_bathrooms | Optional | Số phòng tắm có 1/2 phòng tắm. | Non-negative integer value |
number_of_living_rooms | Optional | Số phòng khách. | Non-negative integer value |
private_beach_access | Optional | Cơ sở lưu trú có lối đi riêng dẫn ra bãi biển dành riêng cho khách lưu trú hay không. | Yes/No/Unknown |
refund_policy | Optional | Chính sách hoàn tiền cho cơ sở lưu trú. | Free text |
Phần tử con XML
Các phần tử con XML sau đây là bắt buộc:
Phần tử con | Bắt buộc? | Loại | Nội dung mô tả |
---|---|---|---|
<country> | Strongly recommended | string | Quốc gia nơi đặt trang thông tin này. Giá trị phải là mã quốc gia gồm 2 chữ cái theo ISO 3116; ví dụ: Hoa Kỳ là US và Canada là CA : <country>US</country> |
<id> | Required | string | Giá trị nhận dạng duy nhất của cơ sở lưu trú. Xin lưu ý rằng mỗi nhà/căn hộ du lịch phải có một mã nhận dạng duy nhất trên trang web của bạn và không bao giờ được sử dụng lại mã này. |
<latitude> | Required | float | Vĩ độ tương ứng với vị trí của trang thông tin. Ví dụ: <latitude>37.423738</latitude> Bạn có thể tạo giá trị này bằng các công cụ Mã hoá địa lý như API Google Maps. |
<longitude> | Required | float | Kinh độ tương ứng với vị trí của trang thông tin. Ví dụ: <longitude>-122.090101</longitude> Bạn có thể tạo giá trị này bằng các công cụ Mã hoá địa lý như API Google Maps. |
<name> | Required | string | Tên của cơ sở lưu trú. Tối đa 300 ký tự. |
<address> | Required | Object or string | Vị trí thực tế đầy đủ của cơ sở lưu trú. Phần tử này có một thuộc tính duy nhất là Ít nhất, bạn phải cung cấp địa chỉ đường phố, thành phố, tiểu bang hoặc khu vực và mã bưu chính của cơ sở lưu trú. Sử dụng các phần tử con
Ví dụ: <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> Ngoài ra, bạn có thể cung cấp địa chỉ "theo mẫu tuỳ ý", mặc dù bạn không nên làm như vậy. Ví dụ: <address>6 Elm Ave Unit 3, Boston, MA, 02472</address> Xin lưu ý rằng các địa chỉ hòm thư hoặc các địa chỉ chỉ nhận thư không được coi là địa chỉ thực tế đầy đủ. |
Ví dụ về trang thông tin về nhà nghỉ dưỡng cho thuê
<?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>