Attributi

Questa pagina descrive le descrizioni, i valori e i requisiti per gli attributi e gli elementi secondari. Questi valori sono applicabili solo alle case vacanze.

La struttura XML generale ha un formato simile a quello dei feed di schede di hotel. Consulta la pagina di riferimento sul file XML dell'elenco di hotel.

Se non includi i seguenti elementi obbligatori, la scheda viene disattivata automaticamente:

  • Elementi secondari XML obbligatori: id, name, latitude, longitude, address.
  • Attributi obbligatori: capacity e website. Consulta i link diretti per le case vacanze nel feed elenco. In questo modo, gli utenti hanno la possibilità di visitare il sito web della struttura.

Per i dettagli sugli elementi secondari XML obbligatori, consulta la sezione Elementi secondari XML.

Per saperne di più sulle case vacanze, consulta Attributi unici per le case vacanze.

Infine, quando Google determina da altre fonti che il valore di un attributo è diverso da quello specificato nel feed per una scheda di casa vacanze, Google visualizza il valore per la scheda. Ad esempio, se Google determina dalle foto di una scheda che ha una cucina, ma l'attributo kitchen è assente o impostato su No, Google considera la scheda come se avesse una cucina. Questi attributi sono chiamati "attributi dedotti" e vengono visualizzati solo quando la loro accuratezza è ragionevolmente certa.

<review>

Contiene una recensione di un utente o una recensione editoriale. Non è necessario includere tutte le recensioni per una proprietà nell'elemento <listing>. Questo elemento è destinato a recensioni selezionate che illustrino le caratteristiche o la qualità di questa proprietà.

L'elemento <review> compare nella seguente posizione nella gerarchia XML del feed elenco hotel:

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>

Sintassi

L'elemento <review> utilizza la seguente sintassi:

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <content>
      ...
      <!-- Specify <review>'s child elements in the order shown below. -->
      <review type="editorial">
        <link>review_link</link>
        <title>review_title</title> <!-- Title is for reviews of type "editorial" only -->
        <author>review_author</author>
        <rating>review_rating</rating>
        <body>review_text</body>
        <date>review_date</date>
        <servicedate>review_servicedate</servicedate>
      </review>
      <review type="user">
        <link>review_link</link>
        <author>review_author</author>
        <date month="MM" day="DD" year="YYYY"/>  <!-- Date is for reviews of type "user" only -->
        <servicedate month="MM" day="DD" year="YYYY"/>  <!-- Service Date is for reviews of type "user" only -->
        <rating>review_rating</rating>
        <body>review_text</body>
      </review>
    </content>
  </listing>
</listings>

Attributi

L'elemento <review> prevede i seguenti attributi:

Attributo Obbligatorio? Descrizione
type Required Il tipo di recensione. Imposta uno dei seguenti valori:
  • editorial: una recensione di un sito web o di un'altra fonte riconosciuta.
  • user: una recensione di un utente finale.

Elementi secondari

L'elemento <review> prevede i seguenti elementi secondari:

Elemento secondario Obbligatorio? Tipo Descrizione
<link> Optional string Un link alla recensione. Includi "http://" o "https://" in questo elemento.
<title> Optional string (Solo recensioni editoriali) Il titolo della recensione.
<author> Optional string L'autore della recensione; ad esempio, "Susan von Trapp". Può anche essere il nome di un sito web o di una pubblicazione in cui appare la recensione, se questa non è firmata.
<rating> Optional string Un numero in virgola mobile compreso tra 0 e 10 (inclusi) che rappresenta il punteggio della recensione. Ad esempio, "8,9".
<body> Optional string Il testo della recensione. Questo elemento non deve contenere HTML.
<date month="MM" day="DD" year="YYYY"/> Optional Object (Solo recensioni degli utenti) La data della recensione, specificata con i seguenti attributi di questo elemento:
  • day: il giorno del mese; ad esempio, "7".
  • month: il mese, dove 1 = gennaio ... 12 = dicembre.
  • year: l'anno di quattro cifre; ad esempio,"2023".

