Documentação

Como funciona o PlaceGrid

Regiões e tipos de locais, a pesquisa de teste gratuita, filtros, enriquecimento, resultados, exportação e preços: todo o produto numa página, também em Markdown simples para a sua IA.

Começar Markdown limpo para agentes de IA

Locais do Google Maps de qualquer região, com os contactos que os seus próprios sites publicam: encontrados, filtrados, enriquecidos e exportados numa única aplicação web.

O PlaceGrid encontra todos os negócios dos tipos que escolher dentro de limites de região retirados do mapa, indica quantos existem e quanto vão custar antes de qualquer cobrança, e acrescenta a cada local o que pedir: a ficha completa do Google, os contactos do seu site, avaliações, fotos e uma verificação do seu site. Trabalha com o resultado como tabela, como mapa e como ficha de cada local, e exporta-o.

Conceitos

Projeto: uma tarefa, com as suas regiões, tipos de locais, idioma de pesquisa, filtros, enriquecimento e todas as pesquisas feitas para ela. Um projeto guarda os seus resultados, por isso uma pesquisa posterior mostra o que mudou.
Região: uma área retirada dos próprios limites do mapa, ou seja, um país, uma região, uma cidade ou um bairro. Uma região selecionada cobre tudo o que está dentro dela. Os locais fora das suas regiões nunca são mostrados nem cobrados.
Tipo de local: o tipo de negócio a procurar (dentista, café, hotel…), escolhido de uma lista de tipos comuns ou escrito por palavras suas. Escolhe também o idioma em que o Google Maps responde.
Pesquisa de teste: uma amostra gratuita da pesquisa. Mostra quantos locais existem, o que cada tipo de local acrescenta, quanto vai custar a pesquisa completa e quanto tempo vai demorar, e dá uma amostra de locais para experimentar os filtros.
Filtros de pesquisa: decidem que locais uma pesquisa paga e enriquece.
Enriquecimento: o que é acrescentado a cada local que passa os filtros. Cada tipo tem o seu próprio preço por resultado.
Pesquisa: a recolha completa. Percorre cada região célula a célula, por isso não fica limitada aos primeiros cem resultados que uma pesquisa no mapa devolve.
Resultados: os locais que a pesquisa encontrou e que pagou.
Créditos: a unidade em que o trabalho é cobrado. Um crédito vale 0,001 €. Uma conta nova começa com 1000 créditos gratuitos; os restantes compram-se em pacotes, com cartão (consulte Preços).
Organização: uma conta que paga o trabalho dos seus membros com os próprios créditos (consulte Limites e controlo).

As etapas de um projeto

A aplicação conduz um projeto por oito etapas, listadas ao lado de um assistente de IA. Pode voltar a qualquer uma delas a qualquer momento.

A aplicação também funciona no navegador do telemóvel: todas as etapas, os resultados (como cartões), a exportação e a compra de créditos. A sua interface está disponível em inglês e noutros idiomas europeus; escolha o seu na página da conta.

Projeto: dê-lhe um nome e diga numa frase para que serve; o assistente usa isto para sugerir regiões e tipos de locais.
Regiões: selecione países, regiões, cidades ou bairros numa árvore, pesquise-os pelo nome e veja-os no mapa.
Tipos de locais: o que procurar, e o idioma de pesquisa.
Pesquisa de teste: gratuita. A estimativa vem com um intervalo, o custo e o tempo, e quantos locais cada tipo de local encontra que nenhum outro encontra. Quando os locais encontrados têm muitas vezes outras categorias do Google, estas são propostas como tipos de locais adicionais.
Filtros: fique só com os locais de que precisa, filtrando por estado do negócio, categorias, palavras do nome, site, telefone, reserva online, perfil reivindicado, classificação, número de avaliações, comodidades. Cada alteração é contada de imediato na amostra do teste: quantos locais restam e quantos cada filtro exclui por si só.
Enriquecimento: escolha os tipos (e, para os contactos, a profundidade); para avaliações e fotos, quantas por local. Cada tipo mostra o seu custo e o seu tempo.
Pesquisa: escolha um limite de custo ou nenhum, e execute-a. Os locais encontrados, os créditos gastos e o tempo restante são mostrados em direto. Depois de uma alteração das definições, esta etapa indica o trabalho que a alteração exige (um pagamento adicional sobre o resultado que já tem, ou uma nova pesquisa) e quanto custa.
Resultados: a tabela, o mapa, uma ficha por local, filtros, colunas e exportação.

