Local e ponto de interesse

O feed de produtos oferece várias maneiras de especificar pontos de interesse associados ao produto. O Google usa essas informações para mostrar o produto aos usuários quando PDIs ou destinos relevantes são pesquisados.

Cada option de produto pode especificar um ou mais pontos de interesse (PDIs) relacionados à opção usando o campo related_location (contendo uma lista de objetos RelatedLocation). Cada objeto RelatedLocation contém um location que descreve o PDI em questão e um relation_type que descreve a relação entre o PDI e o produto option.

Uma opção de produto só deve ser marcada como relacionada se fornecer uma experiência significativa do local, além de visitá-lo fisicamente. A definição de "significativo" pode variar para diferentes locais, mas as coisas que geralmente não devem ser marcadas como relacionadas incluem visualizações de um PDI durante um cruzeiro ou um passeio de ônibus, por exemplo, ou pontos de encontro para passeios (use o campo meeting_point). Os três relation_types são:

  • RELATED_NO_ADMISSION: o local é relacionado, mas a opção de produto não inclui admissão ou a admissão é irrelevante. Por exemplo, se o local for uma praça destacada em um passeio pela cidade.

  • ADMISSION_TICKET: a relação concede a entrada para este local relacionado.

  • SUPPLEMENTARY_ADDON: a relação declara um serviço adicional que não leva o usuário ao local relacionado. Por exemplo, uma multa de estacionamento ou uma exposição temporária.

Exemplos

relation_type Exemplo
RELATED_NO_ADMISSION Tour a pé ao redor da Torre Eiffel sem entrada. Passeio de helicóptero ao redor do Burj Khalifa.
ADMISSION_TICKET O ingresso de entrada para um zoológico pode incluir complementos adicionais.
SUPPLEMENTARY_ADDON Pular a fila sem entrada, tour autoguiado sem entrada.
Não relacionado Passeio de barco que mostra o ponto de interesse à distância. Escritório de turismo onde o passeio começa ou onde o ingresso pode ser comprado.

Cada option de produto também pode ter um meeting_point para tipos específicos de passeio, em que o local de início não está claro e precisa ser determinado (por exemplo, passeios guiados).

Como solicitar a adição de uma nova atração

Se você estiver fornecendo os ingressos oficiais para atrações e perceber que uma delas está faltando no Google Things To Do, preencha o formulário de solicitação de novo PDI do TTD para solicitar a adição do PDI como parte do Things To Do.

Ao processar um feed de entrada, o Google tenta corresponder as dicas de local fornecidas como strings de texto a entidades internas do Google que representam esses locais, conhecidos como pontos de interesse (POIs).

Um PDI pode ser definido de forma genérica como um alfinete nomeado em um local específico (coordenadas). No contexto de Coisas legais para fazer, exemplos relevantes incluem operadores de turismo e atrações turísticas. No entanto, de modo geral, um PDI pode ser qualquer estabelecimento com um nome e local conhecidos pelo Google.

A correspondência de local se refere ao processo de correspondência de um local relacionado, na forma de uma dica textual, com um PDI conhecido pelo Google, se houver um no banco de dados do Google.

Há várias maneiras de enviar um local relacionado ao Google, dependendo da origem dos dados de local, dos requisitos contratuais com os fornecedores e do nível de controle que se quer ter sobre o processo de correspondência.

Os seguintes tipos de dicas são aceitos (em ordem de preferência):

Tipos de dica

Tipo Descrição Uso recomendado
ID do Perfil da Empresa Identifica exclusivamente uma empresa no Google.

Ele só pode ser obtido diretamente do proprietário da empresa usando a página de configurações avançadas do Perfil da Empresa, conforme descrito em Configurações avançadas do perfil.

Ele é mapeado para o PDI que representa a empresa no Google. O mapeamento só vai ser bem-sucedido se o local da empresa tiver sido verificado pelo Google.

Além dos pontos de interesse, esse formato também aceita tipos de empresas híbridas e de área de cobertura, definidos em Como usar uma área de cobertura no Google.
  • O parceiro tem uma relação comercial direta com o proprietário da empresa.
  • Para empresas do tipo serviço de área de cobertura ou híbridas, essa é a maneira preferencial de enviar esses locais.
Informações do lugar Representação estruturada de um PDI, fornecendo campos separados para o nome do lugar, componentes do endereço e dicas adicionais, como número de telefone, site e coordenadas.

