Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Feed de lugares de interés (POI)

En esta página, se detallan las especificaciones técnicas del feed de lugares de interés. Incluye un resumen de los campos obligatorios, definiciones de esquema completas y un ejemplo de JSON para guiar la implementación.

Especificaciones del feed

En esta sección, se describen los requisitos y las definiciones del feed de lugares de interés.

Requisitos de los campos

Nombre del campo	Requisito	Descripción
poi_id	Obligatorio	Es una cadena generada por el socio que identifica un lugar de interés (propiedad).
nombre	Obligatorio	Es el nombre del lugar de interés. Este nombre se usará como el nombre visible de la propiedad en la unidad del agregador.
teléfono	Deseable	Es el número de teléfono de contacto del lugar de interés, incluidos los códigos de país y de área, por ejemplo, +14567891234.
`url`	Deseable	Es la URL del sitio web público del lugar de interés. Nota: Se usará solo para fines de coincidencia, no para mostrarse.
ubicación	Obligatorio (dirección) Deseable (latitud/longitud)	Es la ubicación del lugar de interés. Obligatorio: La dirección y los campos que la acompañan serán obligatorios para que la propiedad coincida correctamente. Deseable: La latitud y la longitud. Si se proporcionan, Google usará la latitud y la longitud para mostrar los pines de propiedades en el mapa de la unidad del agregador.
imágenes	Muy recomendable (una imagen) Deseable (varias)	Son imágenes del lugar de interés. Las imágenes serán importantes para mostrar las propiedades. Te recomendamos agregar al menos 1 imagen. Puedes proporcionar varias imágenes hasta un máximo de 5. Cuando se proporcionan varias, se usarán en el orden en que se proporcionaron (en caso de que una imagen no se pueda usar). Las imágenes se revisarán para garantizar que no infrinjan las políticas de Búsqueda segura de Google.
clasificación	Deseable	Es la clasificación promedio de la propiedad.
num_ratings	Deseable	Es la cantidad de calificaciones que contribuyen al campo `rating`.
rating_scale	Deseable	Es la escala de clasificación que se usa para el campo `rating`. Si la clasificación máxima es 5, entonces rating_scale es 5.
categoría	Deseable	Representa la categoría de la propiedad.
hotel_data	Deseable	Son campos específicos del hotel. Consulta la Definición de HotelData para obtener más detalles.
hotel_star_class	Deseable	Es el valor oficial de estrellas de la categoría del hotel. Se espera que este valor sea un número entero entre 1 y 5.
brand_ids	Deseable	Son las marcas que pueden mostrar este hotel. Si este campo está vacío, el hotel se puede mostrar en cualquiera de las marcas asociadas con el feed.
descripción	Deseable	Es una descripción detallada de la propiedad.
display_address	Deseable	Es la dirección que se muestra en la IU.

Lineamientos sobre las imágenes

Todas las imágenes agregadas al feed deben seguir estos lineamientos:

Formato: Debe ser JPEG, PNG o WebP.
Tamaño máximo del archivo: Menos de 30 MB por imagen.
Dimensiones máximas: Menos de 75 megapíxeles en total (ancho × alto < 75,000,000).
Tipo de URL: Ruta directa al recurso de imagen (p.ej., termina en .jpg).
Permisos: Asegúrate de que el servidor de hosting permita el acceso a Googlebot o a los rastreadores y que no haya un archivo robots.txt que bloquee los directorios de imágenes.

Compatibilidad con diferentes lenguajes

El feed de lugares de interés admite la provisión de contenido localizado para campos específicos. Los siguientes campos son de tipo Text y admiten la localización:

name
description
display_address

Para proporcionar contenido en varios idiomas, debes especificar un default_locale en el campo y proporcionar las cadenas localizadas en la lista localizations. Proporciona todas las localizaciones de una propiedad en una sola entrada de lugar de interés. No dividas una sola propiedad entre varios archivos JSON de idioma.

Ejemplo:

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

Lineamientos sobre el empaquetado de archivos

Para garantizar una ingesta correcta, cumple con los siguientes requisitos de empaquetado:

Archivo JSON agregado único (obligatorio): Combina todos los registros de propiedades en un solo archivo JSON. Te recomendamos que lo comprimas en un solo archivo GZIP y lo subas.
Advertencia sobre el antipatrón: No uses un archivo por propiedad ni varios archivos separados por país en el mismo archivo. Este enfoque no es compatible y provocará errores de extracción.

Definiciones

Definición 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;
}

Definición 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;
  }

}

Definición de Text

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

Definición de GeoCoordinates

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

  }
}

Definición de PostalAddress

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

Definición de 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;
}

Definición 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 1 and 5.
  int32 hotel_star_class = 1;

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

Ejemplos