Cette page présente les descriptions, les valeurs et les exigences pour les attributs et les éléments enfants. Ces valeurs ne s'appliquent qu'aux locations de vacances.
La structure XML générale se présente de la même manière que les flux pour les fiches d'hôtels. Consultez la documentation de référence pour les listes d'hôtels au format XML.
Si vous n'incluez pas les éléments obligatoires suivants, la fiche est automatiquement désactivée:
- Éléments enfants XML obligatoires:
id
,name
,latitude
,longitude
,address
. - Attributs obligatoires:
capacity
etwebsite
. Consultez les liens directs pour les locations de vacances dans votre flux de fiches. Cela permet aux utilisateurs de visiter le site Web de l'établissement.
Pour en savoir plus sur les éléments enfants XML requis, consultez la section Éléments enfants XML.
Pour en savoir plus sur les locations de vacances, consultez la section Attributs spécifiques aux locations de vacances.
Enfin, lorsque Google détermine à partir d'autres sources que la valeur d'un attribut est différente de celle spécifiée dans le flux d'une fiche de location de vacances, Google affiche la valeur de la fiche. Par exemple, si Google détermine à partir des photos d'une fiche qu'elle possède une cuisine, mais que l'attribut kitchen
est absent ou défini sur No
, Google considère que la fiche comporte une cuisine. Ces attributs sont appelés "attributs déduits" et ne s'affichent que lorsque la précision de l'inférence est très fiable.
Valeurs de l'espace réservé "attribute_name"
Le tableau suivant fournit une liste de valeurs valides pour attribute_name
dans l'élément <client_attr name="attribute_name">
. Toutefois, nous vous recommandons de fournir votre attribute_name
supplémentaire s'il est disponible.
Valeurs pour attribute_name |
Requis ? | Description | Valeurs de contenu valides |
---|---|---|---|
capacity | Required | Nombre maximal de personnes que l'établissement peut accueillir. Cette valeur doit être supérieure ou égale à "nombre_de_chambres". | Non-negative integer value |
website | Required | URL du site Web de l'établissement. | Free text |
partner_hygiene_link | Strongly recommended | Lien vers le site externe du partenaire fournissant plus d'informations sur l'hygiène de la fiche. | Free text (the site's URL) |
number_of_bathrooms | Strongly recommended | Nombre de salles de bain. | Non-negative float value, for example, 1, 1.5, 2 |
number_of_bedrooms | Strongly recommended | Nombre de chambres. | Non-negative integer value |
number_of_beds | Strongly recommended | Nombre de lits dans toutes les chambres. | Non-negative integer value |
self_checkin_checkout | Recommended | Indique si l'établissement autorise l'arrivée et le départ sans hésiter. | Yes/No/Unknown |
rating | Strongly recommended | Nombre à virgule flottante représentant la note globale de l'établissement. Ce nombre est généralement compris entre 0 et 5, entre 0 et 10, ou entre 0 et 100, mais vous pouvez utiliser n'importe quelle plage qui représente votre système de notation. | Non-negative float value |
rating_num | Strongly recommended | Nombre de notes attribuées à l'établissement. | Non-negative integer value |
rating_scale | Strongly recommended | Note maximale possible pour un établissement | Non-negative integer value |
instant_bookable | Strongly recommended | Indique si l'établissement peut être réservé instantanément via le processus de départ. L'alternative est l'attente d'approbation. | Yes/No/Unknown |
description | Strongly recommended | Texte à forme libre décrivant les qualités uniques de la propriété | Free text |
category | Strongly recommended | Type de logement (villa, bungalow, cabane ou appartement, par exemple) | Free text |
ac | Recommended | Indique si l'établissement est climatisé. | Yes/No/Unknown |
beach_access | Recommended | Indique si l'établissement a accès à une plage publique à proximité de l'établissement. | Yes/No/Unknown |
check_in_time | Recommended | Heure exacte de la journée d'arrivée dans l'établissement. HHMM, HH:MM ou HH:MM:SS Les autres formats ne seront ni analysés, ni affichés. | Time |
check_out_time | Recommended | Heure exacte de départ de l'établissement. Le format HHMM, HH:MM ou HH:MM:SS est accepté. Par exemple, utilisez 11:00 au lieu de 11am ou 11:00am. Les autres formats ne seront ni analysés, ni affichés. | Time |
child_friendly | Recommended | Indique si l'établissement est adapté aux enfants. | Yes/No/Unknown |
crib | Recommended | Indique si l'établissement fournit un berceau. | Yes/No/Unknown |
elevator | Recommended | Indique si l'établissement dispose d'un ascenseur. | Yes/No/Unknown |
gym_fitness_equipment | Recommended | Indique si l'établissement dispose d'une salle de sport ou d'équipements de fitness. | Yes/No/Unknown |
heating | Recommended | Indique si l'établissement dispose du chauffage. | Yes/No/Unknown |
hot_tub | Recommended | Indique si l'établissement dispose d'un bain à remous. | Yes/No/Unknown |
ironing_board | Recommended | Indique si l'établissement propose des planches à repasser. | Yes/No/Unknown |
kitchen | Recommended | Indique si l'établissement est équipé d'une cuisine. | Yes/No/Unknown |
microwave | Recommended | Indique si un four à micro-ondes est disponible dans l'établissement. | Yes/No/Unknown |
min_days_advance_purchase | Recommended | Nombre minimal de jours à l'avance pendant lesquels l'établissement peut être réservé. | Non-negative integer value |
min_night_stay | Recommended | Nombre minimal de nuits pendant lesquelles un client peut réserver l'établissement. | Positive integer (more than zero) |
max_night_stay | Recommended | Nombre maximal de nuits pendant lesquelles un client peut réserver l'établissement. | Positive integer (more than zero) |
outdoor_grill | Recommended | Indique si l'établissement est doté d'un barbecue. | Yes/No/Unknown |
oven_stove | Recommended | Indique si la propriété est équipée d'un poêle. | Yes/No/Unknown |
parking_type | Recommended | Type de parking disponible dans l'établissement. | Free/Paid/None |
patio | Recommended | Indique si l'établissement possède un patio. | Yes/No/Unknown |
pets_allowed | Recommended | Certaines chambres ou toutes les chambres permettent aux clients d'emmener avec eux des animaux de compagnie (chiens ou chats autres que des animaux d'assistance). | Yes/No/Unknown |
pool_type | Recommended | Type de piscine (accès à la piscine) dont dispose l'établissement. | Indoors, Outdoors, Indoors/Outdoors, None |
smoking_free_property | Recommended | Indique si l'établissement est non-fumeur ou non-fumeur. | Yes/No/Unknown |
special_service_level | Recommended | Indique si le niveau de service de la fiche est spécial d'une manière ou d'une autre.
Exemples : verified , luxury , premium |
Yes/No/Unknown |
square_footage | Recommended | Superficie de la propriété en pieds carrés. | Non-negative float value |
square_meters | Recommended | Surface de la propriété en mètres carrés. | Non-negative float |
tv | Recommended | Indique si l'établissement est équipé d'une télévision. | Yes/No/Unknown |
washer_dryer | Recommended | Indique si l'établissement est équipé d'appareils de buanderie. | Yes/No/Unknown |
wheelchair_accessible | Recommended | Indique si l'établissement est accessible en fauteuil roulant. | Yes/No/Unknown |
internet_type | Recommended | Type d'accès Internet Wi-Fi fourni par l'établissement. | Free/Paid/None |
airport_shuttle | Optional | Indique si l'hôte assure le transport depuis ou vers l'aéroport ou d'autres terminaux. | Yes/No/Unknown |
balcony | Optional | Indique si l'établissement possède un balcon. | Yes/No/Unknown |
fire_place | Optional | Indique si l'établissement est doté d'une cheminée. | Yes/No/Unknown |
free_breakfast | Optional | Indique si l'établissement propose un petit-déjeuner gratuit. | Yes/No/Unknown |
host_description | Optional | Description de l'hébergeur de la location de vacances. | Free text |
host_language | Optional | Langues parlées par l'organisateur. | Liste de codes de langue séparés par une virgule. Par exemple: de , en |
host_name | Optional | Nom de l'hébergeur de la location de vacances. | Free text |
host_response_rate | Optional | Taux de réponse moyen de l'hôte. | Non-negative float value, for example, 1, 0.75, 0.5 |
host_response_time | Optional | Temps de réponse moyen de l'hôte. | Free text |
license_num | Optional | Numéro de licence (tourisme ou affaires) devant être indiqué pour les établissements de certaines régions du monde. Il pourrait être répété et, si plusieurs licences existent, nous vous suggérons d'ajouter l'autorité de la licence en tant que contexte. Par exemple: "Paris: 123456ABC". | Free text |
number_of_half_bathrooms | Optional | Nombre de demi-salles de bain. | Non-negative integer value |
number_of_living_rooms | Optional | Nombre de salles de séjour. | Non-negative integer value |
private_beach_access | Optional | Indique si l'établissement dispose d'un accès dédié à une plage non publique. | Yes/No/Unknown |
refund_policy | Optional | Conditions de remboursement de l'établissement. | Free text |
Éléments enfants XML
Les éléments enfants XML suivants sont obligatoires:
Élément enfant | Requis ? | Type | Description |
---|---|---|---|
<country> | Strongly recommended | string | Pays dans lequel se trouve cette fiche. La valeur doit être un code pays à deux lettres ISO 3116. Par exemple, les États-Unis sont US et le Canada est CA : <country>US</country> |
<id> | Required | string | Identifiant unique de l'établissement. Notez que chaque location de vacances doit posséder un identifiant propre à votre site, et que cet identifiant ne doit jamais être réutilisé. |
<latitude> | Required | float | Latitude de l'emplacement de l'hôtel. Exemple :
<latitude>37.423738</latitude> Cette valeur peut être générée à l'aide d'outils de geocoding tels que l'API Google Maps. |
<longitude> | Required | float | Longitude de l'emplacement de l'hôtel. Exemple :
<longitude>-122.090101</longitude> Cette valeur peut être générée à l'aide d'outils de geocoding tels que l'API Google Maps. |
<name> | Required | string | Nom de la propriété. 300 caractères maximum. |
<address> | Required | Object or string | Emplacement physique complet de l'établissement. Cet élément accepte un seul attribut, Vous devez au moins indiquer l'adresse postale, la ville, l'État ou la région et le code postal de l'établissement. Utilisez les éléments enfants
Exemple : <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> Bien que cela ne soit pas recommandé, vous pouvez également fournir une adresse au format libre. Exemple : <address>6 Elm Ave Unit 3, Boston, MA, 02472</address> Notez que les boîtes postales et les autres adresses de réception de courrier ne sont pas considérées comme des adresses physiques à part entière. |
Exemple de fiches de locations de vacances
<?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>