Esse é o método preferencial quando não é possível conseguir o ID do Perfil da Empresa do proprietário do PDI.
  • O local é fornecido pelo fornecedor ou proprietário de dados em um formato de endereço, por exemplo, usando uma ferramenta voltada para o fornecedor.
  • O local não tem um endereço preciso, mas pode ser identificado por nome e coordenadas, como uma atração ou um operador de turismo localizado em uma área remota, como um deserto ou uma estrada sem nome.
  • Sempre que possível, prefira esse formato em vez de corresponder o endereço a um ID de lugar usando a API Places para que o Google possa usar outras informações, como número de telefone ou site, para melhorar a precisão da correspondência.
ID do lugar Identifica exclusivamente um PDI no Google.

Ele pode ser fornecido usando os endpoints da API Places, por exemplo, a Pesquisa de lugares ou o Place Autocomplete, ou manualmente usando a ferramenta Encontrar correspondências de local na Central de coisas legais para fazer.
  • O local é fornecido pelo fornecedor ou proprietário de dados por meio de uma ferramenta de interface voltada ao fornecedor, que pode, por exemplo, usar o Place Autocomplete para permitir que o proprietário de dados selecione a correspondência correta em uma lista de possíveis candidatos.
  • Você prefere ter mais controle sobre o processo de correspondência ou não quer compartilhar as informações de endereço bruto.
  • Esse é o método recomendado quando não é possível conseguir um ID do Perfil da Empresa do proprietário do PDI e você prefere associar o endereço a um PDI do seu lado usando a API Places em vez de enviar as informações brutas do lugar para o Google.
Latitude e longitude Identificam de forma vaga uma região geográfica ou geopolítica, como uma cidade, localidade ou destino de viagem.
  • Use esse formato quando quiser enviar um local aproximado que não represente um PDI específico. Por exemplo, quando você quer associar um produto a uma cidade ou localidade para que ele possa ser acionado em anúncios de Coisas legais para fazer.
  • Esse formato não é adequado para representar um PDI. Para enviar locais de PDI usando coordenadas, use o formato de informações do lugar.
Endereço Representa um local de PDI como um endereço não estruturado de uma linha, incluindo opcionalmente o nome do lugar.

Descontinuado.
A partir de 1º de maio de 2024, esse formato não será mais compatível.
  • Todo o uso desse formato vai precisar ser migrado para o novo formato de informações do lugar, que inclui um campo obrigatório para o nome do lugar e oferece suporte a formatos de endereço estruturados e não estruturados.
  • Como alternativa, as dicas de local afetadas podem ser migradas para o ID do Perfil da Empresa ou do lugar.

Exemplos

// Example 1: Business Profile ID, copied from the Advanced settings page
// of the Google Business Profile that manages the POI.
"location": {
  "business_profile_id": 11458995034835395294
}

// Example 2: Place Info with structured address, coordinates, website URL,
// and phone number.
"location": {
  "place_info": {
    "name": "Colosseum",
    "phone_number": "+39 063 99 67 700",
    "website_url": "https://colosseo.it/",
    "coordinates": {
      "latitude": 41.8902102,
      "longitude": 12.4922309
    },
    "structured_address" {
      "street_address": "Piazza del Colosseo, 1",
      "locality": "Roma",
      "administrative_area": "RM",
      "postal_code": "00184",
      "country_code": "IT"
    }
  }
}

// Example 3: Place Info with unstructured address.
"location": {
  "place_info": {
    "name": "Eiffel Tower",
    "unstructured_address": "5 Av. Anatole France, 75007 Paris, France"
  }
}

// Example 4: Place Info using place name and coordinates only. This
// configuration is useful for matching POIs located in remote areas without
// an exact street address, such as POIs located in deserts or on unnamed
// roads.
"location": {
  "place_info": {
   "name": "Mutitjulu Waterhole",
   "coordinates": {
     "latitude": -25.3511774,
     "longitude": 131.0326859
    }
  }
}

// Example 5: Latitude and longitude.
// This format maintains the old behavior and will only match to the city or
// region.
// For more accurate matching using coordinates, use PlaceInfo instead,
// which includes a mandatory field for the place name.
"location": {
  "lat_lng": {
    "latitude": 51.5072178,
    "longitude": -0.1275862
  }
}

Como migrar o campo address para o novo campo place_info

É possível migrar o campo address não estruturado para o novo campo place_info seguindo estas etapas:

  1. Se os dados de endereço forem não estruturados, faça o seguinte:
    1. Adicione o nome da empresa ao campo place_info/name
    2. Coloque o endereço sem o nome da empresa em place_info/unstructured_address
    3. Solte o campo address do feed.
    4. Vá para a etapa 3
  2. Se os dados de endereço forem estruturados:
    1. Adicionar o nome da empresa ao campo place_info/name
    2. Adicione as informações de endereço, como street_address, postal_address em place_info/structured_address.
    3. Solte o campo address do feed.
    4. Vá para a etapa 3
  3. Adicionar mais dados, como website_url e phone_number, para melhorar a precisão da correspondência.