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 và phần tử con. Những giá trị này chỉ áp dụng cho các cơ sở lưu trú là 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 trang thông tin về khách sạn. Hãy xem Tài liệu tham khảo ở định dạng XML về danh sách khách sạn.
Nếu không có các mục bắt buộc sau đây, thì trang thông tin này sẽ tự động vô hiệu hoá.
- Các phần tử con XML bắt buộc:
id,name,latitude,longitude. - Thuộc tính bắt buộc:
capacityvàwebsite.- Xem ví dụ về đường liên kết trực tiếp từ trang web đến tài sản trong nguồn cấp dữ liệu trang thông tin. Điều này giúp người dùng có cơ hội truy cập vào trang web của tài sản.
- Phần tử con XML không bắt buộc (nên dùng):
location_precision– giá trị mặc định là 500 mét.
Để biết thông tin chi tiết về các phần tử con XML bắt buộc, hãy xem bài viết Phần tử con XML.
Để biết thêm thông tin về nhà nghỉ dưỡng cho thuê, hãy xem phần Các thuộc tính của nhà nghỉ dưỡng cho thuê.
Cuối cùng, khi xác định từ các nguồn khác 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 đối với trang thông tin về nhà nghỉ dưỡng cho thuê, chúng tôi sẽ hiển thị giá trị của trang thông tin đó. Ví dụ: nếu chúng tôi xác định từ ảnh của một trang thông tin rằng trang đó có bếp, nhưng thuộc tính kitchen lại không có hoặc được đặt thành No, chúng tôi sẽ coi trang thông tin đó có bếp. Những thuộc tính này được gọi là "thuộc tính suy luận" và sẽ chỉ hiển thị khi chúng tôi thực sự tin tưởng vào tính chính xác của kết quả dự đoán.
Giá trị cho phần giữ chỗ attribute_name
Bảng nà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, đối tác nên cung cấp mọi attribute_name bổ sung mà họ có thể 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à cơ sở lưu trú 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 |
| website | Required | URL của trang web cho tài sản. | Free text |
| min_days_between_stays | Optional (strongly recommended) | Số "ngày chờ" tối thiểu mà phòng cho thuê phải trống sau khi người lưu trú trước khởi hành. | Non-negative integer |
| enhanced_cleaning_practices | Optional (strongly recommended) | Cơ sở lưu trú có sử dụng quy trình vệ sinh nâng cao hay không và có nội dung mô tả trên trang web của đối tác hay không. | Yes/No/Unknown |
| partner_hygiene_link | Optional (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ề quy trình vệ sinh của trang thông tin. | Free text (the site's URL) |
| number_of_bathrooms | Optional (strongly recommended) | Số phòng tắm. | Non-negative float value, for example, 1, 1.5, 2 |
| number_of_bedrooms | Optional (strongly recommended) | Số phòng ngủ. | Non-negative integer value |
| number_of_beds | Optional (strongly recommended) | Số giường trong tất cả các phòng. | Non-negative integer value |
| self_checkin_checkout | Optional (strongly 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 | Optional (strongly recommended) | Số thực cho biết điểm xếp hạng tổng hợp của cơ sở lưu trú. Số này thường từ 0 đến 5, 0 đến 10 hoặc 0 đến 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 mình. | Non-negative float value |
| rating_num | Optional (strongly recommended) | Số lượt xếp hạng mà cơ sở lưu trú nhận được. | Non-negative integer |
| ac | Optional | Cơ sở lưu trú có máy điều hoà không khí hay không. | Yes/No/Unknown |
| airport_shuttle | Optional | Liệu cơ sở lưu trú có cung cấp dịch vụ đưa đón đến hoặc đi từ 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 |
| beach_access | Optional | Cơ sở lưu trú có lối đ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 | Optional | 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 được chấp nhận; ví dụ: sử dụng 14:00 thay vì 2:00 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 |
Optional | 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 được chấp nhận; ví dụ: sử dụng 11:00 thay vì 11:00 sáng 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 | Optional | Cơ sở lưu trú có phù hợp với trẻ em hay không. | Yes/No/Unknown |
| crib | Optional | Cơ sở lưu trú có giường cũi cho trẻ em hay không. | Yes/No/Unknown |
| elevator | Optional | Cơ sở lưu trú có thang máy 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 |
| gym_fitness_equipment | Optional | 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 | Optional | Cơ sở lưu trú có hệ thống sưởi ấm hay không. | Yes/No/Unknown |
| hot_tub | Optional | Cơ sở lưu trú có bồn tắm nước nóng hay không. | Yes/No/Unknown |
| instant_bookable | Optional | Khách sạn có cho phép đặt phòng ngay lập tức thông qua quy trình thanh toán hay không. Giải pháp thay thế là chờ phê duyệt. | Yes/No/Unknown |
| ironing_board | Optional | Cơ sở lưu trú có bàn là hay không. | Yes/No/Unknown |
| kitchen | Optional | Cơ sở lưu trú có khu bếp hay không. | Yes/No/Unknown |
| license_num | Optional | Cơ sở lưu trú ở một số khu vực trên thế giới bắt buộc phải xuất hiện số giấy phép (dành cho khách du lịch hoặc doanh nghiệp). Số này 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 bối cảnh; ví dụ: "Paris: 123456ABC". | Free text |
| microwave | Optional | Cơ sở lưu trú có lò vi sóng hay không. | Yes/No/Unknown |
| minimum_days_advance_purchase | Optional | Số ngày tối thiểu trước khi đặt phòng tại cơ sở lưu trú. | Non-negative integer |
| minimum_night_stay | Optional | Số đêm tối thiểu mà một khách có thể đặt phòng tại cơ sở lưu trú. | Positive integer (more than zero) |
| max_night_stay | Optional | Số đêm tối đa mà một khách có thể đặt phòng tại cơ sở lưu trú. | Positive integer (more than zero) |
| number_of_living_rooms | Optional | Số phòng khách. | Non-negative integer value |
| outdoor_grill | Optional | Cơ sở lưu trú có bếp nướng hay không. | Yes/No/Unknown |
| oven_stove | Optional | Cơ sở lưu trú có bếp lò hay không. | Yes/No/Unknown |
| parking_type | Optional | Loại bãi đỗ xe có sẵn trong cơ sở lưu trú. | Free/Paid/None |
| patio | Optional | Cơ sở lưu trú có sân hiên hay không. | Yes/No/Unknown |
| pets_allowed | Optional | 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 | Optional | Loại hồ bơi (quyền ra vào hồ bơi) tại cơ sở lưu trú. | Indoors, Outdoors, Indoors/Outdoors, None |
| 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 |
| room_type | Optional | Loại cơ sở lưu trú đang được chia sẻ với Google.
Lưu ý: Hiện tại, chỉ chấp nhận toàn bộ địa điểm. |
Entire Place, Shared room, Private Room |
| smoking_free_property | Optional | Cơ sở lưu trú cấm hút thuốc hoặc cấm hút thuốc. | Yes/No/Unknown |
| square_footage | Optional | Diện tích bất động sản tính theo bộ vuông. | Non-negative float value |
| square_meters | Optional | Diện tích của cơ sở lưu trú tính bằng mét vuông. | Non-negative float |
| tv | Optional | Cơ sở lưu trú có TV hay không. | Yes/No/Unknown |
| washer_dryer | Optional | Cơ sở lưu trú có máy giặt hay không. | Yes/No/Unknown |
| wheelchair_accessible | Optional | Cơ sở lưu trú có lối đi cho xe lăn hay không. | Yes/No/Unknown |
| internet_type | Optional | Loại hình truy cập Internet qua Wi-Fi mà cơ sở lưu trú cung cấp. | Free/Paid/None |
| host_language | Optional | Những ngôn ngữ mà người tổ chức có thể nói. | Danh sách mã ngôn ngữ được phân tách bằng dấu phẩy; ví dụ: de, en |
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> | Optional (strongly recommended) | string | Quốc gia nơi đặt cơ sở lưu trú này. Giá trị nhập vào phải là mã quốc gia gồm 2 chữ cái viết hoa 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à nghỉ dưỡng cho thuê phải có một mã nhận dạng dành riêng cho trang web của bạn và không đượ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. |
| <location_precision> | Optional (strongly recommended) | integer | Độ chính xác của vị trí của cơ sở lưu trú tính bằng mét (thường là 500 mét trở lên) khi vĩ độ và kinh độ của cơ sở lưu trú được làm rối mã nguồn.
Giá trị mặc định là 500 mét. 0 có nghĩa là không có xáo trộn và đó là vị trí chính xác và dưới 100 mét được coi là vị trí chính xác.
Phần tử này chỉ áp dụng cho Nhà nghỉ dưỡng cho thuê. |
| <name> | Required | string | Tên của thuộc tính. Tối đa 300 ký tự. |
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">Detailed Address</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>
<location_precision>500</location_precision>
<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>