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 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 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 categorizá-lo como um dos tipos de lugar compatíveis.

Como solução alternativa, você pode transmitir o type do lugar para o parâmetro keyword. O parâmetro keyword é correspondente a: nome, tipo, endereço e avaliações de clientes.

Se quiser adicionar a categoria type a uma listagem de lugares, 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 são retornados?

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 em uma posição maior que 60º em prominence, ele não será incluído no resultado da pesquisa, mesmo que esteja mais perto do centro da pesquisa.

Você pode 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 a solicitação por tipo, alguns resultados poderão 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 establishments próximos (qualquer coisa da primeira tabela nos tipos de lugar compatíveis) e até dois resultados de local (qualquer coisa da segunda tabela de tipos de lugar compatíveis) para ajudar a identificar a área em que você está realizando uma solicitação de Nearby Search.

Filtrar a solicitação de Nearby Search por um type de local, como locality ou political, vai filtrar os resultados de establishment.

Dados do local

Como posso adicionar ou editar lugares?

Se você for proprietário de uma empresa, poderá adicionar, verificar e gerenciar as listagens da empresa 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 da 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.
    • As chaves de API com restrições do Android ou iOS não são compatíveis. Use uma chave de API genérica (sem restrições) 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.