Ad esempio, il 7 giugno 2023 viene scritto in questo modo:

<date month="6" day="7" year="2023"/>
<servicedate month="MM" day="DD" year="YYYY"/> Optional Object (Solo recensioni degli utenti) La data in cui il recensore ha visitato la proprietà recensita. Il formato è lo stesso di <date>.

Ad esempio, il 7 giugno 2023 viene scritto in questo modo:

<servicedate month="6" day="7" year="2023"/>

Le recensioni senza indicazione almeno del mese e dell'anno in <servicedate> potrebbero non essere visualizzate. Il giorno non è obbligatorio.

Esempio

L'esempio seguente mostra un elenco parziale di hotel con un elemento <listing> che contiene una recensione editoriale e una recensione di un utente:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>My Apartment</name>
    <address format="simple">
      <component name="addr1">1 Sandstone Building</component>
      <component name="city">Los Angeles</component>
      <component name="postal_code">90210</component>
      <component name="province">CA</component>
    </address>
    <country>US</country>
    <latitude>40.730610</latitude>
    <longitude>-73.935242</longitude>
    <phone type="main">12345678</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
    <content>
      <text type="description">
        <link>https://examplelisting.com/listings/12345</link>
        <title>3 bedrooms with ocean views</title>
        <body>Stay in this newly renovated 3BR house with ocean views.</body>
        <date month="7" day="23" year="2023"/>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE.COM</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="2023"/>
        <servicedate day="16" month="6" year="2023"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="num_reviews">14</client_attr>
      </attributes>
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main hotel picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

Valori per il segnaposto attribute_name

La seguente tabella fornisce un elenco di valori validi per attribute_name nell'elemento <client_attr name="attribute_name">; tuttavia, è consigliabile fornire l'attribute_name aggiuntivo, se disponibile.

Valori per attribute_name Obbligatorio? Descrizione Valori validi dei contenuti
capacity Required Numero massimo di ospiti consentito per la proprietà. Questo valore deve essere uguale o maggiore di "number_of_bedrooms". Non-negative integer value
website Required L'URL del sito web della proprietà. Free text
partner_hygiene_link Strongly recommended Link al sito esterno del partner che fornisce ulteriori informazioni sui dettagli legati all'igiene della proprietà. Free text (the site's URL)
number_of_bathrooms Strongly recommended Numero di bagni. Non-negative float value, for example, 1, 1.5, 2
number_of_bedrooms Strongly recommended Numero di camere da letto. Non-negative integer value
number_of_beds Strongly recommended Numero di letti in tutte le camere. Non-negative integer value
self_checkin_checkout Recommended Indica se la proprietà consente il self check-in e il self check-out. Yes/No/Unknown
rating Strongly recommended Un numero in virgola mobile che rappresenta la valutazione complessiva della proprietà. Generalmente questo numero è compreso tra 0 e 5, tra 0 e 10 o tra 0 e 100, ma puoi utilizzare qualsiasi intervallo che rappresenti il tuo sistema di valutazione. Non-negative float value
rating_num Strongly recommended Numero di valutazioni della proprietà. Non-negative integer value
rating_scale Strongly recommended Valutazione massima possibile per una proprietà. Ad esempio, la valutazione della proprietà deve essere 3 o 4 per una scala di valutazione di 5.

Nota: se non specificata, la scala di valutazione predefinita è 0-10.

