Referência
Dados e privacidade
De onde vêm os lugares, o que guardamos e por quanto tempo, e como qualquer pessoa pode pedir uma remoção.
De onde vêm os lugares
Cada lugar é um perfil de empresa que qualquer pessoa vê no Google Maps. Coletamos esses perfis quando alguém pede uma região que não buscamos recentemente, e salvamos tudo, para que a próxima busca ali responda na hora. Lemos só o que o perfil mostra para qualquer um, e nunca entramos numa conta do Google.
O gmaps.dev não tem vínculo com o Google nem com a Alphabet. Esta não é a API do Google.
O que guardamos
De cada lugar, o que o perfil dele mostra:
- Nome, categoria, descrição e situação, como “Fechado permanentemente”.
- Endereço, coordenadas, plus code e fuso horário.
- Telefones e site.
- Nota, quantidade de avaliações e quantas deram cada estrela, horário de funcionamento e os horários de mais movimento.
- Faixa de preço, cartões aceitos, as comodidades que o perfil lista (como acesso para cadeira de rodas) e os links de cardápio, pedidos e reservas.
- Os ids do Google, o link do perfil no Google Maps, e quando vimos o lugar pela primeira vez e quando o coletamos por último.
Nos planos pagos, também endereços de e-mail. Procuramos no próprio site da empresa, só quando um cliente pede, e só mostramos para contas pagas que aceitaram a política de uso aceitável.
Nunca guardamos o texto das avaliações, o nome de quem avaliou, fotos, imagens do Street View nem o perfil do dono. Tudo isso é descartado antes de salvarmos qualquer coisa.
O guia Lugares descreve cada campo.
Por que uma busca para em 120 lugares
O Google Maps mostra cerca de 120 lugares por busca, não importa o tamanho da região. Por isso uma busca (POST /v1/places/search) traz no máximo 120 lugares e nunca coleta mais que isso.
Para ter mais, use uma coleta. Ela divide a região em quadrados pequenos e busca cada um, para cada termo, e assim uma cidade inteira vira muitas buscas pequenas em vez de uma grande. Diga quantos lugares quer em maxPlaces, até o limite de lugares por coleta do seu plano, em Limites. O guia Coletas mostra como.
Vazio não quer dizer que não tem ninguém
Uma resposta vazia quer dizer que ainda não achamos lugares ali, não que eles não existem. Talvez ninguém tenha buscado aquela região com aquela palavra, ou as empresas dali usem outras palavras para se descrever.
Quando buscamos numa região e não achamos nada, ela conta como buscada por só 7 dias. Depois disso, a próxima coleta ali procura de novo. Uma região onde achamos lugares conta como buscada por 180 dias. Uma coleta que não encontra nada não custa nada.
Para achar mais, tente outras palavras para a mesma coisa, ou uma região maior.
Por quanto tempo guardamos
| O quê | Por quanto tempo |
|---|---|
| Lugares | Até aceitarmos um pedido de remoção. Quando a nossa cópia de uma região passa de 180 dias, a próxima coleta ali atualiza tudo. |
| Uma região em que a busca não achou nada | 7 dias. Depois disso, a próxima coleta ali procura de novo. |
| Os lugares de uma coleta e o registro do andamento | 30 dias a partir de quando você inicia a coleta. As contagens e as cobranças dela ficam. |
| Um link de exportação | 24 horas. O arquivo é montado quando você abre o link, e nunca fica guardado. |
| Histórico de entregas de webhook | 7 dias. |
| Sua conta, depois que você pede a exclusão | 14 dias, para você poder voltar atrás. Depois apagamos a conta e tudo o que é dela. Os registros de pagamento que a lei manda guardar continuam, sem vínculo com a conta. |
Pedidos de remoção não vencem, para o que foi removido continuar de fora. A política de privacidade fala dos backups e do resto.
Pedidos de remoção
Qualquer pessoa pode pedir para removermos um lugar, um telefone, um e-mail ou um site pelo formulário de remoção. Não precisa de conta e não custa nada. A pessoa confirma por e-mail, e alguém da nossa equipe analisa o pedido.
- Um lugar: o lugar inteiro sai.
- Um telefone ou um e-mail: tiramos de todos os lugares que o mostram. Os lugares continuam.
- Um site: tiramos o site, e todos os e-mails desse domínio, de todos os lugares que os mostram.
Depois que aceitamos um pedido, o que ele pede sai na hora das buscas, das consultas de lugar, dos lugares das coletas, do progresso ao vivo e das exportações. Apagamos a cópia salva em até uma hora e nunca salvamos de novo.
Arquivos exportados antes disso continuam com o dado. Busque de novo em vez de reaproveitar um arquivo antigo.
Projetos que usamos
GET /v1/attributions lista os projetos de código aberto e os dados que usamos, com as licenças e os avisos de autoria. Não precisa de chave e não custa nada:
curl https://api.gmaps.dev/v1/attributionsA sua parte
- Um lugar é um perfil de empresa, não uma autorização para entrar em contato com alguém. Antes de ligar, mandar mensagem ou e-mail, confira a lei de onde você está e de onde a empresa está.
- Não entre em contato com quem pediu remoção, nem a partir de um arquivo que você guardou.
- E-mails exigem um plano pago e que você aceite a política de uso aceitável.
- Não use só os nossos resultados para tomar uma decisão com efeitos jurídicos ou igualmente sérios sobre uma pessoa, como negar um empréstimo ou um emprego.
A política de uso aceitável diz o que você pode e não pode fazer. Os termos de uso são o contrato, e a política de privacidade explica o que fazemos com os dados sobre você e sobre as pessoas nos resultados.