Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Flux de points d'intérêt (POI)

Cette page détaille les caractéristiques techniques du flux de points d'intérêt (POI). Il comprend un résumé des champs obligatoires, des définitions de schéma complètes et un exemple JSON pour vous guider dans l'implémentation.

Spécifications du flux

Cette section décrit les exigences et les définitions du flux de POI.

Exigences relatives aux champs

Nom du champ	Exigence	Description
poi_id	Obligatoire	Chaîne générée par le partenaire qui identifie un point d'intérêt (établissement).
nom	Obligatoire	Nom du point d'intérêt. Ce nom sera utilisé comme nom à afficher de l'établissement dans l'unité agrégateurs.
telephone	Souhaitable	Numéro de téléphone du point d'intérêt, y compris l'indicatif du pays et de la zone, par exemple +14567891234.
url	Souhaitable	URL du site Web public du point d'intérêt. Remarque : Ces informations ne seront utilisées qu'à des fins de mise en correspondance, et non d'affichage.
position	Obligatoire (adresse) Souhaitable (latitude/longitude)	Emplacement du point d'intérêt. Obligatoire : l'adresse et les champs associés sont obligatoires pour que l'établissement soit correctement mis en correspondance. Facultatif : la latitude et la longitude. Si vous les fournissez, Google utilisera la latitude et la longitude pour afficher les repères des établissements sur la carte de votre unité agrégateurs.
images	Obligatoire (une image) Souhaitable (plusieurs images)	Images du POI. Les images seront importantes pour l'affichage des établissements. Nous vous recommandons vivement d'ajouter au moins une image. Vous pouvez fournir jusqu'à cinq images. Si plusieurs images sont fournies, elles seront utilisées dans l'ordre dans lequel elles ont été fournies (au cas où une image serait inutilisable). Les images seront examinées pour s'assurer qu'elles ne violent pas les Règles de Google concernant SafeSearch.
rating	Recommandé	Note moyenne de l'établissement.
num_ratings	Recommandé	Nombre de notes contribuant au champ `rating`.
rating_scale	Souhaitable	Échelle d'évaluation utilisée pour le champ `rating`. Si la note maximale est de 5, la valeur de rating_scale est 5.
catégorie	Souhaitable	Représente la catégorie de l'établissement.
hotel_data	Souhaitable	Champs spécifiques à l'hôtel. Pour en savoir plus, consultez Définition de HotelData.
hotel_star_class	Recommandé	Nombre d'étoiles officiel de la catégorie d'hôtel. Cette valeur doit être un entier compris entre 0 et 5. Si votre système utilise des demi-étoiles ou des valeurs décimales (par exemple, `3.5`), arrondissez à l'entier inférieur (`3`). Veuillez indiquer la valeur 0 si la classe d'étoiles n'est pas disponible, est inconnue ou n'est pas spécifiée. Si la valeur est définie sur 0, aucune classe d'hôtel ne s'affiche dans l'interface utilisateur.
brand_ids	Souhaitable	Marques pouvant afficher cet hôtel. Si ce champ est vide, l'hôtel peut être affiché sous l'une des marques associées au flux.
description	Souhaitable	Description détaillée de l'établissement.
display_address	Souhaitable	L'adresse affichée dans l'UI.

Consignes concernant les images

Toutes les images ajoutées au flux doivent respecter les consignes suivantes :

Format : JPEG, PNG ou WebP.
Taille maximale du fichier : moins de 30 Mo par image.
Dimensions maximales : moins de 75 mégapixels au total (largeur x hauteur < 75 000 000).
Type d'URL : chemin d'accès direct au composant Image (par exemple, se terminant par .jpg).
Autorisations : assurez-vous que le serveur d'hébergement et le fichier robots.txt autorisent l'accès aux user-agents Googlebot et Googlebot-Image, et qu'ils ne bloquent pas les répertoires d'images.

Assistance multilingue

Le flux de points d'intérêt permet de fournir du contenu localisé pour des champs spécifiques. Les champs suivants sont de type Text et sont compatibles avec la localisation :

name
description
display_address

Pour fournir du contenu dans plusieurs langues, vous devez spécifier un default_locale dans le champ et fournir les chaînes localisées dans la liste localizations. Fournissez toutes les localisations d'un établissement dans une seule entrée de POI. Ne divisez pas une même propriété entre plusieurs fichiers JSON de langue.

Exemple :

"name": {
  "localizations": [
    {
      "locale": "en",
      "text": "Banana Hotel"
    },
    {
      "locale": "es",
      "text": "Hotel Plátano"
    }
  ],
  "default_locale": "en"
}

Consignes concernant les packages de fichiers

Pour garantir une ingestion réussie, respectez les exigences d'empaquetage suivantes :

