Trang này trình bày các thông tin mô tả, giá trị cũng như yêu cầu đối với các thuộc tính và các 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. Xem Tài liệu tham khảo về tệp XML về danh sách khách sạn.
Việc không bao gồm các mục bắt buộc sau sẽ tự động vô hiệu hoá danh sách:
- 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:
capacityvà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 trang thông tin. Nhờ đó, người dùng có cơ hội ghé thăm cơ sở lưu trú của bạn.
Để 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 Thuộc tính dành riêng cho nhà nghỉ dưỡng cho thuê.
Cuối cùng, khi Google xác định từ các nguồn khác rằng giá trị của
attribute khác với
nội dung được chỉ định trong nguồn cấp dữ liệu của trang thông tin về nhà/căn hộ du lịch, Google sẽ cho thấy
giá trị cho trang thông tin. Ví dụ: nếu Google xác định dựa trên ảnh của trang thông tin
thiết bị có nhà bếp nhưng không có thuộc tính kitchen hoặc được đặt thành No,
Google coi trang thông tin này là một nhà bếp. Những thuộc tính này được gọi là
"thuộc tính được suy luận" và chúng chỉ được hiển thị 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? | 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 "số_số_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 | Liên kết tới trang web đối tác bên ngoài cung cấp thêm thông tin về về trạng thái vệ sinh của danh sách. | 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ú. Chiến dịch này số thường là từ 0-5, 0-10 hoặc 0-100, nhưng bạn có thể sử dụng bất kỳ phạm vi nào đại diện cho hệ thống phân loại của bạn. | 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 thuộc tính này. | 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ú. HHMM, HH:MM hoặc HH:MM:SS định dạng được chấp nhận; ví dụ: sử dụng 14:00 thay vì 2 giờ chiều hoặc 2:00 chiều. Tất cả các đị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ú. HHMM, HH:MM hoặc HH:MM:SS định dạng được chấp nhận; ví dụ:sử dụng 11:00 thay vì 11 giờ sáng hoặc 11 giờ sáng. Tất cả các đị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ả phòng cho phép khách mang theo thú cưng (chó hoặc mèo) không phải là động vật phục vụ — cùng với chúng. | 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 | Thông tin về việc cơ sở lưu trú có cung cấp dịch vụ đưa đón khách đến/từ sân bay hoặc nơi khác hay không thiết bị đầu cuối. | 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 được phân tách bằng dấu phẩy
ngôn ngữ
mã; 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ú 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) ở các khu vực nhất định trên thế giới. Nó có thể được lặp lại và nếu nhiều bạn nên thêm cơ quan cấp giấy phép để làm 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 | Mô tả |
|---|---|---|---|
| <country> | Strongly recommended | string | Quốc gia nơi đặt trang thông tin này. Giá trị phải là
ISO 3116
Mã quốc gia gồm 2 chữ cái; 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à mã này không được sử dụng lại. |
| <latitude> | Required | float | Vĩ độ tương ứng với vị trí của trang thông tin. Cho
ví dụ:
<latitude>37.423738</latitude>
Giá trị này có thể được tạo 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. Cho
ví dụ:
<longitude>-122.090101</longitude>
Giá trị này có thể được tạo 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 | string or Object | Vị trí thực tế đầy đủ của cơ sở lưu trú dưới dạng chuỗi. Địa chỉ phải bao gồm tên và số nhà. Nếu không có mã này, địa chỉ phải chứa mã cộng. Bạn cũng phải thêm số căn hộ hoặc số nhà (nếu có). Ngoài ra, bạn có thể cung cấp của bạn. Sử dụng
Xin lưu ý rằng P.O. các địa chỉ hòm thư hoặc các địa chỉ chỉ nhận thư khác không được được coi là địa chỉ thực tế đầy đủ. Sau đây là ví dụ về địa chỉ đầy đủ: <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> Dưới đây là ví dụ về địa chỉ đầy đủ sử dụng plus code: <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> Tránh những điều sau:
|
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>