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, confira algumas das páginas a seguir, que podem ser úteis.

A API Places também tem uma comunidade de desenvolvedores ativa. Se você tiver dúvidas sobre seu código, recomendamos que poste sua pergunta na comunidade. Mais informações sobre como fazer perguntas podem ser encontradas na página de suporte.

Procurar lugares

Por que alguns lugares não aparecem 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 classificá-lo como um dos tipos de lugar aceitos.

Como solução alternativa, transmita o lugar type para o parâmetro keyword. O parâmetro keyword é correspondido a: nome, tipo, endereço e avaliações dos clientes.

Se quiser adicionar a categoria type a uma página de lugar, envie uma edição de 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 aparecem?

Por padrão, a API Places classifica os resultados por prominence no radius fornecido. Uma solicitação de Nearby Search 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 estiver acima da 60ª posição em prominence, ele não será incluído no resultado da pesquisa, mesmo que esteja mais perto do centro da pesquisa.

Para ordenar os resultados por distance em vez de prominence, defina o parâmetro rankby na consulta como distance e omita 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 poderão ser filtrados da resposta. Para mais informações, consulte a entrada das 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 establishments próximos (qualquer coisa da primeira tabela de tipos de lugar aceitos) e até dois resultados de localização (qualquer coisa da segunda tabela de tipos de lugar aceitos) para ajudar a identificar a área em que você está fazendo uma solicitação de Pesquisa nas proximidades.

Filtrar sua solicitação de Nearby Search 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 as fichas dela no Google Maps usando o Perfil da Empresa.

Se você não for o proprietário, 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 sua solicitação.
  • O parâmetro key não corresponde à sua 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 ao navegador, verifique se os referenciadores 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. O HTTPS é obrigatório para todas as solicitações da API Places.
  • O HTTP method incorreto foi usado para enviar a solicitação.