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 ajudar a 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 (que contém 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 a option do produto.

Locais relacionados e relation_type

Uma option 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 os itens que geralmente não devem ser marcados como relacionados incluem visualizações de um PDI em um cruzeiro ou passeios de ônibus ou pontos de encontro para passeios (use o campo meeting_point). Os três relation_types são:

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

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

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

Observação: para se qualificar para o módulo de ingressos de atrações na Pesquisa, os produtos precisam incluir o tipo de relação ADMISSION_TICKET para o PDI da atração.

Exemplos

relation_type	Exemplo
RELATED_NO_ADMISSION	Passeio a pé pela Torre Eiffel sem entrada. Passeio de helicóptero pelo Burj Khalifa.
ADMISSION_TICKET	Ingresso para um zoológico, pode incluir complementos adicionais.
SUPPLEMENTARY_ADDON	Furar a fila sem entrada, guia de áudio sem entrada.
Não relacionado	Cruzeiro de barco que vê o PDI de longe. Agência de turismo onde o passeio começa ou o ingresso pode ser comprado.

Cada option de produto também pode ter um meeting_point para tipos de passeios específicos em que o local de partida 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 notar que uma das atrações com que você está trabalhando está ausente do Google Coisas legais para fazer, você pode preencher o formulário de solicitação de novo PDI do TTD para solicitar que o PDI seja adicionado como parte do Coisas legais para fazer.

Observação: as solicitações só são analisadas em lotes periodicamente pela equipe do produto. Se uma atração for adicionada, você poderá vê-la diretamente na ferramenta Encontrar locais correspondentes da Central de ações.

Como transmitir locais relacionados ao Google

Ao processar um feed recebido, o Google tenta corresponder as dicas de localização fornecidas como strings de texto a entidades internas do Google que representam esses locais, conhecidas como pontos de interesse (PDIs).

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

A correspondência de local se refere ao processo de correspondência de um local relacionado, na forma de uma dica textual, a 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 localização, dos requisitos contratuais com os fornecedores e da quantidade de controle que se deseja ter sobre o processo de correspondência.

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

Tipos de dicas

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ó será bem-sucedido se o local da empresa tiver sido verificado pelo Google. Além dos PDIs, esse formato também oferece suporte a tipos de empresas híbridas e de serviço local, 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 híbrida ou de serviço local, essa é a maneira preferencial de enviar esses locais.
Informações do lugar	Representação estruturada de um PDI, fornecendo campos separados para nome do lugar, componentes de endereço e outras dicas, como número de telefone, site e coordenadas. Esse é o método preferencial quando não é possível receber um ID do Perfil da Empresa do proprietário do PDI.	O local é fornecido pelo fornecedor ou proprietário dos 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 operadora de turismo localizada em uma área remota, como um deserto ou uma estrada sem nome. Quando 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 informações adicionais, como número de telefone ou site, para melhorar a acurácia da correspondência.
ID de lugar	Identifica exclusivamente um PDI no Google. Ele pode ser obtido usando os endpoints da API Places, por exemplo Place Search ou Place Autocomplete, ou manualmente usando a ferramenta Encontrar locais correspondentes na Central de Coisas Legais para Fazer.	O local é fornecido pelo fornecedor ou proprietário dos dados por meio de uma ferramenta de interface do usuário voltada para o fornecedor, que pode, por exemplo, usar o Place Autocomplete para permitir que o proprietário dos 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 brutas. Esse é o método preferencial quando não é possível receber um ID do Perfil da Empresa do proprietário do PDI e você prefere corresponder o endereço a um PDI no seu lado usando a API Places, em vez de enviar as informações brutas do lugar ao Google.
Latitude e longitude	Identifique de forma geral 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 nenhum PDI específico. Por exemplo, quando você quer associar um produto a uma cidade ou região administrativa para que ele possa ser acionado nos anúncios das 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 de linha única não estruturado, incluindo opcionalmente o nome do lugar. Obsoleto. Esse formato não será mais aceito a partir de 1º de maio de 2024.	Todo o uso desse formato 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 localização afetadas podem ser migradas para o ID do Perfil da Empresa ou o ID de 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": "[phone]",
    "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

Para migrar o campo address não estruturado atual para o novo campo place_info, siga estas etapas:

1. Se os dados de endereço que você tem não forem estruturados:
   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. Remova o campo address atual do feed.
   4. Acesse a etapa 3.
2. Se os dados de endereço que você tem forem estruturados:
   1. Adicione o nome da empresa ao campo place_info/name.
   2. Adicione as informações de endereço, como street_address e postal_address, em place_info/structured_address.
   3. Remova o campo address atual do feed.
   4. Acesse a etapa 3.
3. Adicione outros dados, como website_url e phone_number, para melhorar a precisão da correspondência.