O que cada local inclui

Campo	Significado
Nome, categorias	Tal como a ficha as mostra
Morada, cidade, país, coordenadas, fuso horário	Localização
Telefone, site	Contactos da ficha
Classificação, número de avaliações	Classificação atual e número de avaliações
Estado do negócio	Em funcionamento, fechado temporariamente ou definitivamente
Perfil reivindicado, ligação de reserva, área de serviço	Se o proprietário gere a ficha, se tem ligação para reservas ou encomendas online, se serve uma área sem espaço aberto ao público
Comodidades	As que a resposta de pesquisa do Google indica, normalmente só as de acessibilidade; a Ficha do local traz todas
Place ID, CID, ligação do Google Maps	Identificadores estáveis

O horário semanal, a descrição e o menu estão na ficha completa do local: consulte Ficha do local abaixo.

Enriquecimento

Ficha do local

A ficha completa do local, além do que uma pesquisa devolve: todas as categorias, a descrição, o horário, o menu ou a lista de serviços (com preços, quando o negócio os indica), as publicações do proprietário, as horas de maior afluência, as classificações por estrelas, todas as comodidades que o Google indica, as ligações de reserva e de encomenda, e se o perfil está reivindicado.

Contactos do site

O site indicado na ficha do local é lido à procura de contactos: a página inicial e, depois, as páginas de contacto, informação legal e «sobre nós». Devolve:

emails, cada um com o seu tipo quando o endereço o indica de forma fiável e sem tipo quando não indica. Os tipos são: geral (info@, office@…), pessoal, um departamento (vendas, encomendas, contabilidade…) ou uma filial;
mais telefones, perfis em redes sociais e ligações de reserva encontrados no site;
onde cada contacto foi encontrado: a página, e se era uma ligação, o texto da página, o código do site ou a IA;
para onde o site leva realmente: um perfil numa rede social, um sistema de reservas, uma entrada num diretório ou um novo site do mesmo negócio. Um diretório ou o site de outro negócio não são lidos à procura de contactos.

Quatro profundidades, cada uma com o seu preço:

Profundidade	O que lê
Padrão	As páginas tal como o site as entrega
JavaScript	As mesmas páginas, apresentadas primeiro num navegador: encontra contactos em sites construídos com scripts
Pesquisa com IA	Páginas apresentadas e lidas por um agente de IA, que escolhe os contactos e decide que páginas abrir a seguir
IA + redes sociais	O agente pode abrir também os perfis do negócio nas redes sociais, com um orçamento fixo por local; quando o site que o Google Maps indica é ele próprio um perfil, começa por aí. Ler uma página de Facebook ou Instagram com ligação a partir do site custa normalmente mais do que esse orçamento permite

Os emails não estão no Google Maps: vêm do próprio site do negócio e são encontrados em cerca de 40–45 % dos locais que têm site, consoante o setor. Um local só é cobrado quando se encontra um email ou um perfil numa rede social.

Avaliações

As mais recentes primeiro, até ao número definido por local: o texto, a classificação e a data de cada avaliação, e a resposta do proprietário. Os temas das avaliações do Google também vêm incluídos.

Fotos

Até ao número definido por local, pela ordem em que a galeria do Google as mostra, com a contagem da própria galeria e os seus separadores, para saber se o proprietário publicou fotos e se há fotos do menu ou vídeos.

Verificação do site

Uma análise ao site de cada local:

o seu estado: funciona; funciona num novo endereço; funciona, mas fechado a robôs; responde com um erro; não responde; domínio inexistente; estacionado ou à venda; site de outro negócio; sem site próprio (uma página de rede social ou de reservas); não é um endereço web;
HTTPS: válido, cadeia incompleta, expirado, ainda não válido, para outro endereço, autoassinado, não fidedigno ou sem HTTPS; quando expira o certificado; se o http leva ao https;
o que usa: o CMS e a sua versão, píxeis de anúncios (Meta Pixel, Google Ads, TikTok, LinkedIn, Pinterest, Snapchat, Microsoft, X, Reddit), ferramentas de análise e gestores de etiquetas, sistemas de reservas.

Cada veredicto é a resposta e é cobrado, incluindo o de um site em baixo: é isso que a verificação encontra.

Presente, ausente, desconhecido

Cada campo opcional está num de três estados, e a aplicação indica qual:

