Na tej stronie znajdują się opisy, wartości i wymagania dotyczące atrybutów oraz elementów podrzędnych. Te wartości mają zastosowanie tylko do obiektów dotyczących kwater wakacyjnych.
Ogólna struktura XML ma podobny format jak pliki danych z informacjami o hotelach. Zobacz Dokumentacja XML listy hoteli
Jeśli nie uwzględnisz tych wymaganych elementów, wpis:
- Wymagane elementy podrzędne XML:
id
,name
,latitude
,longitude
orazaddress
. - Atrybuty wymagane:
capacity
iwebsite
. Skorzystaj z linków bezpośrednich do kwater wakacyjnych. w pliku danych z informacjami o produktach. Dzięki temu użytkownicy będą mogli odwiedzić obiekt witryny.
Szczegółowe informacje o wymaganych elementach podrzędnych XML znajdziesz w sekcji elementy podrzędne XML XML. .
Więcej informacji o kwaterach wakacyjnych znajdziesz tutaj: Atrybuty unikalne dla kwater wakacyjnych.
Gdy Google ustala z innych źródeł, że wartość
attribute różni się od
co jest określone w pliku danych o kwaterach wakacyjnych, Google wyświetla
dla listy. Jeśli na przykład Google ustali, na podstawie zdjęć w wizytówce
że jest w nim kuchnia, ale atrybut kitchen
jest niedostępny lub ma wartość No
,
Google traktuje tę ofertę jak kuchnię. Atrybuty te nazywane są
„wywnioskowane atrybuty”. Są one wyświetlane tylko wtedy, gdy istnieje wysoki poziom ufności.
dokładności wnioskowania.
Wartości parametru placeholder_name
W tabeli poniżej znajdziesz listę prawidłowych wartości dla attribute_name
w
element <client_attr name="attribute_name">
; jest to jednak
zalecamy podanie dodatkowych attribute_name
, jeśli są dostępne.
Wartości dla: attribute_name |
Wymagana? | Opis | Prawidłowe wartości treści |
---|---|---|---|
capacity | Required | Maksymalna liczba gości, jaką może pomieścić hotel. Ta wartość powinna być równa lub większa od „liczba_sypialni”. | Non-negative integer value |
website | Required | Adres URL witryny danej usługi. | Free text |
partner_hygiene_link | Strongly recommended | Link do zewnętrznej witryny partnera, na której można znaleźć więcej informacji Szczegóły dotyczące higieny wizytówki. | Free text (the site's URL) |
number_of_bathrooms | Strongly recommended | Liczba łazienek. | Non-negative float value, for example, 1, 1.5, 2 |
number_of_bedrooms | Strongly recommended | Liczba sypialni. | Non-negative integer value |
number_of_beds | Strongly recommended | Liczba łóżek we wszystkich pokojach. | Non-negative integer value |
self_checkin_checkout | Recommended | Określa, czy w hotelu można się zameldować i wymeldować samodzielnie. | Yes/No/Unknown |
rating | Strongly recommended | Liczba zmiennoprzecinkowa reprezentująca zbiorczą ocenę właściwości. Ten zwykle mieści się w zakresie 0-5, 0-10 lub 0-100, ale możesz użyć dowolnego zakresu który reprezentuje Twój system ocen. | Non-negative float value |
rating_num | Strongly recommended | Liczba ocen wystawionych obiektowi. | Non-negative integer value |
rating_scale | Strongly recommended | Maksymalna możliwa ocena obiektu | Non-negative integer value |
instant_bookable | Strongly recommended | Określa, czy w danym miejscu można natychmiast zarezerwować obiekt w momencie wymeldowania. Alternatywą jest oczekiwanie na zatwierdzenie. | Yes/No/Unknown |
description | Strongly recommended | Swobodny tekst opisujący wyjątkowe cechy nieruchomości | Free text |
category | Strongly recommended | rodzaj nieruchomości, np. willa, bungalow, domek lub apartament; | Free text |
ac | Recommended | Czy obiekt jest klimatyzowany. | Yes/No/Unknown |
beach_access | Recommended | Informacja, czy obiekt ma dostęp do publicznej plaży w pobliżu usłudze. | Yes/No/Unknown |
check_in_time | Recommended | Dokładna godzina zameldowania w hotelu. GGMM, GG:MM lub GG:MM:SS akceptowany format; na przykład wpisz 14:00 zamiast 14:00 lub 14:00. Wszystkie inne formaty nie są analizowane ani wyświetlane. | Time |
check_out_time | Recommended | Dokładna godzina wymeldowania z hotelu. GGMM, GG:MM lub GG:MM:SS akceptowany format; na przykład wpisz 11:00 zamiast 11:00 lub 11:00. Wszystkie inne formaty nie są analizowane ani wyświetlane. | Time |
child_friendly | Recommended | Czy obiekt jest odpowiedni dla dzieci. | Yes/No/Unknown |
crib | Recommended | Dostępność łóżeczka dziecięcego. | Yes/No/Unknown |
elevator | Recommended | Czy w obiekcie znajduje się winda. | Yes/No/Unknown |
gym_fitness_equipment | Recommended | czy na terenie obiektu znajduje się siłownia lub sprzęt do fitnessu. | Yes/No/Unknown |
heating | Recommended | Czy obiekt jest ogrzewany. | Yes/No/Unknown |
hot_tub | Recommended | Czy obiekt ma jacuzzi. | Yes/No/Unknown |
ironing_board | Recommended | Czy w obiekcie znajduje się deska do prasowania. | Yes/No/Unknown |
kitchen | Recommended | Czy w obiekcie znajduje się kuchnia. | Yes/No/Unknown |
microwave | Recommended | Czy w obiekcie znajduje się kuchenka mikrofalowa. | Yes/No/Unknown |
min_days_advance_purchase | Recommended | Minimalna liczba dni wcześniej, na którą można zarezerwować obiekt. | Non-negative integer value |
min_night_stay | Recommended | Minimalna liczba nocy, przez które gość może zarezerwować pokój. | Positive integer (more than zero) |
max_night_stay | Recommended | Maksymalna liczba nocy, na jaką gość może zarezerwować pokój. | Positive integer (more than zero) |
outdoor_grill | Recommended | Czy obiekt ma grilla. | Yes/No/Unknown |
oven_stove | Recommended | Informacja, czy w obiekcie jest piec. | Yes/No/Unknown |
parking_type | Recommended | Typ dostępnego parkingu na terenie obiektu. | Free/Paid/None |
patio | Recommended | Czy obiekt ma patio. | Yes/No/Unknown |
pets_allowed | Recommended | Do niektórych lub wszystkich pokoi można przyjechać ze zwierzętami (psami lub kotami), to nie są zwierzęta domowe. | Yes/No/Unknown |
pool_type | Recommended | Typ puli (dostęp do basenu) w miejscu zakwaterowania. | Indoors, Outdoors, Indoors/Outdoors, None |
smoking_free_property | Recommended | Informacja, czy w obiekcie obowiązuje zakaz palenia. | Yes/No/Unknown |
special_service_level | Recommended | Czy poziom usług w informacjach o firmie jest w jakiś sposób specjalny.
Na przykład: verified , luxury .
premium |
Yes/No/Unknown |
square_footage | Recommended | Powierzchnia nieruchomości w stopach kwadratowych. | Non-negative float value |
square_meters | Recommended | Powierzchnia nieruchomości w metrach kwadratowych. | Non-negative float |
tv | Recommended | Czy w obiekcie znajduje się telewizor. | Yes/No/Unknown |
washer_dryer | Recommended | Czy w obiekcie znajdują się pralki. | Yes/No/Unknown |
wheelchair_accessible | Recommended | Dostępność obiektu dla osób na wózkach inwalidzkich. | Yes/No/Unknown |
internet_type | Recommended | Rodzaj dostępu do sieci Wi-Fi zapewnianej przez hotel. | Free/Paid/None |
airport_shuttle | Optional | czy gospodarz zapewnia transport na lotnisko i z lotniska lub inne za pomocą złączy. | Yes/No/Unknown |
balcony | Optional | Czy obiekt ma balkon. | Yes/No/Unknown |
fire_place | Optional | Czy w obiekcie znajduje się kominek. | Yes/No/Unknown |
free_breakfast | Optional | Informacja, czy w hotelu serwowane jest wliczone w cenę śniadanie. | Yes/No/Unknown |
host_description | Optional | Opis firmy oferującej kwaterę wakacyjną. | Free text |
host_language | Optional | Języki, którymi posługuje się gospodarz spotkania | Rozdzielona przecinkami lista wartości
language,
na przykład: de , en |
host_name | Optional | Nazwa firmy oferującej kwaterę wakacyjną. | Free text |
host_response_rate | Optional | Średni współczynnik odpowiedzi hosta. | Non-negative float value, for example, 1, 0.75, 0.5 |
host_response_time | Optional | Średni czas odpowiedzi hosta. | Free text |
license_num | Optional | Numer licencji (turystyki lub firmy) wymagany w przypadku miejsc zakwaterowania w niektórych regionach świata. Może się powtarzać, a jeśli jest kilka licencje, zalecamy dodanie uprawnień w ramach licencji jako kontekstu; na przykład „Paryż: 123456ABC”. | Free text |
number_of_half_bathrooms | Optional | Liczba łazienek połowa. | Non-negative integer value |
number_of_living_rooms | Optional | Liczba salonów. | Non-negative integer value |
private_beach_access | Optional | Czy obiekt ma specjalny dostęp do niepublicznej plaży. | Yes/No/Unknown |
refund_policy | Optional | Zasady zwrotów w przypadku obiektu. | Free text |
Elementy podrzędne XML
Wymagane są następujące elementy podrzędne kodu XML:
Element podrzędny | Wymagana? | Typ | Opis |
---|---|---|---|
<country> | Strongly recommended | string | Kraj, w którym znajduje się ta wizytówka. Wartość musi być
ISO 3116
dwuliterowy kod kraju, na przykład Stany Zjednoczone to US
a Kanada jest CA :
<country>US</country> |
<id> | Required | string | Unikalny identyfikator usługi. Pamiętaj, że każda kwatera wakacyjna musi mieć identyfikator, który jest unikalny dla Twojej witryny. Taki identyfikator nigdy nie powinien ponownie użyte. |
<latitude> | Required | float | Szerokość geograficzna odpowiadająca lokalizacji hotelu, Na przykład:
<latitude>37.423738</latitude> Tę wartość można wygenerować przy użyciu narzędzi do geokodowania, takich jak Interfejs API Map Google. |
<longitude> | Required | float | Długość geograficzna odpowiadająca lokalizacji hotelu, Na przykład:
<longitude>-122.090101</longitude> Tę wartość można wygenerować przy użyciu narzędzi do geokodowania, takich jak Interfejs API Map Google. |
<name> | Required | string | Nazwa usługi. Maksymalnie 300 znaków. |
<address> | Required | string or Object | Pełna lokalizacja fizyczna usługi w postaci ciągu znaków. Adres musi zawierać nazwę ulicy i numer. Jeśli takiego nie ma, adres powinien zawierać kod plus. W razie potrzeby należy też podać numer mieszkania lub lokalu. Możesz też podać parametr „kompozytowy”, adresu. Użyj konta podrzędnego
Pamiętaj, że P.O. ani skrytek pocztowych, ani innych adresów są uznawane za pełne adresy fizyczne. Oto przykłady pełnego adresu: <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> Oto przykłady pełnego adresu z użyciem kodu plus: <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> Unikaj:
|
Przykład oferty kwater wakacyjnych
<?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>