Perguntas frequentes sobre o serviço da Web do Places

Este documento contém respostas a perguntas frequentes sobre a API Places. Se você não encontrar a resposta para sua pergunta aqui, algumas das páginas a seguir podem ser úteis.

A API Places também tem uma comunidade de desenvolvedores vibrante. Se você tiver dúvidas sobre o código, recomendamos que publique sua pergunta na comunidade. Para mais informações sobre como fazer perguntas, acesse a página de suporte.

Procurar lugares

Por que alguns lugares não são retornados quando filtro por tipo?

É possível que o lugar que você está procurando ainda não tenha sido categorizado. Todos os lugares são categorizados como o tipo genérico "establishment" até que o Google tenha dados suficientes sobre um lugar para categorizar como um dos tipos de lugar com suporte.

Como solução alternativa, é possível transmitir o lugar type para o parâmetro keyword. O parâmetro keyword é associado a: nome, tipo, endereço e avaliações do cliente.

Se você quiser adicionar a categoria type a uma página de lugar, envie uma edição do lugar. Depois que a edição for aprovada e publicada, ela vai aparecer usando a filtragem type correta.

Por que alguns lugares próximos não são retornados?

Por padrão, a API Places classifica os resultados por prominence dentro do radius fornecido. Uma solicitação de Pesquisa por proximidade pode retornar até 60 resultados, divididos em três páginas. Se um lugar estiver em 22º lugar em prominence, ele vai aparecer na segunda página de resultados, que pode ser acessada por paginação. Se um lugar tiver uma classificação maior que 60 em prominence, ele não será incluído no resultado da pesquisa, mesmo que esteja mais próximo do centro da pesquisa.

É possível classificar os resultados por distance em vez de prominence definindo o parâmetro rankby na consulta como distance e omitindo o parâmetro radius. A relevância será ignorada, e os lugares serão retornados em ordem de distância de location.

Se você estiver filtrando sua solicitação por tipo, alguns resultados podem ser filtrados da resposta. Para mais informações, consulte a entrada de perguntas frequentes: Por que alguns lugares não são retornados quando filtro por tipo?.

Por que recebo no máximo dois resultados ao filtrar por alguns types?

A API Places foi projetada para retornar uma lista de establishmentss próximos (qualquer coisa da primeira tabela nos tipos de lugar compatíveis) e até dois locais (qualquer coisa da segunda tabela dos tipos de lugar compatíveis) para ajudar a identificar a área em que você está fazendo uma solicitação de Pesquisa por perto.

Filtrar sua solicitação de Pesquisa nas proximidades por um local type, como locality ou political, vai filtrar os resultados de establishment.

Dados do local

Como posso adicionar ou editar lugares?

Se você é proprietário de uma empresa, pode adicionar, verificar e gerenciar suas fichas no Google Maps usando o Perfil da Empresa.

Se você não for o proprietário do lugar, ainda poderá sugerir mudanças.

Solução de problemas

Por que continuo recebendo "status": "REQUEST_DENIED"?

O "status": "REQUEST_DENIED" é retornado pela API Places quando:

  • Você não ativou a API Places no console do Google Cloud.
  • O parâmetro key está ausente na solicitação.
  • O parâmetro key não corresponde à chave de API no console do Google Cloud.
  • Sua chave de API não foi configurada corretamente no console do Google Cloud:
    • Se você estiver usando uma chave de API restrita a navegadores, verifique se os remetentes permitidos estão corretos.
    • Se você estiver usando uma chave de API restrita ao servidor, verifique se os IPs permitidos estão corretos.
    • Chaves de API com restrições do Android ou iOS não são aceitas. Use uma chave de API genérica (irrestrita) ou uma chave com restrições de navegador ou servidor.
  • A solicitação não foi enviada como uma solicitação HTTPS. HTTPS é obrigatório para todas as solicitações da API Places.
  • O HTTP method incorreto foi usado para enviar a solicitação.