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)

Criar e fazer upload de feeds de PDI

Ao criar e fazer upload de feeds de PDI, siga estas instruções:

Siga as especificações descritas no feed de PDIs para arquivos de dados de PDIs. Recomendamos usar nomes de arquivo de dados de PDI exclusivos para cada upload. Inclua um carimbo de data/hora no nome do arquivo, por exemplo, POI_1633621547.json.
Faça upload de feeds para o servidor SFTP de PDIs locais diariamente como atualizações completas.
Os detalhes do servidor SFTP estão disponíveis na seção Configuração > Feeds do Portal de parceiros.

Selecionar servidores de feed

Confira o status de ingestão do feed na seção Ingestão > Histórico do Portal de Parceiros.

Diretrizes de empacotamento de arquivos

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

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

Suporte multilíngue

O feed de pontos de interesse permite fornecer conteúdo localizado para campos específicos. Os campos a seguir são do tipo Text e aceitam 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 entidade em uma única entrada de PDI. Não divida uma única entidade em vários arquivos JSON de idiomas.

Exemplo:

"name": {
  "localizations": [
    {
      "locale": "en",
      "text": "Tasty Bites Test Restaurant"
    },
    {
      "locale": "es",
      "text": "Restaurante de prueba Tasty Bites"
    }
  ],
  "default_locale": "en"
}

Diretrizes de imagens

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 aos rastreadores e se não há um arquivo robots.txt bloqueando os diretórios de imagens.
Pesquisa Segura: as imagens precisam obedecer às políticas da Pesquisa Segura do Google.

Especificações de feed

Requisitos de campo

VssPoi

Representa uma única entidade de ponto de interesse (PDI), como um hotel ou restaurante.

Nome do campo	Tipo	Requisito	Descrição
`poi_id`	string	Obrigatório	Obrigatório. Uma string gerada pelo parceiro que identifica um PDI.
`name`	objeto `(Text)`	Obrigatório	Obrigatório. O nome do PDI.
`telephone`	string		O número de telefone de contato do PDI, incluindo os códigos de país e de área, por exemplo, +14567891234.
`url`	string		O URL do site público do PDI. Observação: isso será usado apenas para fins de correspondência, não para exibição.
`location`	object `(GeoCoordinates)`	Obrigatório	Obrigatório. O local do PDI.
`display_address`	objeto `(Text)`		O endereço exibido na interface.
`images`	matriz de object `(Image)`		Imagens do PDI. Número máximo de imagens: 5.
`rating`	número		Classificação média do PDI.
`num_ratings`	número		O número de classificações que contribuem para o campo `rating`.
`rating_scale`	número		A escala de classificação usada para o campo `rating`. Se a classificação máxima for 5, a escala de classificação será 5.
`category`	enum `(Category)`	Obrigatório	Obrigatório. Representa a categoria do PDI.
`description`	objeto `(Text)`		Uma descrição do PDI.
	oneOf `(additional_data)`	Obrigatório	Apenas um dos campos neste "oneOf" pode ser definido.

Texto

Representa um texto com localizações.

Nome do campo	Tipo	Requisito	Descrição
`localizations`	matriz de objeto `(LocalizedString)`		As strings localizadas.
`default_locale`	string		A localidade a ser usada como idioma padrão precisa estar presente nas localizações.

LocalizedString

Representa uma string localizada.

Nome do campo	Tipo	Requisito	Descrição
`locale`	string		A tag de idioma do texto, como "en", "en-US" ou "sr-Latn".
`text`	string		O texto na localidade especificada.

GeoCoordinates

Dados geográficos de um local, incluindo latitude, longitude e endereço.

Nome do campo	Tipo	Requisito	Descrição
`latitude`	número		[-90, +90] graus (inclusive). Obrigatório se a longitude estiver definida. Caso contrário, é recomendável.
`longitude`	número		[-180, +180] graus (inclusive). Obrigatório se a latitude estiver definida. Caso contrário, é recomendável.
	oneOf `(addresses)`	Obrigatório	Somente um dos campos neste oneOf pode ser definido.

