Configurer une liste d'hôtels au format XML

Cet article explique comment créer une liste d'hôtels au format XML et héberger le flux XML sur votre serveur (ou technique appelée "Extraction de la liste d'hôtels") afin que Google puisse le télécharger selon le planning que vous demandez. Pour découvrir les autres méthodes de configuration d'une liste d'hôtels, consultez la page Configurer votre inventaire d'hôtels.

Cet article comporte les sections suivantes :

À propos des listes d'hôtels au format XML

Un fichier de liste d'hôtels contient des données descriptives, telles que le nom de l'établissement, son adresse et son géocode, organisées par établissement, pour tous les établissements d'un compte Hotel Center.

Vous trouverez ci-dessous un exemple très simple de fichier de liste d'hôtels au format XML. Cet exemple n'illustre qu'un seul des multiples éléments <listing> spécifiés dans le fichier. Chaque élément <listing> représente un établissement.

<?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>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <address format="simple">
      <component name="addr1">666 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>
    <country>UK</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
  </listing>
  ...
</listings>

Créer une liste d'hôtels au format XML

Pour créer un flux Hotel List Feed au format XML :

  1. Consultez les Conditions requises pour les fichiers.
  2. Codez vos fichiers comme décrit dans la documentation de référence pour les listes d'hôtels au format XML.
  3. Validez les fichiers à l'aide du schéma de flux Hotel List Feed.

Une fois vos fichiers validés, hébergez le flux sur votre serveur comme décrit dans la section suivante. Si vous avez décidé d'importer votre liste dans Hotel Center, consultez plutôt la section Importer une liste d'hôtels.

Héberger le flux XML sur votre serveur

Vous pouvez héberger votre liste d'hôtels sur votre serveur, et Google le téléchargera régulièrement (en procédant à une "extraction") depuis le serveur à la fréquence que vous avez choisie. Ce mode d'envoi est appelé "Extraction de la liste d'hôtels".

Une fois que vous avez créé votre liste d'hôtels et validé ses fichiers XML, procédez comme suit :

  1. Préparez les fichiers que Google doit télécharger, comme décrit dans la section Conditions requises pour l'hébergement.
  2. Contactez votre responsable de compte technique (TAM) pour :
    • Déterminer un planning de récupération. Google récupère et ingère automatiquement le fichier disponible à un rythme régulier (généralement une fois par semaine).
    • Indiquer votre URL de téléchargement et vos conditions requises pour l'authentification.

S'il n'y a pas d'erreur, votre liste d'hôtels est publiée. Tous les établissements mis en correspondance dans Google Maps sont affichés dans l'onglet "Établissements" de votre compte Hotel Center.

En cas d'erreurs, Google vous les transmet pour que vous puissiez les corriger et préparer à nouveau les fichiers pour le téléchargement.

Conditions requises pour l'hébergement

Cette section répertorie les conditions requises suivantes pour l'hébergement de votre flux XML :

Conditions requises pour le serveur

  • Hébergez votre flux XML sur votre serveur. Celui-ci doit être accessible via HTTP ou HTTPS.

Conditions requises pour le répertoire

Pour vous assurer que Google récupère un instantané complet de vos données et ne tente pas de télécharger des fichiers incomplets, suivez ces consignes lorsque vous publiez des fichiers sur votre serveur HTTP :

  • Développez et validez les fichiers XML de votre flux dans un répertoire à partir duquel Google ne récupère pas de contenu (autrement dit, pas dans le répertoire de "téléchargement").
  • Une fois que vous avez validé les fichiers XML de votre flux, créez un lien symbolique dans un répertoire à partir duquel Google télécharge le contenu. Ce lien doit rediriger vers le flux créé.
  • Si vous fournissez un fichier ZIP, incluez le ou les fichiers XML au niveau racine, et non dans le répertoire de téléchargement.

Conditions requises pour les fichiers

  • Créez vos fichiers dans un répertoire à partir duquel Google ne récupère pas de contenu.
  • Utilisez des fichiers en texte brut (c'est-à-dire pas des fichiers de type Microsoft Word).
  • Vérifiez qu'aucun fichier XML non compressé ne dépasse 100 Mo. Un ou plusieurs fichiers XML peuvent être compressés dans un seul fichier ZIP. La taille des fichiers XML compressés et des fichiers ZIP n'est pas limitée.
  • Nommez les fichiers comme suit :
    • <partner_name>_local.xml (pour un seul fichier XML)
    • <partner_name>_local.xml.zip (pour un ou plusieurs fichiers XML dans un fichier ZIP. Vous pouvez nommer les fichiers XML individuels du fichier ZIP comme bon vous semble, mais nous vous recommandons d'ajouter un code de langue à chaque nom de fichier.)

Conditions requises pour l'authentification

  • Vous pouvez éventuellement sécuriser vos fichiers avec un nom d'utilisateur et un mot de passe, à l'aide de l'authentification BASIC ou DIGEST (actuellement, le protocole NTLM n'est pas accepté).