O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Feed de pontos de interesse (PDI)

Esta página detalha as especificações técnicas do feed de pontos de interesse (PDIs). Ela inclui um resumo dos campos obrigatórios, definições de esquema abrangentes e um exemplo de JSON para orientar a implementação.

Especificações de feed

Esta seção descreve os requisitos e as definições do feed de PDIs.

Requisitos de campo

Nome do campo	Requisito	Descrição
poi_id	Obrigatório	Uma string gerada pelo parceiro que identifica um ponto de interesse (propriedade).
nome	Obrigatório	O nome do PDI. Esse nome será usado como o nome de exibição da propriedade na unidade do agregador.
telefone	Opcional	O número de telefone de contato do PDI, incluindo os códigos de país e de área, por exemplo, +14567891234.
`url`	Opcional	O URL do site público do PDI. Observação: ele será usado apenas para fins de correspondência, não para exibição.
local	Obrigatório (endereço) Opcional (latitude/longitude)	O local do PDI. Obrigatório: o endereço e os campos relacionados são necessários para que a propriedade seja correspondida corretamente. Opcional: a latitude e a longitude. Se fornecido, o Google vai usar a latitude/longitude na exibição dos marcadores de propriedade no mapa da unidade do agregador.
imagens	Altamente recomendado (uma imagem) Opcional (várias)	Imagens do PDI. As imagens são importantes na exibição de propriedades. Recomendamos adicionar pelo menos uma imagem. Você pode fornecer várias imagens, até um máximo de cinco. Quando várias são fornecidas, elas são usadas na ordem em que foram fornecidas (no caso de uma imagem inutilizável). As imagens serão revisadas para garantir que não violem as políticas de pesquisa segura do Google.
classificação	Opcional	Classificação média da propriedade.
num_ratings	Opcional	O número de classificações que contribuem para o campo `rating`.
rating_scale	Opcional	A escala de classificação usada para o campo `rating`. Se a classificação máxima for 5, a rating_scale será 5.
categoria	Opcional	Representa a categoria da propriedade.
hotel_data	Opcional	Campos específicos do hotel. Consulte a definição de HotelData para mais detalhes.
hotel_star_class	Opcional	O valor oficial da classificação do hotel por estrelas. Esse valor precisa ser um número inteiro entre 1 e 5.
brand_ids	Opcional	As marcas que podem exibir esse hotel. Se esse campo estiver vazio, o hotel poderá ser exibido em qualquer uma das marcas associadas ao feed.
descrição	Opcional	Uma descrição detalhada da propriedade.
display_address	Opcional	O endereço exibido na interface.

Diretrizes de imagens

Todas as imagens adicionadas ao feed precisam seguir estas diretrizes:

Formato: precisa ser JPEG, PNG ou WebP.
Tamanho máximo do arquivo: menos de 30 MB por imagem.
Dimensões máximas: menos de 75 megapixels no total (largura x altura < 75.000.000).
Tipo de URL: caminho direto para o recurso de imagem (por exemplo, termina em .jpg).
Permissões: verifique se o servidor de hospedagem permite o acesso ao Googlebot ou a rastreadores e não tem um arquivo robots.txt bloqueando os diretórios de imagens.

Suporte multilíngue

O feed de pontos de interesse oferece suporte ao conteúdo localizado para campos específicos. Os campos a seguir são do tipo Text e oferecem suporte à localização:

name
description
display_address

Para fornecer conteúdo em vários idiomas, especifique um default_locale no campo e forneça as strings localizadas na lista localizations. Forneça todas as localizações de uma propriedade em uma única entrada de PDI. Não divida uma única propriedade entre vários arquivos JSON de idioma.

Exemplo:

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

Diretrizes de empacotamento de arquivos

Para garantir a ingestão bem-sucedida, siga estes requisitos de empacotamento:

Arquivo JSON agregado único (obrigatório): combine todos os registros de propriedades em um único arquivo JSON. Recomendamos compactá-lo em um único arquivo GZIP e fazer o upload.
Aviso de antipadrão: não use um arquivo por propriedade ou vários arquivos separados por país no mesmo arquivo. Essa abordagem não é aceita e vai causar falhas de extração.

Definições

Definição 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;
}

Definição 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;
  }

}

Definição 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;
}

Definição 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;

  }
}

Definição 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;
}

Definição 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;
}

Definição 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];
}

Amostras