Archive JSON agrégée unique (obligatoire) : combinez tous les enregistrements de propriété dans un seul fichier JSON. Nous vous recommandons de le compresser dans une seule archive GZIP et de l'importer.
Avertissement concernant les antimodèles : n'utilisez pas un fichier par établissement ni plusieurs fichiers séparés par pays dans la même archive. Cette approche n'est pas acceptée et entraînera des échecs d'extraction.

Définitions

Définition de VssPoiFeed

// Represents a Point of Interest (POI) data feed provided by a partner.
export message VssPoiFeed {
  // The POIs in the feed.
  repeated VssPoi data = 1;
}

Définition de VssPoi

// Represents a single Point of Interest (POI) entity e.g. a hotel or
// restaurant.
export message VssPoi {
  // Required. A string generated by the partner that identifies a POI.
  string poi_id = 1;

  // The entity name, telephone, url and location are used to support
  // matching partner inventory with entities already present on Google.

  // Required. The name of the POI.
  Text name = 2;

  // The contact telephone number of the POI including its country and
  // area codes, e.g. +14567891234.
  string telephone = 3 [(datapol.semantic_type) = ST_PHONE_NUMBER];

  // The url of the POI's public website.
  // Note: This will be used just for matching purposes, not for display.
  string url = 4;

  // Required. The location of the POI.
  GeoCoordinates location = 5;

  // The address displayed on the UI.
  Text display_address = 17;

  // Images of the POI.
  // Max number of images: 5.
  repeated Image images = 6;

  // Average rating for the POI.
  float rating = 12;

  // The number of contributing ratings for the `rating` field.
  int64 num_ratings = 13;

  // The rating scale used for the `rating` field. If max rating is 5, then
  // rating_scale is 5.
  int32 rating_scale = 14;

  // Represents the category of the POI.
  // It should match the `additional_data` oneof field below.
  export enum Category {

    UNKNOWN_CATEGORY = 0;
    HOTEL = 1;

    LOCAL = 4;
  }

  // Required. Represents the category of the POI.
  Category category = 9;

  // A description of the POI.
  Text description = 16;

  // Required. Category specific fields.
  // It should match the `category` field above.
  oneof additional_data {
    // Hotel specific fields.
    HotelData hotel_data = 10;


    // Local specific fields.
    LocalData local_data = 15;
  }

}

Text – Définition

// Represents a text with localizations.
message Text {
  // Represents a localized string.
  message LocalizedString {
    // The text's language tag, such as "en", "en-US" or "sr-Latn".
    string locale = 1;

    // The text in the specified locale.
    string text = 2;
  }

  // The localized strings.
  repeated LocalizedString localizations = 1;

  // The locale to use as the default language it must be present in the
  // localizations.
  string default_locale = 2;
}

GeoCoordinates – Définition

// The Geo data of a location, including latitude, longitude, and address.
message GeoCoordinates {
  option (datapol.msg_semantic_type) = ST_LOCATION;

  // [-90, +90] degrees (inclusive).
  // Required if longitude is set, otherwise nice to have.
  double latitude = 1;

  // [-180, +180] degrees (inclusive).
  // Required if latitude is set, otherwise nice to have.
  double longitude = 2;

  // Required. Address for a location.
  oneof addresses {
    // Postal address of the location.
    PostalAddress address = 3;

  }
}

Définition des adresses postales

// The postal address for the location.
message PostalAddress {
  option (datapol.msg_semantic_type) = ST_LOCATION;

  // Required. The country, using ISO 3166-1 alpha-2 country code, e.g. "US".
  string country = 1;

  // Required. The locality/city, e.g. "Mountain View".
  string locality = 2;

  // The region/state/province, e.g. "CA". This field is only required in
  // countries where region is commonly a part of the address. (optional)
  string region = 3;

  // Required. The postal code, e.g. "94043".
  string postal_code = 4;

  // Required. The street address, e.g. "1600 Amphitheatre Pkwy".
  string street_address = 5;
}

Définition de l'image

// Represents an image of the Point of Interest (POI).
export message Image {
  // The url of the image. Google will crawl the media hosted at this URL.
  // Max length: 2000.
  string url = 1;

  // The alternative text to be used for accessibility.
  Text alt_text = 2;
}

Définition de HotelData

// Hotel specific feed data.
message HotelData {
  // The official hotel class star value.
  // Can be used in a label like "5-star hotel."
  // This value is expected to be an integer between 0 and 5. A rating of 0
  // should be used if a rating is unavailable or not specified. When
  // set to 0, no star class will be displayed on the UI for users.
  int32 hotel_star_class = 1;

  // Deprecated. Use `brand_landing_pages` instead.
  //
  // The brands that can display this hotel.
  // If this field is empty, the hotel can be displayed under any of the
  // brands associated with the feed.
  repeated string brand_ids = 2
      [(datapol.semantic_type) = ST_PARTNER_ID, deprecated = true];

  // The brand landing pages.
  repeated BrandLandingPages brand_landing_pages = 3;
}

Exemples