presente: o valor foi encontrado;
ausente: foi procurado e não existe (por exemplo, a ficha não tem site);
desconhecido: não foi verificado, ou a verificação falhou.

«Sem site» e «não verificado» são respostas diferentes, e uma lista de leads construída com base na primeira não é igual a uma construída com base na segunda. Quando a fonte do próprio local falha (um domínio que não existe, um site que não responde, um local que desapareceu do Google), a aplicação indica-o e não cobra nada por isso, e mantém-no separado de um erro do nosso lado, que é tentado novamente.

Trabalhar com os resultados

A tabela: escolha entre cerca de 80 colunas, ponha-as na ordem que quiser, defina a sua largura e ordene por elas. O mapa mostra os mesmos locais; um clique abre a ficha do local, organizada como no Google Maps: resumo, menu e serviços, avaliações (pesquise-as, filtre-as por classificação), fotos. No telemóvel, os locais são cartões.
Filtros de resultados: restrinja o que é mostrado por qualquer dado recolhido, como um email pessoal no domínio do próprio site, perfis nas redes sociais escolhidas, um menu com preços, aberto ao fim de semana ou até tarde, uma avaliação de 1–2★ a que o proprietário não respondeu, uma classificação que fica atrás das avaliações, palavras que as avaliações mencionam, o estado do site, o certificado, o CMS ou os píxeis, a cidade. São gratuitos e não alteram nada do que pagou.
As suas próprias colunas: uma coluna de texto ou uma lista de valores seus (com cores e um valor predefinido), preenchida diretamente na tabela, na ficha do local ou para muitos locais de uma vez. Filtre e ordene por elas; entram na exportação.
Colunas de IA: escreva uma tarefa («Atendem crianças?») e um agente de IA preenche a coluna para cada local com um valor da sua lista, um modelo preenchido ou texto livre. Escolhe o que é mostrado ao agente, o que ele pode usar (apenas os campos do local, o seu site, a web ou uma pesquisa na web) e quantas chamadas pode fazer. Cada célula guarda o raciocínio do agente e as páginas que leu.
Predefinições: guarde as colunas, as suas larguras e ordem e os filtros como um conjunto para uma tarefa (uma lista de chamadas, uma lista de envio), para todos os seus projetos ou para um, e aplique-o com um clique.
Enriquecer os resultados: acrescente enriquecimento aos locais que a tabela lista, sem uma nova pesquisa.
Histórico e comparação: todas as pesquisas são guardadas. Abra uma anterior tal como era, ou compare duas para ver o que é novo, o que mudou (e que campos), o que desapareceu.

Pesquisar de novo

Acrescentar tipos de locais ou regiões: o resultado é alargado. Só se pesquisa o que é novo, e os locais já pagos não voltam a ser pagos.
Retirar alguns: o resultado é restringido, gratuitamente.
Pesquisar um tipo de novo: os seus locais são encontrados de novo e pagos de novo; para cada tipo de enriquecimento, escolha só locais novos, locais novos e alterados, ou todos os locais outra vez.
Uma pesquisa interrompida pelo seu limite: continue-a a partir de onde parou.
Filtros mais amplos depois de uma pesquisa: os locais que encontrou mas não pagou são propostos como pagamento adicional, com preço calculado sobre os locais reais.
Um tipo de enriquecimento ativado depois de uma pesquisa: um pagamento adicional acrescenta-o aos locais que tem, sem pesquisar de novo.

Exportação

XLSX, CSV, HTML, JSON, XML ou Parquet: os locais, as colunas e a ordem que a tabela mostra, com os seus filtros. Os formatos de folha de cálculo e de página usam os nomes das colunas no idioma da sua interface; os formatos de dados usam chaves estáveis e valores tipados (números, carimbos de data/hora, listas, registos como itens do menu ou avaliações).

Preços

Os preços estão em créditos; um crédito vale 0,001 €, por isso cada preço abaixo é em euros por cada 1000. Cada pesquisa mostra o seu custo antes de começar.

O quê	Paga por	Por cada 1000
Pesquisa de teste		gratuito
Locais	cada local diferente encontrado dentro das suas regiões	1,00 €
Ficha do local	cada local	1,00 €
Contactos do site: padrão	cada local onde se encontra um email ou um perfil numa rede social	0,75 €
Contactos do site: JavaScript	o mesmo	4,25 €
Contactos do site: pesquisa com IA	o mesmo	17,50 €
Contactos do site: IA + redes sociais	o mesmo	20,00 €
Avaliações	cada avaliação recolhida	0,50 €
Fotos	cada foto recolhida	0,50 €
Verificação do site	cada local com site	2,25 €
Colunas de IA	os tokens do modelo e as páginas que lê, aos preços que a aplicação mostra	pagamento por utilização
Assistente		gratuito

