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)

Nesta página, detalhamos as especificações técnicas do feed de ponto de interesse (PDI). Ele inclui um resumo dos campos obrigatórios, definições abrangentes de esquema e uma amostra JSON para orientar a implementação.

Especificações de feed

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: isso 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 acompanhantes são necessários para corresponder corretamente à propriedade. Recomendado: a latitude e a longitude. Se fornecidas, o Google usará a latitude/longitude na exibição dos ícones de propriedade no mapa da sua unidade agregadora.
imagens	Altamente recomendado (uma imagem) Bom ter (várias)	Imagens do PDI. As imagens são importantes na exibição de propriedades. Recomendamos adicionar pelo menos uma imagem. Você pode fornecer até cinco imagens. Quando várias são fornecidas, elas são usadas na ordem em que foram enviadas (no caso de uma imagem inutilizável). As imagens serão analisadas 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 avaliações que contribuíram 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, rating_scale será 5.
categoria	Opcional	Representa a categoria da propriedade.
hotel_data	Opcional	Campos específicos do hotel. Por enquanto, está vazio, mas vai evoluir com o alojamento se/quando houver outras necessidades de dados.
descrição	Opcional	Uma descrição detalhada da propriedade.
display_address	Opcional	O endereço exibido na interface.

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 têm suporte para 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.

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

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

Amostras