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)

Créer et importer des flux de points d'intérêt

Lorsque vous créez et importez des flux de POI, suivez ces instructions :

Suivez les spécifications décrites dans le flux de POI pour les fichiers de données de POI. Nous vous recommandons d'utiliser des noms de fichiers de données de points d'intérêt uniques pour chaque importation. Incluez un code temporel dans le nom du fichier, par exemple POI_1633621547.json.
Importez quotidiennement les flux sur le serveur SFTP des POI locaux en tant qu'actualisations complètes.
Vous trouverez les informations sur le serveur SFTP dans la section Configuration > Flux du portail des partenaires.

Sélectionner des serveurs de flux

Consultez l'état de l'ingestion des flux dans la section Ingestion > Historique du portail des partenaires.

Spécifications du flux

Conditions requises pour les champs

VssPoi

Représente une seule entité de point d'intérêt (POI), par exemple un hôtel ou un restaurant.

Nom du champ	Type	Exigence	Description
`poi_id`	chaîne	Obligatoire	Obligatoire. Chaîne générée par le partenaire qui identifie un point d'intérêt.
`name`	object `(Text)`	Obligatoire	Obligatoire. Nom du point d'intérêt.
`telephone`	chaîne		Numéro de téléphone du point d'intérêt, y compris l'indicatif du pays et de la région (par exemple, +14567891234).
`url`	chaîne		URL du site Web public du point d'intérêt. Remarque : Cette valeur ne sera utilisée qu'à des fins de correspondance, et non pour l'affichage.
`location`	object `(GeoCoordinates)`	Obligatoire	Obligatoire. Emplacement du point d'intérêt.
`display_address`	object `(Text)`		Adresse affichée dans l'UI.
`images`	Tableau d'objets `(Image)`		Images du POI. Nombre maximal d'images : 5.
`rating`	nombre		Note moyenne attribuée au point d'intérêt.
`num_ratings`	nombre		Nombre de notes contribuant au champ `rating`.
`rating_scale`	nombre		Échelle d'évaluation utilisée pour le champ `rating`. Si la note maximale est de 5, rating_scale est défini sur 5.
`category`	enum `(Category)`	Obligatoire	Obligatoire. Représente la catégorie du POI.
`description`	object `(Text)`		Description du point d'intérêt.
	oneOf `(additional_data)`	Obligatoire	Un seul des champs de ce oneOf peut être défini.

Texte

Représente un texte avec des localisations.

Nom du champ	Type	Exigence	Description
`localizations`	Tableau d'objets `(LocalizedString)`		Chaînes localisées.
`default_locale`	chaîne		Les paramètres régionaux à utiliser comme langue par défaut doivent être présents dans les localisations.

LocalizedString

Représente une chaîne localisée.

Nom du champ	Type	Exigence	Description
`locale`	chaîne		Tag de langue du texte, tel que "en", "en-US" ou "sr-Latn".
`text`	chaîne		Texte dans les paramètres régionaux spécifiés.

GeoCoordinates

Coordonnées géographiques d'un lieu, y compris la latitude, la longitude et l'adresse.

Nom du champ	Type	Exigence	Description
`latitude`	nombre		Valeur comprise entre -90 et +90 degrés (inclus). Obligatoire si la longitude est définie, sinon recommandé.
`longitude`	nombre		[-180, +180] degrés (inclus). Obligatoire si la latitude est définie, sinon recommandé.
	oneOf `(addresses)`	Obligatoire	Un seul des champs de ce oneOf peut être défini.

PostalAddress

Adresse postale du lieu.

Nom du champ	Type	Exigence	Description
`country`	chaîne	Obligatoire	Obligatoire. Pays, à l'aide du code pays ISO 3166-1 alpha-2, par exemple "FR".
`locality`	chaîne	Obligatoire	Obligatoire. La localité/ville, par exemple "Mountain View".
`region`	chaîne		Région/État/Province, par exemple "CA". Ce champ n'est obligatoire que dans les pays où la région est généralement incluse dans l'adresse. (facultatif)
`postal_code`	chaîne	Obligatoire	Obligatoire. Le code postal, par exemple "94043".
`street_address`	chaîne	Obligatoire	Obligatoire. L'adresse postale, par exemple "1600 Amphitheatre Pkwy".

Image

Représente une image du point d'intérêt.

