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. Những giá trị này chỉ áp dụng cho 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 XML về danh sách khách sạn.
Danh sách này sẽ tự động bị vô hiệu hoá nếu bạn không bao gồm các mục bắt buộc sau đây.
- Các phần tử con XML bắt buộc:
id,name,latitude,longitude,address. - Thuộc tính bắt buộc:
capacityvàwebsite.- Hãy tham khảo đường liên kết trực tiếp đến 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 đó.
Để 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 Các 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 xác định qua 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 của 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 từ các ảnh của một trang thông tin, chúng tôi xác định rằng trang thông tin đó có nhà bếp, nhưng thuộc tính kitchen không có hoặc được đặt là No, thì chúng tôi sẽ coi trang thông tin đó có nhà bếp. Các 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 độ chính xác của kết quả 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à 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 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 trang thông tin. | Free text (the site's URL) |
| number_of_bathrooms | Strongly recommended | Số 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ả cá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 | Một số thực cho biết điểm xếp hạng tổng hợp của cơ sở lưu trú. Con số này thường nằm trong khoảng 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ượt xếp hạng mà cơ sở lưu trú nhận được. | Non-negative integer value |
| rating_scale | Strongly recommended | Mức xếp hạng tối đa có thể có cho một cơ sở lưu trú | Non-negative integer value |
| instant_bookable | Strongly recommended | Liệu cơ sở lưu trú có cho phép đặt phòng ngay lập tức thông qua quy trình thanh toán hay không. Lựa chọn thay thế 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 cơ sở lưu trú, 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ú. Định dạng 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 chiều. 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ú. Định dạng HHMM, HH:MM hoặc HH:MM:SS được chấp nhận; ví dụ: sử 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 |
| minimum_days_advance_purchase | Recommended | Số ngày tối thiểu mà cơ sở lưu trú có thể đặt trước. | Non-negative integer value |
| minimum_night_stay | Recommended | 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 | Recommended | 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) |
| 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 lò hay không. | Yes/No/Unknown |
| parking_type | Recommended | Loại bãi đỗ xe có 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 là động vật hỗ trợ) cùng. | Yes/No/Unknown |
| pool_type | Recommended | Loại hồ bơi (đường 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ấm hút thuốc hay cấm hút thuốc. | Yes/No/Unknown |
| special_service_level | Recommended | Cấp dịch vụ của trang thông tin 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 cơ sở lưu trú tính bằng feet vuông. | Non-negative float value |
| square_meters | Recommended | Diện tích của cơ sở lưu trú 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 qua Wi-Fi mà 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 khách đế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ó bao gồm bữa sáng miễn phí hay không. | Yes/No/Unknown |
| host_description | Optional | Nội dung mô tả về chủ nhà/căn hộ du lịch. | Free text |
| host_language | Optional | Ngôn ngữ mà người tổ chức có thể sử dụng. | Một danh sách các 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ủ. | 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 người tổ chức. | Free text |
| 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 hiển thị 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 chứng nhận của giấy phép đó làm thông tin liên quan; ví dụ: "Paris: 123456ABC". | Free text |
| number_of_half_bathrooms | Optional | Số lượng nửa 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
Bạn phải có các phần tử con XML sau:
| 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 cơ sở lưu trú 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 được 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 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 một địa chỉ "dạng tuỳ ý", mặc dù bạn không nên thực hiện việc nà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à/căn hộ du lịch
<?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>