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 a especificação descrita no feed de PDI para arquivos de dados de PDI. Recomendamos usar nomes de arquivos 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 dos feeds para o servidor SFTP de PDI local diariamente como atualizações completas.
Você pode encontrar os detalhes do servidor SFTP na seção Configuração > Feeds do portal de parceiros.

Como selecionar servidores de feed

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

Especificações de feed

Requisitos de campo

VssPoi

Representa uma única entidade de ponto de interesse (PDI), por exemplo, 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`	object `(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`	object `(Text)`		O endereço exibido na interface.
`images`	matriz de objeto `(Image)`		Imagens do PDI. Número máximo de imagens: 5.
`rating`	número		Avaliação média do PDI.
`num_ratings`	número		O número de avaliações que contribuíram 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, rating_scale será 5.
`category`	enum `(Category)`	Obrigatório	Obrigatório. Representa a categoria do PDI.
`description`	object `(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, é bom ter.
`longitude`	número		[-180, +180] graus (inclusive). Obrigatório se a latitude estiver definida. Caso contrário, é bom ter.
	oneOf `(addresses)`	Obrigatório	Apenas 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 ISO 3166-1 alfa-2, por exemplo, "US".
`locality`	string	Obrigatório	Obrigatório. A localidade/cidade, por exemplo, "Mountain View".
`region`	string		A região/estado/província, por exemplo, "CA". Este 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`	object `(Text)`		O texto alternativo a ser usado para acessibilidade.

HotelData

Dados específicos do feed de hotéis.

Nome do campo	Tipo	Requisito	Descrição
`hotel_star_class`	número		O valor oficial da classificação do hotel por estrelas. Pode ser usado em um rótulo como "Hotel 5 estrelas". Esse valor precisa ser um número inteiro entre 1 e 5.
`brand_ids`	matriz de strings		As marcas que podem mostrar este hotel. Se esse campo estiver vazio, o hotel poderá ser exibido em qualquer uma das marcas associadas ao feed.

LocalData

Dados específicos do feed do estabelecimento.

Nome do campo	Tipo	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)`	As páginas de destino da marca.

BusinessHours

Representa os períodos em que esse local está aberto para negócios. Contém uma coleção de instâncias [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 até domingo às 2h: 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 PDI fica aberto, começando no dia/horário de abertura especificados e fechando no dia/horário especificado. O horário de fechamento precisa ser posterior ao horário de abertura, por exemplo, mais tarde no mesmo dia ou em um dia subsequente.

Nome do campo	Tipo	Descrição
`open_day`	enum `(DayOfWeek)`	O dia de abertura do período.
`open_time`	object `(TimeOfDay)`	O horário de abertura do período.
`close_day`	enum `(DayOfWeek)`	O dia de fechamento do período.
`close_time`	object `(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 o horário de fechamento da empresa, por exemplo.
`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. Será possível usar o valor 60 caso a API permita 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`	object `(Money)`		O preço máximo dos serviços oferecidos pelo PDI.

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

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

Nome do campo	Tipo	Descrição
`brand_id`	string	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	O URL padrão da página de destino 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 additional_data "oneof" 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`	object `(HotelData)`	Mutuamente exclusivo com `local_data`	Campos específicos do hotel.
`local_data`	object `(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.

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 se não há um arquivo robots.txt bloqueando os diretórios de imagens.

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;

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

Definição de BrandLandingPages

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

Amostras