Attributi

Questa pagina illustra 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 degli hotel. Consulta Riferimento XML per l'elenco hotel.

La mancata inclusione dei seguenti elementi obbligatori disattiva automaticamente la scheda:

• Elementi secondari XML obbligatori: id, name, latitude, longitude, address.
• Attributi obbligatori: capacity e website. Consulta i link diretti per le case vacanze nel feed di schede. Ciò offre agli utenti la possibilità di visitare il sito web della proprietà.

Per informazioni dettagliate sugli elementi secondari XML richiesti, consulta la sezione Elementi secondari XML.

Per ulteriori informazioni sulle case vacanze, consulta la pagina Attributi univoci per le case vacanze.

Infine, quando Google determina da altre fonti che il valore di un attributo è diverso da quello specificato nel feed relativo alla scheda di una casa vacanze, mostra il valore della scheda. Ad esempio, se Google rileva dalle foto di una scheda che la scheda 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 c'è un'elevata affidabilità nella precisione dell'inferenza.

Punto chiave: per le case vacanze, i comfort vengono forniti tramite gli attributi del feed elenco hotel.

Valori per il segnapostoattribute_name

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

Valori per attribute_name	Campo obbligatorio?	Descrizione	Valori di contenuto validi
capacity	Required	Numero massimo di ospiti consentito dalla struttura. Questo valore deve essere uguale o maggiore di "numero_di_camere_da_letto".	Non-negative integer value
website	Required	L'URL del sito web della struttura.	Free text
partner_hygiene_link	Strongly recommended	Link al sito esterno del partner che fornisce ulteriori informazioni sui dettagli di igiene della scheda.	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 check-in e il check-out autonomamente.	Yes/No/Unknown
rating	Strongly recommended	Un numero con rappresentazione in virgola mobile che rappresenta la valutazione complessiva della proprietà. In genere 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 classificazione.	Non-negative float value
rating_num	Strongly recommended	Numero di valutazioni della struttura.	Non-negative integer value
rating_scale	Strongly recommended	Valutazione massima possibile per una proprietà	Non-negative integer value
instant_bookable	Strongly recommended	Indica se la proprietà è prenotabile immediatamente tramite la procedura di check-out. 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	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 mostrati.	Time
check_out_time	Recommended	Ora del giorno esatta per il check-out dalla proprietà. Formato HHMM, HH:MM o HH:MM:SS accettato; ad esempio, utilizza 11:00 anziché 11:00 o 11:00. Tutti gli altri formati non verranno analizzati o mostrati.	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à dispone di una palestra o di attrezzature 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 in cui un ospite può prenotare la proprietà.	Positive integer (more than zero)
max_night_stay	Recommended	Numero massimo di notti che 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 stufa.	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 (cani o gatti non animali di servizio).	Yes/No/Unknown
pool_type	Recommended	Tipo di piscina (accesso alla piscina) di cui dispone la proprietà.	Indoors, Outdoors, Indoors/Outdoors, None
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 è in qualche modo speciale. Ad esempio, verified, luxury, premium	Yes/No/Unknown
square_footage	Recommended	L'area della proprietà in piedi quadrati.	Non-negative float value
square_meters	Recommended	L'area 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 verso 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'organizzatore.	Un elenco di codici lingua separati da virgole, 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	Il numero di licenza (turistico o aziendale) deve essere mostrato per le proprietà in determinate regioni del mondo. Può essere ripetuto e, se esistono più licenze, suggeriamo di aggiungere l'autorità della licenza come contesto, ad esempio: "Parigi: 123456ABC".	Free text
number_of_half_bathrooms	Optional	Numero di bagni di servizio.	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 della proprietà.	Free text

Elementi XML secondari

Sono necessari i seguenti elementi XML secondari:

Elemento secondario	Campo obbligatorio?	Tipo	Descrizione
<country>	Strongly recommended	string	Il paese in cui si trova questa scheda. Il valore deve essere un codice paese ISO 3116 a due lettere; ad esempio, gli Stati Uniti sono US e il Canada è CA: <country>US</country>
<id>	Required	string	L'identificatore univoco della struttura. Tieni presente che ogni casa vacanze deve avere un ID univoco per il tuo sito, che non deve mai essere riutilizzato.
<latitude>	Required	float	La latitudine corrispondente alla posizione dell'hotel. Ad esempio: <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. Ad esempio: <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 struttura. Massimo 300 caratteri.
<address>	Required	Object or string	La posizione fisica completa della proprietà. Questo elemento utilizza un singolo attributo, format, che devi impostare su simple. Come minimo, devi fornire via, città, stato o regione e codice postale della proprietà. Utilizza gli elementi secondari <component> per descrivere ognuna delle seguenti parti dell'indirizzo: addr1: l'indirizzo principale della proprietà. addr2: la via secondaria, incluso il numero di unità, se necessario. addr3: terza parte dell'indirizzo. city: il nome della città della proprietà. province: il nome dello stato, della regione o della provincia della proprietà. postal_code: il codice postale della proprietà. Ad esempio: <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> In alternativa, puoi fornire un indirizzo in "formato libero", anche se non è consigliabile. Ad esempio: <address>6 Elm Ave Unit 3, Boston, MA, 02472</address> Caselle postali e altri indirizzi solo postali non sono considerati indirizzi fisici completi.

Esempio di elenco 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>