Non-negative integer value
instant_bookable Strongly recommended Indica se la proprietà può essere prenotata subito tramite la procedura di pagamento. L'alternativa è attendere l'approvazione. Yes/No/Unknown
description Strongly recommended Testo in formato libero che descrive le qualità uniche della proprietà Free text
category Strongly recommended Il tipo di proprietà, ad esempio villa, bungalow, baita o appartamento Free text
ac Recommended Indica se la proprietà è dotata di aria condizionata. Yes/No/Unknown
beach_access Recommended Indica se la proprietà ha accesso a una spiaggia pubblica nelle vicinanze. Yes/No/Unknown
check_in_time Recommended L'ora del giorno esatta per il check-in nella proprietà. Sono accettati i formati HHMM, HH:MM o HH:MM:SS. Ad esempio, utilizza 14:00 anziché 14:00 o 14:00. Tutti gli altri formati non verranno analizzati o visualizzati. Time
check_out_time Recommended L'ora del giorno esatta per il check-out dalla proprietà. Sono accettati i formati HHMM, HH:MM o HH:MM:SS. Ad esempio, utilizza 11:00 anziché 11:00 o 11:00. Tutti gli altri formati non verranno analizzati o visualizzati. Time
child_friendly Recommended Indica se la proprietà è adatta ai bambini. Yes/No/Unknown
crib Recommended Indica se la proprietà fornisce una culla. Yes/No/Unknown
elevator Recommended Indica se la proprietà è dotata di ascensore. Yes/No/Unknown
gym_fitness_equipment Recommended Indica se la proprietà ha una palestra o qualsiasi attrezzatura per il fitness. Yes/No/Unknown
heating Recommended Indica se la proprietà è dotata di riscaldamento. Yes/No/Unknown
hot_tub Recommended Indica se la proprietà è dotata di vasca idromassaggio. Yes/No/Unknown
ironing_board Recommended Indica se la proprietà è dotata di ferro e asse da stiro. Yes/No/Unknown
kitchen Recommended Indica se la proprietà è dotata di cucina. Yes/No/Unknown
microwave Recommended Indica se la proprietà è dotata di forno a microonde. Yes/No/Unknown
min_days_advance_purchase Recommended Numero minimo di giorni di anticipo con cui è possibile prenotare la proprietà. Non-negative integer value
min_night_stay Recommended Numero minimo di notti per cui un ospite può prenotare la proprietà. Positive integer (more than zero)
max_night_stay Recommended Numero massimo di notti per cui un ospite può prenotare la proprietà. Positive integer (more than zero)
outdoor_grill Recommended Indica se la proprietà ha una griglia per barbecue. Yes/No/Unknown
oven_stove Recommended Indica se la proprietà è dotata di piano cottura. Yes/No/Unknown
parking_type Recommended Tipo di parcheggio disponibile nella proprietà. Free/Paid/None
patio Recommended Indica se la proprietà è dotata di un patio. Yes/No/Unknown
pets_allowed Recommended Alcune o tutte le camere consentono agli ospiti di portare con sé animali domestici, ovvero cani o gatti che non sono animali di servizio. Yes/No/Unknown
pool_type Recommended Tipo di piscina (accesso alla piscina) di cui è dotata la proprietà. Indoors, Outdoors, Indoors/Outdoors, None
room_type Recommended Il tipo di camera. ENTIRE_PLACE è l'unico valore supportato. ENTIRE_PLACE
smoking_free_property Recommended Indica se la struttura è per non fumatori o se è vietato fumare. Yes/No/Unknown
special_service_level Recommended Indica se il livello di servizio della scheda è speciale in qualche modo. Ad esempio, verified, luxury, premium Yes/No/Unknown
square_footage Recommended La superficie della proprietà in piedi quadrati. Non-negative float value
square_meters Recommended La superficie della proprietà in metri quadrati. Non-negative float
tv Recommended Indica se la proprietà è dotata di TV. Yes/No/Unknown
washer_dryer Recommended Indica se la proprietà è dotata di lavatrice/asciugatrice. Yes/No/Unknown
wheelchair_accessible Recommended Indica se la proprietà è accessibile in sedia a rotelle. Yes/No/Unknown
internet_type Recommended Tipo di accesso a internet Wi-Fi fornito dalla proprietà. Free/Paid/None
airport_shuttle Optional Indica se l'host fornisce il trasporto da o per l'aeroporto o altri terminal. Yes/No/Unknown
balcony Optional Indica se la proprietà ha un balcone. Yes/No/Unknown
fire_place Optional Indica se la proprietà include un camino. Yes/No/Unknown
free_breakfast Optional Indica se la colazione è inclusa nel prezzo. Yes/No/Unknown
host_description Optional Descrizione dell'host della casa vacanze. Free text
host_language Optional Lingue parlate dall'host. Un elenco separato da virgole di codici lingua; ad esempio: de, en
host_name Optional Nome dell'host della casa vacanze. Free text
host_response_rate Optional Tasso di risposta medio dell'host. Non-negative float value, for example, 1, 0.75, 0.5
host_response_time Optional Tempo medio di risposta dell'host. Free text
license_num Optional Numero di licenza (turistica o aziendale) la cui indicazione è obbligatoria per le proprietà in alcune regioni del mondo. Può essere ripetuto e, se esistono più licenze, suggeriamo di aggiungere l'autorità che ha emesso la licenza come contesto; ad esempio: "Parigi: 123456ABC". Free text
number_of_half_bathrooms Optional Numero di mezzi bagni. Non-negative integer value
number_of_living_rooms Optional Numero di salotti. Non-negative integer value
private_beach_access Optional Indica se la proprietà ha accesso dedicato a una spiaggia non pubblica. Yes/No/Unknown
refund_policy Optional Norme sui rimborsi per la proprietà. Free text