Nom du champ	Type	Exigence	Description
`url`	chaîne		URL de l'image. Google explore le contenu multimédia hébergé sur cette URL. Longueur maximale : 2 000.
`alt_text`	object `(Text)`		Texte alternatif à utiliser pour l'accessibilité.

HotelData

Données de flux spécifiques aux hôtels.

Nom du champ	Type	Exigence	Description
`hotel_star_class`	nombre		Valeur officielle de la catégorie d'hôtel en étoiles. Peut être utilisé dans un libellé tel que "Hôtel 5 étoiles". Cette valeur doit être un nombre entier compris entre 1 et 5.
`brand_ids`	tableau de chaînes		Marques pouvant afficher cet hôtel. Si ce champ est vide, l'hôtel peut être affiché sous n'importe quelle marque associée au flux.

LocalData

Données de flux spécifiques à l'établissement.

Nom du champ	Type	Description
`business_hours`	object `(BusinessHours)`	Horaires d'ouverture habituels de l'établissement.
`price_range`	object `(PriceRange)`	Gamme de prix des services proposés par l'établissement.
`establishment_category`	object `(Text)`	Type d'établissement.
`brand_landing_pages`	Tableau d'objets `(BrandLandingPages)`	Pages de destination de la marque.

BusinessHours

Représente les horaires d'ouverture de l'établissement. Contient une collection d'instances [TimeRange][madden.vss_poi_feed.TimeRange]. Exemple : ouvert le samedi de 9h00 à 12h00 et de 13h00 à 17h00 : time_ranges { open_day: SATURDAY open_time: { hours: 9, minutes: 0 } close_day: SATURDAY close_time: { hours: 12, minutes: 0 } } time_rages { open_day: SATURDAY open_time: { hours: 13, minutes: 0 } close_day: SATURDAY close_time: { hours: 17, minutes: 0 } } Exemple : ouvert le samedi de 21h00 au dimanche à 2h00 : time_ranges { open_day: SATURDAY open_time: { hours: 21, minutes: 0 } close_day: SUNDAY close_time: { hours: 2, minutes: 0 } }

Nom du champ	Type	Exigence	Description
`time_ranges`	Tableau d'objets `(TimeRange)`		Ensemble des horaires d'ouverture de ce POI. Chaque période correspond à une plage horaire pendant laquelle le point d'intérêt est ouvert en semaine.

TimeRange

Représente une période d'ouverture du point d'intérêt, à partir du jour ou de l'heure d'ouverture spécifiés et jusqu'au jour ou à l'heure de fermeture indiqués. L'heure de fermeture doit être postérieure à l'heure d'ouverture (plus tard le même jour ou un jour suivant, par exemple).

Nom du champ	Type	Description
`open_day`	enum `(DayOfWeek)`	Jour d'ouverture de la plage horaire.
`open_time`	object `(TimeOfDay)`	Heure d'ouverture de la période.
`close_day`	enum `(DayOfWeek)`	Jour de clôture de la période.
`close_time`	object `(TimeOfDay)`	Heure de fin de la période.

TimeOfDay

Nom du champ	Type	Description
`hours`	nombre	Heures de la journée au format 24 heures. Doit être supérieur ou égal à 0 et généralement inférieur ou égal à 23. Une API peut choisir d'autoriser la valeur "24:00:00" pour des cas tels que l'heure de fermeture des bureaux.
`minutes`	nombre	Minutes d'une heure. Doit être supérieur ou égal à 0 et inférieur ou égal à 59.
`seconds`	nombre	Secondes d'une minute. Doit être supérieur ou égal à 0 et généralement inférieur ou égal à 59. Une API peut autoriser la valeur 60 si elle autorise les secondes intercalaires.
`nanos`	nombre	Fractions de secondes, en nanosecondes. La valeur doit être supérieure ou égale à 0 et inférieure ou égale à 999 999 999.

PriceRange

Tranche de prix des services proposés par le point d'intérêt.

Nom du champ	Type	Exigence	Description
`min_price`	object `(Money)`		Prix minimal des services proposés par le point d'intérêt.
`max_price`	object `(Money)`		Prix maximal des services proposés par le point d'intérêt.

Valeur monétaire

Représente un montant associé à un type de devise.

