Place ID Google: o que é, como encontrar o ID de um lugar e quando ele muda

O que é o Place ID do Google?

O Place ID do Google é um identificador de texto que aponta para um único lugar no banco de dados do Google Places e no Google Maps. Ele existe para a maioria dos lugares, como empresas, pontos turísticos, parques e cruzamentos. As APIs do Google aceitam o place id google para devolver detalhes, montar links de mapa e geocodificar, e por isso ele funciona como a chave principal de um lugar.

Pense nele como um número de registro, não como um nome. Uma mesma rede pode ter dez unidades com o mesmo nome na mesma cidade, e um endereço pode ser digitado de cinco jeitos. O Place ID aponta para uma única entrada nos dados do Google, e é por isso que desenvolvedores e quem monta listas de leads o preferem. A definição vem da documentação da Google Maps Platform sobre Place IDs, que é a fonte de todas as afirmações técnicas desta página.

Um ponto merece atenção: um Place ID identifica um lugar, não uma empresa para sempre. O Google avisa que o mesmo lugar pode ter mais de um ID e que os IDs podem mudar com o tempo. Mais abaixo mostramos o que isso significa para os seus dados.

Como é um Place ID do Google?

Um Place ID é uma sequência opaca de letras, números, hífens e sublinhados. Muitos IDs de empresas começam com ChIJ, mas esse é só o formato mais comum, e não há regra que o exija. A própria documentação do Google lista exemplos que começam diferente, como GhIJ... e Eic..., e diz que o tamanho pode variar, sem limite máximo.

Não existe Place ID com "27 caracteres", como repetem muitos guias de place id. Se a coluna do seu banco ou a regra de validação da planilha assume um tamanho fixo, mais cedo ou mais tarde ela vai recusar um ID válido. Use uma coluna de texto sem limite de tamanho e trate o valor como um código opaco.

Também não dá para deduzir o Place ID a partir do telefone, de um par de coordenadas ou do endereço de uma loja. Ele vem do Google, e a próxima seção mostra como pegá-lo.

Como encontrar o Place ID de uma empresa?

A forma mais rápida de encontrar um place id google é o Place ID Finder: digite o nome da empresa, escolha o resultado nas sugestões e leia o ID. Para várias empresas ao mesmo tempo, use a Places API ou uma ferramenta de extração do Google Maps. A tabela compara as opções.

O passo a passo manual, em quatro etapas:

1. Abra a página de Place IDs ou o exemplo Place ID Finder na documentação da Maps JavaScript API.
2. Digite o nome da empresa e a cidade, por exemplo "pizzaria Savassi Belo Horizonte", e escolha o resultado certo entre as sugestões.
3. Leia o Place ID mostrado para esse resultado e copie.
4. Cole na sua planilha ou CRM, junto com a data em que você capturou.

Quem programa tem uma segunda via. Uma busca com Text Search (New), como "Spicy Vegetarian Food in Sydney, Australia", que é o exemplo da documentação, devolve cada resultado com um campo id que traz o Place ID. A página de Place Details (New) lista os outros caminhos: Nearby Search, Geocoding API, Routes API, Address Validation API e Autocomplete.

O Finder e a API foram feitos para consultas pontuais, um lugar ou uma busca por vez. Para montar uma lista de prospecção, o ideal é que os IDs cheguem junto com os leads, que é o que faz a abordagem de extrair dados de empresas do Google Maps. Se você pensa em usar a API em escala, veja antes o preço da API do Google Maps.

Place ID, CID, Plus Code ou coordenadas: qual serve de chave?

Use o Place ID como chave principal e trate os demais identificadores como dados complementares. O Google Maps oferece várias formas de nomear um lugar, e cada uma responde a uma pergunta diferente: qual é o perfil, onde fica e como as pessoas o chamam.

Se a lista de colunas que acompanha cada empresa capturada for novidade, veja como extrair endereços do Google Maps e como funcionam as categorias do Google Maps, dois campos que costumam andar junto com o Place ID.

O Place ID muda? Posso guardá-lo no meu banco?

Sim, o Place ID pode mudar, e sim, você pode guardá-lo. O Google diz que os IDs podem mudar por atualizações no banco de dados do Google Maps e recomenda renovar qualquer ID com mais de 12 meses. Os Place IDs são isentos dos limites de cache habituais, então mantê-los no seu próprio banco é permitido.

O que a documentação indica, nesta ordem:

1. Guarde o Place ID junto com a data em que você o capturou.
2. Passados 12 meses, faça uma chamada de Place Details pedindo só o campo id. O Google diz que essa renovação é gratuita.
3. Se a chamada devolver o erro INVALID_REQUEST ou NOT_FOUND, o ID pode estar inválido ou obsoleto. Busque a empresa de novo para obter um ID novo.
4. Guarde uma chave de reserva, como o domínio do site ou o telefone com DDD, para que a troca de um ID não crie um segundo registro da mesma empresa.