PostalAddress

O endereço postal do local.

Nome do campo	Tipo	Requisito	Descrição
`country`	string	Obrigatório	Obrigatório. O país, usando o código de país ISO 3166-1 alfa-2, por exemplo, "BR".
`locality`	string	Obrigatório	Obrigatório. A localidade/cidade, por exemplo, "Mountain View".
`region`	string		A região/estado/província, por exemplo, "CA". Esse campo é obrigatório apenas em países onde a região geralmente faz parte do endereço. (opcional)
`postal_code`	string	Obrigatório	Obrigatório. O código postal, por exemplo, "94043".
`street_address`	string	Obrigatório	Obrigatório. O endereço, por exemplo, "1600 Amphitheatre Pkwy".

Imagem

Representa uma imagem do ponto de interesse (PDI).

Nome do campo	Tipo	Requisito	Descrição
`url`	string		O URL da imagem. O Google rastreará a mídia hospedada nesse URL. Tamanho máximo: 2.000.
`alt_text`	objeto `(Text)`		O texto alternativo a ser usado para acessibilidade.

HotelData

Dados de feed específicos do hotel.

Nome do campo	Tipo	Requisito	Descrição
`hotel_star_class`	número		O valor oficial da classificação por estrelas do hotel. Pode ser usado em um rótulo como "Hotel cinco estrelas". Esse valor precisa ser um número inteiro entre 0 e 5. Uma classificação de 0 deve ser usada se uma classificação não estiver disponível ou não for especificada. Quando definida como 0, nenhuma classe de estrela será mostrada na interface para os usuários.
`brand_ids`	matriz de strings		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.

LocalData

Dados de feed específicos do estabelecimento.

Nome do campo	Tipo	Requisito	Descrição
`business_hours`	object `(BusinessHours)`		O horário de funcionamento normal do estabelecimento.
`price_range`	object `(PriceRange)`		Faixa de preço dos serviços oferecidos pelo estabelecimento.
`establishment_category`	object `(Text)`		O tipo de estabelecimento.
`brand_landing_pages`	matriz de objeto `(BrandLandingPages)`	Obrigatório	Obrigatório. Páginas de destino da marca. É necessário fornecer pelo menos um.

BusinessHours

Representa os períodos em que esse local está aberto para negócios. Contém uma coleção de instâncias de [TimeRange][madden.vss_poi_feed.TimeRange]. Exemplo: aberto aos sábados das 9h às 12h e das 13h às 17h: 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 } } Exemplo: aberto aos sábados das 21h às 2h de domingo: time_ranges { open_day: SATURDAY open_time: { hours: 21, minutes: 0 } close_day: SUNDAY close_time: { hours: 2, minutes: 0 } }

Nome do campo	Tipo	Requisito	Descrição
`time_ranges`	matriz de objeto `(TimeRange)`		Um conjunto de horários em que o PDI está aberto para negócios. Cada período representa um intervalo de horas em que o PDI fica aberto durante a semana.

TimeRange

Representa um período em que o PD está aberto, começando no dia/horário de abertura especificado e terminando no dia/horário de fechamento especificado. O horário de fechamento precisa ser posterior ao de abertura, por exemplo, mais tarde no mesmo dia ou em um dia seguinte.

Nome do campo	Tipo	Descrição
`open_day`	enum `(DayOfWeek)`	O dia de abertura do período.
`open_time`	objeto `(TimeOfDay)`	O horário de abertura do período.
`close_day`	enum `(DayOfWeek)`	O dia de fechamento do período.
`close_time`	objeto `(TimeOfDay)`	O horário de fechamento do período.

TimeOfDay

Nome do campo	Tipo	Descrição
`hours`	número	Horas de um dia no formato de 24 horas. Precisa ser maior ou igual a 0 e geralmente menor ou igual a 23. Uma API pode permitir o valor "24:00:00" para cenários como o horário de fechamento de uma empresa.
`minutes`	número	Minutos de uma hora. Precisa ser maior ou igual a 0 e menor ou igual a 59.
`seconds`	número	Segundos de um minuto. Precisa ser maior ou igual a 0 e, normalmente, menor ou igual a 59. Uma API pode permitir o valor 60 se permitir segundos bissextos.
`nanos`	número	Frações de segundos, em nanossegundos. Precisa ser maior ou igual a 0 e menor ou igual a 999.999.999.