Exemplo: 1000 dentistas numa região, com contactos padrão encontrados para 430 deles, custam 1,00 € + 0,32 € = 1,32 €.

As regras:

A pesquisa de teste é gratuita, e ver quantos locais os seus filtros mantêm também.
Duplicados, locais fora das suas regiões e pedidos falhados não são cobrados.
Os contactos só são cobrados quando se encontra um email ou um perfil numa rede social: um site que não se consegue ler não custa nada.
Um local já pago não volta a ser pago quando acrescenta tipos de locais ou regiões, ou quando continua uma pesquisa.
Uma pesquisa paga pelo menos 10 % dos locais que encontra nas suas regiões, por poucos que os filtros mantenham, e isso é tido em conta quando alargar os filtros mais tarde.
Restringir os resultados, as suas próprias colunas, as predefinições e a exportação não custam nada.

Comprar créditos

Pagamento por utilização: não há subscrição e nada se renova.

1000 créditos gratuitos com cada conta nova: cerca de 1 € de trabalho, para experimentar uma pesquisa nas suas próprias regiões.
Pacotes: os créditos compram-se em pacotes, a partir de 10 € por 10 000 créditos; os pacotes maiores acrescentam até 15 % mais créditos. Os pacotes disponíveis e os seus preços são mostrados antes de pagar.
Pagamento: com cartão, na página de pagamento da Stripe; nunca vemos o número do seu cartão. Os preços estão em euros. Cada pagamento é acompanhado do recibo da Stripe.
De imediato: os créditos são adicionados assim que o pagamento é confirmado. No pagamento, pede que fiquem disponíveis de imediato e reconhece que, se comprar como consumidor, o seu direito de livre resolução de 14 dias termina com isso.
Válidos durante 365 dias: os créditos, gratuitos ou comprados, são válidos durante 365 dias a partir do dia em que são adicionados; os que expiram primeiro são gastos primeiro. Os créditos não usados até lá expiram.
Reembolsos: os pagamentos não são reembolsados, exceto quando a lei o exige. Se um pagamento for reembolsado ou estornado, os créditos que adicionou são retirados; se alguns já tiverem sido gastos, o seu saldo fica abaixo de zero e nenhum novo trabalho pago pode começar até que uma compra o regularize.

Os termos completos estão nos Termos de Serviço.

Limites e controlo

Um limite de custo para cada pesquisa, ou nenhum. Sem limite, a pesquisa continua enquanto o saldo e o limite mensal o permitirem; com limite, nunca gasta mais, e pode aumentá-lo enquanto a pesquisa decorre. Em ambos os casos, para quando o dinheiro acaba e guarda o que encontrou.
Um limite mensal para toda a conta, na página da conta.
Organizações: uma conta pode tornar-se uma organização e convidar colegas por email depois de ter comprado créditos. Paga o trabalho dos membros com os próprios créditos, decide para cada membro se os pode gastar e pode definir um limite mensal. Vê quanto cada um gastou este mês, mas nunca os seus projetos ou resultados. Os créditos próprios de um membro ficam congelados até sair da organização.
A página Consumo discrimina cada crédito gasto por dia, por tipo de trabalho, por projeto e por pesquisa, e os créditos adicionados, mês a mês.

O assistente

Ao lado de cada etapa está um assistente de IA. Propõe regiões e tipos de locais a partir do nome e das notas do projeto, e define-os por si; altera os filtros, o enriquecimento e os filtros de resultados, preenche as suas próprias colunas e configura colunas de IA, mostrando cada alteração como um cartão com uma forma de a ver; conta locais na pesquisa de teste e nos resultados sem gastar nada, e responde a perguntas sobre o projeto e a aplicação. Nunca inicia uma pesquisa nem gasta créditos. É gratuito.

API

Uma API pública para o seu próprio código está a caminho. Até estar pronta, tudo é feito na aplicação web; se precisar de acesso programático, escreva-nos.

Suporte

Com sessão iniciada, abra Suporte na barra superior da aplicação: os seus pedidos e as nossas respostas ficam lá, e chegam também por email assim que o seu endereço estiver confirmado. Caso contrário, escreva-nos a partir da página de contacto.