A isenção vem da Seção 3.2.3(b) dos Termos de Serviço da Google Maps Platform, como explica a página de Place IDs. Ela cobre o ID em si. Não dá direito de guardar outros dados do lugar em cache por tempo indeterminado, então leia os termos antes de montar um produto em cima da API.

O que dá para fazer com um Place ID do Google?

Com um Place ID você busca detalhes, cria links para o lugar exato e referencia o lugar em toda a plataforma do Google Maps. Abaixo estão os usos principais, todos documentados pelo Google.

• Buscar os detalhes do lugar. Uma chamada de Place Details recebe o ID e devolve os campos pedidos, como endereço, telefone e avaliação. Veja a referência de Place Details (New).
• Apontar um link para o lugar certo. Em uma URL do Maps, o parâmetro query_place_id faz o link apontar para um estabelecimento específico. O Google afirma que o Place ID é a melhor garantia de que você está levando ao lugar certo. Veja o guia de URLs do Maps.
• Reaproveitar em várias APIs. O mesmo ID vale na Places API, na Maps JavaScript API, na Geocoding API, na Maps Embed API e na Roads API.
• Criar uma chave estável. Em uma planilha ou CRM, o ID é o valor que você usa para casar registros quando duas exportações se sobrepõem.

Um link do Google Maps que procura um lugar pelo ID segue este padrão: https://www.google.com/maps/search/?api=1&query=Nome+da+Empresa&query_place_id=SEU_PLACE_ID. Se o Google não encontrar o ID, ele usa o texto da busca.

Como usar o Place ID para manter uma lista de leads limpa?

Use o Place ID como primeira chave ao juntar listas e como chave de reserva quando o ID estiver faltando. Quem monta listas de prospecção a partir do Google Maps acaba com exportações que se sobrepõem: um freelancer coleta "dentistas" em dois bairros vizinhos de Campinas, uma agência repete a busca no mês seguinte, um dono de negócio soma uma cidade nova a uma lista antiga. A mesma empresa aparece duas vezes.

A rotina abaixo mantém essas listas em ordem e funciona tanto em planilha quanto em CRM:

1. Capture o Place ID de cada estabelecimento. Se a sua exportação não o traz, só sobra casar por nome, o que falha ao comparar "Pizzaria do Zé" com "Pizzaria do Ze Ltda".
2. Junte primeiro pelo Place ID. Duas linhas com o mesmo ID são o mesmo lugar. Fique com a linha de contato mais completa.
3. Compare o restante com uma chave de reserva. Use o domínio do site, depois o telefone com DDD e, por fim, nome e coordenadas. Isso também pega o caso em que o Google deu um ID novo ao lugar.
4. Renove as linhas antigas. Reconfira os IDs com mais de 12 meses antes de uma campanha grande e retire as empresas que não resolvem mais.
5. Guarde a data de captura original. Ela mostra quais linhas são confiáveis e quais pedem checagem.

O lado de CRM está em como remover contatos duplicados da base de dados. Se você vai levar a lista para o Google Planilhas, o guia para exportar leads do Google Maps para o Google Sheets mostra quais colunas manter, e o Place ID deve ser uma delas.

Onde a Vonsel entra: a extensão da Vonsel para Chrome captura empresas do Google Maps, visita o site de cada uma para procurar e-mails, telefones e perfis em redes sociais publicados, e traz Place ID, CID, FID e KGMID entre os campos de exportação. Os campos disponíveis dependem do que cada empresa publica. As empresas capturadas vão para um CRM com mapa, e você pode reabrir um trabalho anterior para somar mais empresas. Veja o que cada plano inclui na página de preços. Para entender o fluxo em poucos minutos, assista ao tutorial em vídeo.

O Place ID é dado pessoal pela LGPD?

O Place ID, sozinho, identifica um lugar e não uma pessoa, mas os contatos que você coleta junto com ele podem ser dados pessoais. A Lei Geral de Proteção de Dados define dado pessoal como informação relacionada a pessoa natural identificada ou identificável, conforme o art. 5º, inciso I, da Lei nº 13.709/2018.

Na prática, o telefone fixo de uma clínica é um dado da empresa, mas o e-mail de uma pessoa específica ou o WhatsApp do dono de um negócio pode se encaixar na definição. Antes de começar a abordar os contatos de uma lista, revise o que você coletou e como vai usar. Para o canal de e-mail, leia o guia de cold email sem violar a lei de proteção de dados.

Fontes

• Place IDs | Places API (New): definição do Google para Place ID, exemplos de formato, ausência de tamanho máximo, regra de renovação a cada 12 meses e isenção de cache.
• Place ID Finder | Maps JavaScript API: exemplo oficial do Google que mostra o Place ID de um lugar depois da busca.
• Place Details (New) | Places API: como o Place ID é usado para pedir detalhes e quais APIs podem devolver um.
• Get Started | Maps URLs: como o parâmetro query_place_id aponta para um estabelecimento específico.
• Lei nº 13.709/2018 (LGPD) | Planalto: texto oficial da lei, com a definição de dado pessoal no art. 5º, inciso I.