Nom du champ	Type	Description
`currency_code`	chaîne	Code de devise à trois lettres défini par la norme ISO 4217.
`units`	nombre	Unités entières du montant. Par exemple, si `currencyCode` est défini sur `"USD"`, une unité correspond à un dollar américain.
`nanos`	nombre	Nombre de nano-unités (10^-9) du montant. La valeur doit être comprise entre -999 999 999 et +999 999 999 inclus. Si `units` est positif, `nanos` doit être positif ou nul. Si `units` est égal à zéro, `nanos` peut être positif, nul ou négatif. Si `units` est négatif, `nanos` doit être négatif ou nul. Par exemple, -1,75 $ est représenté par `units`=-1 et `nanos`=-750 000 000.

BrandLandingPages

Pages de destination de marque localisées pour un seul point d'intérêt (POI).

Nom du champ	Type	Description
`brand_id`	chaîne	Marque à laquelle s'applique cette configuration.
`localized_landing_pages`	Tableau d'objets `(LocalizedLandingPage)`	Pages de destination localisées Les valeurs des champs "url" et "locales" doivent être uniques pour toutes les pages de destination localisées.
`default_url`	chaîne	URL de la page de destination par défaut à utiliser lorsqu'aucune des pages de destination localisées ne correspond à la langue de l'utilisateur.

LocalizedLandingPage

Page de destination localisée pour le point d'intérêt (POI).

Nom du champ	Type	Exigence	Description
`url`	chaîne		URL de la page de destination. Longueur maximale : 2 000.
`locales`	tableau de chaînes		Limite l'accès à cette page aux utilisateurs ayant la préférence linguistique spécifiée. Doit contenir des balises de langue, telles que "en", "en-US" ou "sr-Latn".

Catégorie

Représente la catégorie du POI. Il doit correspondre au champ "oneof" additional_data ci-dessous.

Nom	Description
`UNKNOWN_CATEGORY`
`HOTEL`
`LOCAL`

DayOfWeek

Représente un jour de la semaine.

Nom	Description
`DAY_OF_WEEK_UNSPECIFIED`	Le jour de la semaine n'est pas spécifié.
`MONDAY`	Lundi
`TUESDAY`	Mardi
`WEDNESDAY`	Mercredi
`THURSDAY`	Jeudi
`FRIDAY`	Vendredi
`SATURDAY`	Samedi
`SUNDAY`	Dimanche

additional_data

Obligatoire. Champs spécifiques à une catégorie. Il doit correspondre au champ category ci-dessus.

Nom du champ	Type	Exigence	Description
`hotel_data`	object `(HotelData)`	Exclusivité mutuelle avec `local_data`	Champs spécifiques aux hôtels.
`local_data`	object `(LocalData)`	Exclusivité mutuelle avec `hotel_data`	Champs spécifiques aux établissements locaux.

addresses

Obligatoire. Adresse d'un établissement.

Nom du champ	Type	Exigence	Description
`address`	object `(PostalAddress)`		Adresse postale du lieu.

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 termine par .jpg).
Autorisations : assurez-vous que le serveur d'hébergement autorise l'accès à Googlebot ou aux robots d'exploration, et qu'aucun fichier robots.txt ne bloque les répertoires d'images.

Définitions

VssPoiFeed – Définition

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

VssPoi – Définition

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


    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 {


    // 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;
}

LocalData – Définition

// Establishment specific feed data.
message LocalData {
  // The regular business hours of the establishment.
  BusinessHours business_hours = 1;

  // Price range of the services offered by the establishment.
  PriceRange price_range = 2;

  // The type of establishment.
  Text establishment_category = 3;

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

BrandLandingPages – Définition

// The Localized brand landing pages for a single Point of Interest (POI).
message BrandLandingPages {
  // The brand this configuration applies to.
  string brand_id = 1 [(datapol.semantic_type) = ST_PARTNER_ID];

  // Localized landing page for the Point of Interest (POI).
  message LocalizedLandingPage {

    // The url of the landing page.
    // Max length: 2000.
    string url = 1;

    // Restricts this page to users with the specified language preference.
    // Must contain language tags, such as "en", "en-US" or "sr-Latn".
    repeated string locales = 3;
  }

  // The localized landing pages.
  // The url and locales fields values must be unique across all the localized
  // landing pages.
  repeated LocalizedLandingPage localized_landing_pages = 2;

  // The default landing page url to be used when none of the localized
  // landing pages matches the user's language.
  string default_url = 3;
}

Exemples