Na tej stronie znajdziesz opisy, wartości i wymagania dotyczące atrybutów i elementów podrzędnych. Te wartości mają zastosowanie tylko w przypadku obiektów typu dom wakacyjny.
Ogólna struktura XML jest podobna do formatu plików danych z informacjami o hotelach. Zobacz specyfikację listy hoteli w formacie XML.
Brak tych wymaganych elementów spowoduje automatyczne wyłączenie informacji:
- Wymagane elementy podrzędne XML:
id,name,latitude,longitude,address. - Wymagane atrybuty:
capacityiwebsite. Zapoznaj się z linkami bezpośrednimi do kwater wakacyjnych w pliku danych z informacjami o kwaterach. Dzięki temu użytkownicy mogą odwiedzić witrynę obiektu.
Szczegółowe informacje o wymaganych elementach podrzędnych XML znajdziesz w sekcji Elementy podrzędne XML.
Więcej informacji o kwaterach wakacyjnych znajdziesz w artykule Atrybuty unikalne dla kwater wakacyjnych.
Gdy Google na podstawie innych źródeł stwierdzi, że wartość atrybutu jest inna niż podana w pliku danych dla informacji o kwaterze wakacyjnej, wyświetli tę wartość w informacjach. Jeśli na przykład na podstawie zdjęć obiektu Google stwierdzi, że ma on kuchnię, ale atrybut kitchen jest nieobecny lub ma wartość No, Google uzna, że obiekt ma kuchnię. Te atrybuty są nazywane „atrybutami wywnioskowanymi” i wyświetlają się tylko wtedy, gdy istnieje wysoki poziom pewności co do dokładności wnioskowania.
<review>
Zawiera opinię użytkownika lub opinię redakcyjną. W elemencie <listing> nie musisz umieszczać wszystkich opinii o informacjach. Ten element służy do umieszczania wybranych opinii, które wskazują na cechy lub jakość tej wizytówki.
Element <review> występuje w tym miejscu w hierarchii pliku danych XML listy hoteli:
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
Składnia
Element <review> ma tę składnię:
<?xml version="1.0" encodin>g<="UTF-8&>quo<t;?
lis>tings< ...
> listing
cont<ent
..<.
> !-- Specify review's child elements in t>he orde<r shown below. --
> review t<ype=>"edito<rial&>quot;
< >linkreview_l<ink/li>n<k
titlereview_title/title !-- Title is for r>eviews of< type >"editori<al">; only --<
> authorrevi<ew_auth>or/author<
> rating<revie>w_rating/<rati>ng
<bodyr>eview_tex<t/body
> datereview_dat<e/date
> serv<icedate>review_<servicedate/servic>edate
< <>/span>/review
< review type=<">user"
< <>/span>linkreview<_link/link
authorreview_autho>r/<author
date month="MM" day=&>quot;DD&q<uot; year="YYYY"/ !-- Date is for> r<eviews of type "user" only --
servic>edate mon<th=&qu>ot;MM" d<ay=&quo>t;DD"<; ye>ar="YY<YY&qu>ot;/ !<-- Serv>ice D<ate is f>or <reviews >o<f type &q>uot;user" only --
ratingreview_rating/rating
bodyreview_text/body
/review
/content
/listing
/listings
Atrybuty
Element <review> ma te atrybuty:
| Atrybut | Wymagany? | Opis |
|---|---|---|
| type | Required | Rodzaj opinii. Ustaw jedną z tych wartości:
|
Elementy potomne
Element <review> ma te elementy podrzędne:
| Element podrzędny | Wymagany? | Typ | Opis |
|---|---|---|---|
| <link> | Optional | string | Link do opinii. Ten element musi zawierać „http://” lub „https://”. |
| <title> | Optional | string | (Tylko opinie redakcyjne) Tytuł opinii. |
| <author> | Optional | string | Autor opinii, np. „Susan von Trapp”. Może to być też nazwa witryny lub publikacji, w której pojawia się opinia, jeśli nie jest ona przypisana do konkretnego autora. |
| <rating> | Optional | string | Liczba zmiennoprzecinkowa z zakresu od 0 do 10 (włącznie) reprezentująca ocenę opinii. Na przykład „8.9”. |
| <body> | Optional | string | Tekst opinii. Ten element nie powinien zawierać kodu HTML. |
| <date month="MM" day="DD" year="YYYY"/> | Optional | Object | (Tylko opinie użytkowników) Data opinii, którą określasz za pomocą tych atrybutów elementu:
Na przykład 7 czerwca 2023 r. zapisuje się w ten sposób: <date month="6" day=">7" year="2023"/ |
| <servicedate month="MM" day="DD" year="YYYY"/> | Optional | Object | (Tylko opinie użytkowników) Data, kiedy osoba pisząca opinię odwiedziła stronę z informacjami o aplikacji. Format jest taki sam jak w przypadku elementu <date>.
Na przykład 7 czerwca 2023 r. zapisuje się w ten sposób: <servicedate month="6" day=">7" year="2023"/ Opinie, w których nie podano co najmniej miesiąca i roku w polu <servicedate>, mogą nie być wyświetlane. Dzień nie jest wymagany. |
Przykład
Ten przykład przedstawia częściową listę hoteli z informacjami o hotelu, które zawierają redakcyjną i użytkownika:
<?xml version="1.0" encodin>g<="UTF-8"?
listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gs>tat<ic.com/l>oc<alfeed/lo>cal<_feed.x>sd&qu<ot>;
la<ngu>ageen</lan>guage
list<ing
> id<123456/id
nameMy Ap>artment</name
address form>at="simple"<;
co>mponent< name="addr1&quo>t;1 Sandsto<ne Buildin>g/compo<nent
component name=&q>uot;c<ity"L>os Ange<les/component
compo>ne<nt name=&q>uot;p<ostal_co>de&qu<ot;9021>0/<componen>t
< component name<="pr>ovinc<e"CA>/component<
/addr>ess
< country>US/country
<latitu>de40.<730610/l>atitu<de
lo>n<gitude-73.935242/longitude
phone type="main"123>45678</phone
> cat<egoryhotel/category !--> You can <use >whatever property type categories you wis<h --
> conte<nt
> text type="descrip<tion&q>uot;
< >linkhttps://examplelisting.com/listings/12345/link
< >span>title3 bedr<ooms with ocean views/title
>bodySta<y in >this ne<wly renovated 3BR house> with oce<an v>iews./body
date month=<">;7" <day=&>quot;23" year="<;2023&>quot;/
< >span>/text
r<eview t>ype="<;edito>r<ial&quo>t;
< >span>linkhttps://example.com/revi<ews/4>2/link
< > titleA< little piece of h>eaven/tit<le
> authorEXAMPLE.COM/author
< <>/span>rating8/ra<ting
> bodyThis< place >is really< good.>/<body
> /revi<ew
> review type="user"
linkhttps://ex<ample>person.or<g/reviews/82/link
authorSus>an von Tr<app/author
rating6/rating
b>odyNot <a bad p>lace, b<ut I prefe>r to be c<loser t>o the beach./body
< date da>y="6<" month="7">; y<ear="20>23"/<
servicedate day=">;1<6" mont>h="<;6" ye>ar=&quo<t;2023"/
/review
attribut>es
< >span>websitehttps://hote<l.exa>mple.com/<websi>te
client_<attr n>ame=&qu<ot;rat>ing&q<uot;8.2/>cli<ent_attr>
< >client_attr name="num_reviews"14/client_attr
/attributes
image type="photo" url="https://image_url"
linkhttps://image_url/link
titleMain hotel picture/title
/image
/content
/listing
...
/listings
Wartości zmiennej attribute_name
W tabeli poniżej znajdziesz listę prawidłowych wartości atrybutu attribute_name w elemencie <client_attr name="attribute_name">. Zalecamy jednak podanie dodatkowych wartości attribute_name, jeśli są dostępne.
Wartości dla: attribute_name |
Wymagany? | Opis | Prawidłowe wartości treści |
|---|---|---|---|
| capacity | Required | Maksymalna liczba gości, jaką może pomieścić obiekt. Ta wartość powinna być równa lub większa niż „number_of_bedrooms”. | Non-negative integer value |
| website | Required | Adres URL witryny usługi. Powinien być unikalny dla wizytówki i nie może być powielany w wielu wizytówkach. | Free text |
| partner_hygiene_link | Strongly recommended | Link do zewnętrznej witryny partnera, w której znajdziesz więcej informacji o szczegółach dotyczących higieny w przypadku danej oferty. | 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 | Czy obiekt umożliwia samodzielne zameldowanie się i wymeldowanie. | Yes/No/Unknown |
| rating | Strongly recommended | Liczba zmiennoprzecinkowa reprezentująca łączną ocenę obiektu. Ta liczba zwykle mieści się w zakresie 0–5, 0–10 lub 0–100, ale możesz użyć dowolnego zakresu, który odpowiada Twojemu systemowi ocen. | Non-negative float value |
| rating_num | Strongly recommended | Liczba ocen, które ma obiekt. | Non-negative integer value |
| rating_scale | Strongly recommended | Maksymalna możliwa ocena usługi. Na przykład w przypadku skali oceny 5 ocena obiektu powinna wynosić 3 lub 4.
Uwaga: jeśli nie podasz wartości, domyślna skala oceny to 0–10. |
Non-negative integer value |
| instant_bookable | Strongly recommended | Czy w procesie płatności można natychmiast zarezerwować pokój. Alternatywą jest oczekiwanie na zatwierdzenie. | Yes/No/Unknown |
| description | Strongly recommended | Tekst niesformatowany opisujący unikalne cechy obiektu | Free text |
| category | Strongly recommended | rodzaj obiektu, np. willa, bungalow, domek lub apartament; | Free text |
| ac | Recommended | Czy obiekt jest klimatyzowany. | Yes/No/Unknown |
| beach_access | Recommended | Czy obiekt ma dostęp do publicznej plaży w pobliżu. | Yes/No/Unknown |
| check_in_time | Recommended | Dokładna godzina zameldowania w obiekcie. Akceptowane formaty to GGMM, GG:MM i GG:MM:SS. Na przykład zamiast 14:00 lub 14:00 użyj 14:00. Wszystkie pozostałe formaty nie będą analizowane ani wyświetlane. | Time |
| check_out_time | Recommended | Dokładna godzina wymeldowania z obiektu. Akceptowane formaty to HHMM, HH:MM i HH:MM:SS. Na przykład użyj 11:00 zamiast 11:00 lub 11:00. Wszystkie pozostałe formaty nie będą 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 w obiekcie znajduje się siłownia lub sprzęt do ćwiczeń. | 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 wyprzedzenia, z jakim można zarezerwować obiekt. | Non-negative integer value |
| min_night_stay | Recommended | Minimalna liczba nocy, na które gość może zarezerwować obiekt. | Positive integer (more than zero) |
| max_night_stay | Recommended | Maksymalna liczba nocy, na jaką gość może zarezerwować obiekt. | Positive integer (more than zero) |
| outdoor_grill | Recommended | Czy obiekt ma grilla. | Yes/No/Unknown |
| oven_stove | Recommended | Czy w obiekcie znajduje się kuchenka lub piekarnik. | Yes/No/Unknown |
| parking_type | Recommended | Rodzaj parkingu dostępnego na terenie obiektu. | Free/Paid/None |
| patio | Recommended | Czy obiekt ma patio. | Yes/No/Unknown |
| pets_allowed | Recommended | W niektórych lub wszystkich pokojach goście mogą przebywać ze zwierzętami domowymi – psami lub kotami, które nie są zwierzętami asystującymi. | Yes/No/Unknown |
| pool_type | Recommended | Rodzaj basenu (dostęp do basenu) w obiekcie. | Indoors, Outdoors, Indoors/Outdoors, None |
| room_type | Recommended | Rodzaj pokoju. ENTIRE_PLACE to jedyna obsługiwana wartość. |
ENTIRE_PLACE
|
| smoking_free_property | Recommended | Czy w obiekcie obowiązuje zakaz palenia. | Yes/No/Unknown |
| special_service_level | Recommended | Czy poziom usługi w przypadku tej wizytówki jest w jakiś sposób specjalny.
Przykłady: 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 internetu Wi-Fi oferowanego przez obiekt. | Free/Paid/None |
| airport_shuttle | Optional | Czy gospodarz zapewnia transport między hotelem a lotniskiem lub innymi terminalami. | 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 | Czy śniadanie jest wliczone w cenę. | Yes/No/Unknown |
| host_description | Optional | Opis gospodarza kwatery wakacyjnej. | Free text |
| host_language | Optional | Języki, którymi posługuje się gospodarz. | Lista kodów języków rozdzielonych przecinkami, np. de, en |
| host_name | Optional | Imię i nazwisko gospodarza kwatery wakacyjnej. | Free text |
| host_response_rate | Optional | Średni współczynnik odpowiedzi gospodarza. | 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 (turystycznej lub firmy) wymagany w przypadku obiektów w określonych regionach świata. Można go powtarzać. Jeśli istnieje kilka licencji, zalecamy dodanie urzędu wystawiającego licencję; na przykład: „Paryż: 123456ABC”. | Free text |
| number_of_half_bathrooms | Optional | Liczba łazienek bez prysznica lub wanny. | 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 dotyczące obiektu. | Free text |
Elementy podrzędne XML
Wymagane są te elementy podrzędne XML:
| Element podrzędny | Wymagany? | Typ | Opis |
|---|---|---|---|
| <country> | Strongly recommended | string | Kraj, w którym znajduje się ta wizytówka. Wartością musi być dwuliterowy kod kraju w standardzie ISO 3116. Na przykład Stany Zjednoczone to US, a Kanada to CA:
<country>US</country> |
| <id> | Required | string | Unikalny identyfikator usługi. Pamiętaj, że każdy obiekt wakacyjny musi mieć identyfikator, który jest unikalny w Twojej witrynie i nigdy nie powinien być ponownie używany. |
| <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 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ć za pomocą 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łny adres fizycznej lokalizacji obiektu w formie ciągu znaków. Adres musi zawierać nazwę ulicy i numer domu. Jeśli nie istnieje, adres powinien zawierać kod plus. W stosownych przypadkach należy podać numer mieszkania lub lokalu. Możesz też podać adres „złożony”. Użyj elementów podrzędnych
Skrytki pocztowe ani inne adresy korespondencyjne nie są uznawane za pełne adresy hoteli. Oto przykłady pełnego adresu: <address>6 Acacia Ave Apt. 2, Nottingham NG8 6FT, UK/address> <address> <component name="a>ddr1"6 <Acacia Ave>/co<mponent component na>me=&qu<ot;addr2&q>uot<;Apt. 2/component c>omponent na<me="c>ity<"Nottingham /component > compo<nent name=>&qu<ot;postal_code"NG8 >6F<T/componen>t< compo>nent name="country"UK/component /address Oto przykłady pełnego adresu z użyciem kodu plus: <address>XQHM+7VF Nottingham NG8 6FT, UK/address> <address> <component name="a>ddr1&quo<t;XQHM+7VF>/co<mponent component n>ame="c<ity"N>ott<ingham /component componen>t name=<"post>al_<code"NG8 6FT/compon>en<t compon>e<nt name=>"country"UK/component /address Unikaj:
|
Przykład informacji o kwaterze wakacyjnej
<?xml version="1.0" encodin>g<="U>TF-<8"?> l<istings > la<nguagee>n/lan<gu>age <lis>ting < >id123456/id < nam>eApar<tment Name/name add>ress fo<rmat="simple">; compone<nt name=&q>uot;add<r1"18733 Clark Wa>y/co<mponent > com<ponent name="add>r2"#C10/<component > c<omponent name="city&quo>t;Mou<ntain View>/compon<ent component name=>"post<al_code&qu>ot;94<043/comp>onent< >co<mponent >name=<"pr>ovince&quo<t;Califor>nia/c<omponent<>/span> /address< count>ryUS/<country latit>ude37.41<82515/>latit<ude >longitude-122.<0742354/l>ongit<ude phone type="main"12>34567<8/phone> ca<tegoryvacation_villa/ca>tegory < da>te day="21&<quot;> month=&q<uot;1>2" year=&quo<t;2017>"/ < c>ontent tex<t typ>e="<;desc>ription<" linkhttp>s://list_<url/>link titleDescription <Title>/title < > bodyDescription Body/bo<dy > /text < >review <type=&q>uot;edito<rial&q>u<ot; > link<http>s://example.com/reviews/42</link> < title>A littl<e piece of heaven/>title < > authorEXAMPLE/author rating<8/rat>ing < bod>yThis place is <really >good./bod<y > < /revie>w r<evie>w type="user" linkhttps://exampleperso<n.org>/reviews/<82/link authorSusan von Tra>pp/author< rating6/rating bodyNot a b>ad plac<e, but >I prefe<r to be cl>oser to t<he beac>h./body date day="6<" m>onth=&quo<t;7" year="2017&q>u<ot;/ > serviced<ate day="16" month="6&quo>t; <year="2>017"</ /review attributes >w<ebsitehttps:>//hotel.e<xample.com/123456/website client_attr >nam<e="capa>city"<;7/client_attr client_attr name>="cleaning_disinfection&qu<ot;Yes/clien>t_attr < client_attr name="min_days_>b<etween_stays>"3/c<lient_attr client_attr name=&>q<uot;enhanced>_cleaning<_practices"Yes/client_attr > < client>_attr nam<e="partner_hygiene_link"http:/>/ww<w.example.co>m/hygiene<//client_attr cli>ent<_attr name=&>quot;numb<er_of_bathrooms"2/client>_att<r cl>ient_attr< name="number_of_bedrooms&>q<uot;3/client>_attr < client_attr name>=&q<uot;number_o>f_beds&qu<ot;4/client_attr client_at>tr <name="s>elf_check<in_checkout"Yes/clien>t_<attr > client_a<ttr name="rating"4.8/>cli<ent_attr > clie<nt_attr name="rating_num&qu>ot;53<73/client_at>tr < client_attr name="rating_s>cale&<quot;5/clien>t_attr < client_attr name="ac&q>uot<;Yes/client_>attr < client_attr name=&q>uot;air<port_shuttle>"Yes</client_attr client>_at<tr name=&quo>t;balcony<"No/client_attr >client_<attr name=&q>uot;beach<_access"Yes/client_attr > < client_attr> name=&qu<ot;check_in_time"15:00/client_attr > < client_>attr name<="check_out_time">;11<:00/client_a>ttr < client_attr name="child_fri>endly"Yes/client_attr client_attr name=&q<uot;crib&quo>t;Unknown</client_attr client_>attr name="elev<ator"Ye>s/client_<attr client_attr name=&q>uot;fire_p<lace"Un>known/cli<ent_attr client_attr name=&qu>ot;f<ree_breakfas>t"Ye<s/client_attr client_attr nam>e=&quo<t;gym_fitnes>s_equipme<nt"Yes/client_attr > < client_at>tr name=&<quot;heating"Yes/client_attr > < client_a>ttr name=<"host_description"A sh>ort <description >about the< host and their interests/client>_a<ttr >client_at<tr name="host_name&qu>ot;<The name of >the host/<client_attr client_att>r name="host_language"en, da, el/client_attr client_attr name="host_r<esponse_rate>"0.7<5/client_attr client_a>ttr name="h<ost_response>_time&quo<t;1 hour/client_attr > cl<ient_attr na>me="<hot_tub"Yes/client_attr > < client_at>tr name=&<quot;instant_bookable"Yes/client_attr > < client>_attr nam<e="internet_type"Free/c>l<ient_attr > cli<ent_attr name="ironing_board"No>/<client_attr > c<lient_attr name="kitchen&qu>ot<;Yes/client_>attr < client_attr name="li>cen<se_num">Free text<. If multiple licenses exist, w>e su<ggest adding> authorit<y of the licence as cont>ext/cli<ent_attr > clie<nt_attr name="license_num&>quo<t;Paris: 123>456ABC/cl<ient_attr client_att>r name=<"microw>ave"<Yes/client_attr client_attr nam>e="<;max_night_s>tay"<7/client_attr client>_attr name=&<quot;min_day>s_advance<_purchase"2/client_attr > client_attr name="min_ni<ght_stay&quo>t;3/clien<t_attr client_attr name="nu>mbe<r_of_living_>rooms&quo<t;1/client_attr client_attr name>=&<quot;outdoor>_grill&qu<ot;No/client_attr client_>attr< name=">oven_stov<e"Yes/client_att>r < clien>t_attr na<me="parking_type"Free>/cl<ient_attr > cli<ent_attr name="patio"Unknown/c>lie<nt_attr > cli<ent_attr na>me=&q<uot;pets>_al<lowed&qu>o<t;Yes/cli>ent_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