PriceRange

Faixa de preço dos serviços oferecidos pelo PDI.

Nome do campo	Tipo	Requisito	Descrição
`min_price`	object `(Money)`		O preço mínimo dos serviços oferecidos pelo PDI.
`max_price`	objeto `(Money)`		O preço máximo dos serviços oferecidos pelo PDIs.

Dinheiro

Representa um montante em dinheiro com o respectivo tipo de moeda.

Nome do campo	Tipo	Descrição
`currency_code`	string	O código de moeda de três letras definido no ISO 4217.
`units`	número	As unidades inteiras do montante. Por exemplo, se `currencyCode` for `"USD"`, então 1 unidade vai equivaler a um dólar americano.
`nanos`	número	Número de unidades nano (10^-9) do montante. É necessário que o valor fique entre -999.999.999 e +999.999.999 (inclusive os dois limites). Se `units` for positivo, `nanos` será positivo ou zero. Se `units` for zero, `nanos` poderá ser positivo, zero ou negativo. Se `units` for negativo, `nanos` será negativo ou zero. Por exemplo,US $-1,75 é representado como `units`=-1 e `nanos`=-750.000.000.

BrandLandingPages

As páginas de destino localizadas da marca para um único ponto de interesse (PDI).

Nome do campo	Tipo	Requisito	Descrição
`brand_id`	string	Obrigatório	Obrigatório. A marca a que essa configuração se aplica.
`localized_landing_pages`	matriz de objeto `(LocalizedLandingPage)`		As páginas de destino localizadas. Os valores dos campos url e locales precisam ser exclusivos em todas as páginas de destino localizadas.
`default_url`	string	Obrigatório	Obrigatório. O URL da página de destino padrão a ser usado quando nenhuma das páginas de destino localizadas corresponder ao idioma do usuário.

LocalizedLandingPage

Página de destino localizada para o ponto de interesse (PDI).

Nome do campo	Tipo	Requisito	Descrição
`url`	string		O URL da página de destino. Tamanho máximo: 2.000.
`locales`	matriz de strings		Restringe esta página a usuários com a preferência de idioma especificada. Precisa conter tags de idioma, como "en", "en-US" ou "sr-Latn".

Categoria

Representa a categoria do PDI. Ele precisa corresponder ao campo oneof additional_data abaixo.

Nome	Descrição
`UNKNOWN_CATEGORY`
`HOTEL`
`LOCAL`

DayOfWeek

Representa um dia da semana.

Nome	Descrição
`DAY_OF_WEEK_UNSPECIFIED`	O dia da semana não é especificado.
`MONDAY`	Segunda-feira
`TUESDAY`	Terça-feira
`WEDNESDAY`	Quarta-feira
`THURSDAY`	Quinta-feira
`FRIDAY`	Sexta-feira
`SATURDAY`	Sábado
`SUNDAY`	Domingo

additional_data

Obrigatório. Campos específicos da categoria. Ele precisa corresponder ao campo category acima.

Nome do campo	Tipo	Requisito	Descrição
`hotel_data`	objeto `(HotelData)`	Mutuamente exclusivo com `local_data`	Campos específicos do hotel.
`local_data`	objeto `(LocalData)`	Mutuamente exclusivo com `hotel_data`.	Campos específicos de local.

addresses

Obrigatório. Endereço de um local.

Nome do campo	Tipo	Requisito	Descrição
`address`	object `(PostalAddress)`		Endereço postal do local.

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 {


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

}

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 imagem

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

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

  // Required. The brand landing pages. At least one must be provided.
  repeated BrandLandingPages brand_landing_pages = 4;
}

Definição de BrandLandingPages

// The Localized brand landing pages for a single Point of Interest (POI).
message BrandLandingPages {
  // Required. 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;

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

Amostras