Na tej stronie znajdziesz opisy, wartości i wymagania dotyczące atrybutów i 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. Zapoznaj się z informacjami o pliku XML z listą hoteli.
Nieuwzględnienie następujących wymaganych elementów powoduje automatyczne wyłączenie informacji o firmie:
- 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 mogą odwiedzić stronę obiektu.
Szczegółowe informacje o wymaganych elementach podrzędnych XML znajdziesz w artykule o elementach podrzędnych XML.
Więcej informacji o kwaterach wakacyjnych znajdziesz w artykule Atrybuty kwatery wakacyjnej.
Gdy Google ustali z innych źródeł, że wartość atrybutu jest inna niż określona w pliku danych informacji o kwaterach wakacyjnych, wyświetlimy tę wartość. Jeśli na przykład na podstawie zdjęć w wizytówce Google ustali, że jest w niej kuchnia, ale atrybut kitchen
jest pusty lub ma wartość No
, Google potraktuje tę wizytówkę jako mieszczącą kuchnię. Te atrybuty są nazywane „atrybutami wywnioskowanymi” i są wyświetlane tylko wtedy, gdy istnieje duża pewność co do dokładności wnioskowania.
Wartości parametru placeholder_name
Poniższa tabela zawiera listę prawidłowych wartości dla attribute_name
w elemencie <client_attr name="attribute_name">
. Zalecamy jednak 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 „number_of_sypialni”. | Non-negative integer value |
website | Required | Adres URL witryny danej usługi. | Free text |
partner_hygiene_link | Strongly recommended | Link do zewnętrznej strony partnera, na której można znaleźć więcej informacji na temat zasad 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. 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 obiektu. | Yes/No/Unknown |
check_in_time | Recommended | Dokładna godzina zameldowania w hotelu. Dozwolony format GGMM, GG:MM lub GG:MM:SS, na przykład 14:00 zamiast 14:00 lub 14:00. Pozostałe formaty nie zostaną przeanalizowane ani wyświetlone. | Time |
check_out_time | Recommended | Dokładna godzina wymeldowania z hotelu. Dozwolony format GGMM, GG:MM lub GG:MM:SS, na przykład 11:00 zamiast 11:00 lub 11:00. Pozostałe formaty nie zostaną przeanalizowane ani wyświetlone. | 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 goście mogą przyjechać ze zwierzętami (psami lub kotami, które nie są zwierzętami gospodarczymi). | 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.
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 do innych terminali oraz z powrotem. | 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 kodów języków, 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, aby wyświetlać się w przypadku obiektów w niektórych regionach świata. Może się on powtarzać. Jeśli istnieje wiele licencji, zalecamy dodanie uprawnienia dotyczącego 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ścią musi być dwuliterowy kod kraju w formacie ISO 3116, np. Stany Zjednoczone to US , a Kanada – CA : <country>US</country> |
<id> | Required | string | Unikalny identyfikator usługi. Pamiętaj, że każda kwatera wakacyjna musi mieć unikalny dla Twojej witryny identyfikator, którego nie należy używać ponownie. |
<latitude> | Required | float | Szerokość geograficzna odpowiadająca lokalizacji hotelu, Na przykład: <latitude>37.423738</latitude> Tę wartość można wygenerować za pomocą narzędzi GeoCoding, takich jak Google Maps API. |
<longitude> | Required | float | Długość geograficzna odpowiadająca lokalizacji hotelu, Na przykład: <longitude>-122.090101</longitude> Tę wartość można wygenerować za pomocą narzędzi GeoCoding, takich jak Google Maps API. |
<name> | Required | string | Nazwa usługi. Maksymalnie 300 znaków. |
<address> | Required | Object or string | Pełna lokalizacja fizyczna nieruchomości. Ten element przyjmuje tylko 1 atrybut Musisz podać co najmniej ulicę i numer domu, miasto, stan lub region oraz kod pocztowy nieruchomości. Używaj elementów podrzędnych
Na przykład: <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> Możesz również podać adres w formacie dowolnym, ale nie jest to zalecane. Na przykład: <address>6 Elm Ave Unit 3, Boston, MA, 02472</address> Pamiętaj, że skrytki pocztowe ani inne adresy przeznaczone tylko do korespondencji nie są uznawane za pełne adresy fizyczne. |
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>