Perguntas frequentes sobre o serviço da Web do Places

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

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

Como pesquisar lugares

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

É possível que o local que você está procurando ainda não tenha sido categorizado. Todos os lugares são categorizados como genéricos "establishment" até que o Google tenha dados suficientes para fazer a categorização como um dos tipos de lugar compatíveis.

Como solução alternativa, você pode transmitir o type do lugar ao parâmetro keyword. O parâmetro keyword faz a correspondência com o nome, tipo, endereço e avaliações dos clientes.

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

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

Por padrão, a API Places classifica os resultados por prominence no radius fornecido. Uma solicitação do Nearby Search pode retornar até 60 resultados, divididos em três páginas. Se um lugar estiver em 22o lugar em prominence, ele vai aparecer na segunda página de resultados, que você pode acessar pela paginação. Se um lugar estiver acima do 60o lugar em prominence, ele não será incluído no resultado da pesquisa, mesmo que esteja mais perto do centro da pesquisa.

Para classificar 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 por 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 algumas types?

A API Places foi projetada para retornar uma lista de resultados de establishments próximos (qualquer item da primeira tabela nos tipos de lugar compatíveis) e até dois locais (qualquer item 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 sua solicitação do Nearby Search por um local type, como locality ou political, vai filtrar os resultados de establishment.

Dados do local

Como 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.

Mesmo que você não seja o proprietário do lugar, ainda pode sugerir alterações.

Solução de problemas

Por que continuo recebendo o "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á faltando 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 a 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 a Android ou iOS não são compatíveis. Use uma chave de API genérica (sem restrições) ou uma com restrições de navegador ou servidor.
  • A solicitação não foi enviada como HTTPS. O HTTPS é obrigatório para todas as solicitações da API Places.
  • O HTTP method incorreto foi usado para enviar a solicitação:
    • Todas as solicitações precisam ser enviadas como GET, exceto [Place Add][place-add].
    • Todas as solicitações de [Place Add][place-add] precisam ser enviadas como uma solicitação POST.