Atrybuty

Na tej stronie znajdziesz opisy, wartości i wymagania dotyczące atrybutów oraz elementów podrzędnych. Te wartości mają zastosowanie tylko do obiektów z kategorii Noclegi wakacyjne.

Ogólna struktura XML ma format podobny do plików danych z informacjami o hotelach. Zobacz specyfikację listy hoteli w formacie XML.

Jeśli nie podasz tych wymaganych elementów, strona zostanie automatycznie wyłączona:

  • Wymagane podelementy XML: id, name, latitude, longitude, address.
  • Wymagane atrybuty: capacity i website. W pliku danych z informacjami o obiektach turystycznych odsyłaj do linków bezpośrednich do kwater wakacyjnych. Dzięki temu użytkownicy mogą odwiedzić witrynę obiektu.

Szczegółowe informacje o wymaganych elementach podrzędnych XML znajdziesz w artykule Elementy podrzędne XML.

Więcej informacji o kwaterach wakacyjnych znajdziesz w artykule Atrybuty charakterystyczne dla kwater wakacyjnych.

Gdy Google ustali na podstawie innych źródeł, że wartość atrybutu różni się od tej podanej w pliku danych w przypadku informacji o kwaterze wakacyjnej, wyświetla wartość z informacji o kwaterze. Jeśli na przykład na podstawie zdjęć z oferty Google stwierdzi, że ma ona kuchnię, ale atrybut kitchen jest nieobecny lub ustawiony na No, Google uzna, że w ofercie jest kuchnia. Te atrybuty nazywamy „atrybutami wywnioskowanymi” i są one wyświetlane tylko wtedy, gdy jesteśmy pewni ich dokładności.

Wartości zmiennej obiektu zastępczego 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 atrybutu 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, których 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. Free text
partner_hygiene_link Strongly recommended link do zewnętrznej strony partnera, na której można znaleźć więcej informacji o higienie w obiekcie; 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. Liczba ta wynosi zwykle od 0 do 5, 0 do 10 lub 0 do 100, ale możesz użyć dowolnego zakresu, który reprezentuje Twój system oceny. Non-negative float value
rating_num Strongly recommended Liczba ocen obiektu. Non-negative integer value
rating_scale Strongly recommended Maksymalna możliwa ocena obiektu. Na przykład ocena obiektu powinna wynosić 3 lub 4, jeśli skala oceny jest równa 5.

Uwaga: jeśli nie podasz wartości, domyślna skala rating_scale przyjmie zakres 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 typ nieruchomości, 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 się w obiekcie. Format GGMM, GG:MM lub GG:MM:SS. Na przykład zamiast 14:00 wpisz 14:00. Wszystkie inne formaty nie będą analizowane ani wyświetlane. Time
check_out_time Recommended Dokładna godzina wymeldowania z obiektu. Format GGMM, GG:MM lub GG:MM:SS. Na przykład zamiast 11:00 wpisz 11:00. Wszystkie inne 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 jaką można zarezerwować obiekt. Non-negative integer value
min_night_stay Recommended Minimalna liczba nocy, na jaką 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. 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ą zabrać ze sobą zwierzęta (psy lub koty, 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 Typ 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 danego produktu jest w jakiś sposób szczególny. 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 w obiekcie. 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 wydającego licencję (na przykład: „Warszawa: 123456ABC”). Free text
number_of_half_bathrooms Optional Liczba połówek łazienki. Non-negative integer value
number_of_living_rooms Optional Liczba pokoi dziennych. 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 za usługę. 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 strona. Wartość musi być 2-literowym kodem kraju zgodnym ze standardem 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żda oferta wynajmu wakacyjnego musi mieć identyfikator, który jest unikalny dla Twojej witryny. Nie należy go ponownie używać.
<latitude> Required float Szerokość geograficzna odpowiadająca lokalizacji hotelu, Na przykład: 
    <latitude>37.423738</latitude>

Wartość tę 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 nieruchomości. Maksymalnie 300 znaków.
<address> Required string or Object

Pełna fizyczna lokalizacja obiektu w formie ciągu znaków. Adres musi zawierać nazwę ulicy i numer domu. Jeśli nie ma takiego kodu, adres powinien zawierać kod plusa. W razie potrzeby należy też podać numer mieszkania lub lokalu.

Możesz też podać „adres złożony”. Użyj elementów podrzędnych <component>, aby opisać poszczególne części adresu:

  • addr1: podstawowy adres pocztowy.
  • addr2: w razie potrzeby drugi adres ulicy, w tym numer mieszkania.
  • city: miasto.
  • province: w razie potrzeby stan, region lub prowincja.
  • postal_code: kod pocztowy.
  • country: kraj.

Skrytki pocztowe i 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="addr1">6 Acacia Ave</component>
  <component name="addr2">Apt. 2</component>
  <component name="city">Nottingham </component>
  <component name="postal_code">NG8 6FT</component>
  <component name="country">UK</component>
</address>

Oto przykłady pełnego adresu z kodem plus:

<address>XQHM+7VF Nottingham NG8 6FT, UK/address>
 
<address>
  <component name="addr1">XQHM+7VF</component>
  <component name="city">Nottingham </component>
  <component name="postal_code">NG8 6FT</component>
  <component name="country">UK</component>
</address>

Unikaj:

  • Informacje zbędne: nie podawaj zbędnych informacji ani nie powtarzaj elementów adresu.
  • Brak adresu ulicy: adresy muszą zawierać nazwę i numer ulicy.

Przykład informacji o kwaterze wakacyjnej

<?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>