Elementi secondari XML

Sono obbligatori i seguenti elementi secondari XML:

Elemento secondario Obbligatorio? Tipo Descrizione
<country> Strongly recommended string Il paese in cui si trova questa scheda. Il valore deve essere un codice paese ISO 3116 di due lettere; ad esempio, gli Stati Uniti sono US e il Canada è CA: 
    <country>US</country>
<id> Required string L'identificatore univoco della proprietà. Tieni presente che ogni casa vacanze deve avere un ID univoco per il tuo sito e che questo ID non deve mai essere riutilizzato.
<latitude> Required float La latitudine corrispondente alla posizione dell'hotel. Ecco alcuni esempi: 
    <latitude>37.423738</latitude>

Questo valore può essere generato con strumenti di geocodifica come l'API di Google Maps.
<longitude> Required float La longitudine corrispondente alla posizione dell'hotel. Ecco alcuni esempi: 
    <longitude>-122.090101</longitude>

Questo valore può essere generato con strumenti di geocodifica come l'API di Google Maps.
<name> Required string Il nome della proprietà. Massimo 300 caratteri.
<address> Required string or Object

La posizione fisica completa della proprietà come stringa. L'indirizzo deve includere il nome e il numero di una via. Se non esiste, l'indirizzo deve includere un Plus Code. Se applicabile, devono essere inclusi anche i numeri di appartamenti o unità.

In alternativa, puoi fornire un indirizzo "composito". Utilizza gli elementi secondari <component> per descrivere ognuna delle seguenti parti dell'indirizzo:

  • addr1: l'indirizzo civico principale.
  • addr2: se necessario, la seconda parte dell'indirizzo, incluso il numero dell'unità.
  • city: la città.
  • province: se necessario, lo stato, la regione o la provincia.
  • postal_code: il codice postale.
  • country: il paese

Caselle postali e altri indirizzi solo postali non sono considerati indirizzi fisici completi.

Ecco alcuni esempi di indirizzi completi:

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

Ecco alcuni esempi di indirizzi completi che utilizzano un plus code:

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

Evita quanto segue:

  • Informazioni ridondanti: non includere informazioni non pertinenti o ripetere i componenti dell'indirizzo.
  • Indirizzo mancante: gli indirizzi devono contenere il nome e il numero della via.

Esempio di scheda di case vacanze

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