O que é a API do Google Places
Places API é um serviço que retorna informações sobre lugares por meio de requisições HTTP. Lugares aqui costumam ser definidos nesta API como estabelecimentos, locais geográficos ou pontos de interesse de destaque.
Existem cinco tipos de solicitações disponíveis na API. São eles:
- Pesquisa de Locais que retorna uma lista de locais com base na localização do usuário ou na string de busca.
- Detalhes do local que fornecem informações detalhadas sobre um local específico, com avaliações de usuários incluídas.
- Fotos de Lugares dão acesso a milhões de fotos relacionadas a lugares mantidas no banco de dados do Google Places.
- Publicar avaliações para alcançar e incorporar avaliações do Google na plataforma.
- Autocompletar Local ajuda a preencher automaticamente o nome ou o endereço de um local à medida que os usuários digitam.
- Autocomplete de Consulta oferece um serviço de previsão de consultas para buscas geográficas baseadas em texto, retornando sugestões conforme o usuário digita.
Para usar a API Places, você precisa de uma chave que deve ser incluída em todas as requisições da API Places. Vamos descobrir exatamente o que ela é e como obter a chave de API para a API de Lugares do Google.
Como criar uma chave de API do Google Places
A chave de API é um identificador único usado para autenticar as requisições associadas ao seu projeto, para fins de uso e cobrança. Ao usar uma chave de API para autenticar as requisições, você pode:
- Gerencie suas APIs no Google Cloud Console.
- Acesse dados de uso em tempo real e 30 dias de histórico de uso no Console do Google Cloud Platform.
- Confira relatórios de uso com mais de 30 dias de dados no Portal de Suporte do Google Cloud.
Você sempre pode experimentar uma forma alternativa de adicionar avaliações de clientes ao seu site. Por exemplo, há o widget de Avaliações do Google da Elfsight – você não precisa se preocupar em obter chaves de API ou aprender a programar.
Obtenha sua chave da Places API e adicione-a à sua solicitação
Para obter sua chave de API, você precisa realizar as seguintes ações:
- Abra o Console do Google Cloud Platform.
- Clique na lista suspensa do projeto e escolha o projeto criado para você. O nome dele deve começar com Google Maps APIs for Business ou Google Maps for Work ou Google Maps.
- Em seguida, clique no botão de menu e escolha APIs e Serviços > Credenciais.
- Na página de Credenciais, selecione Criar credenciais > Chave de API. Lá você verá uma janela de confirmação exibindo a chave de API recém-criada.
- Feche a aba. Sua nova chave de API está listada na página de credenciais, na seção Chaves de API.
Em seguida, você precisa adicionar a chave de API em cada solicitação da Places API. Usando o exemplo a seguir, basta substituir YOUR_API_KEY pela sua chave de API:
https://maps.googleapis.com/maps/api/place/nearbysearch/json ?location=-33.8670522,151.1957362 &radius=500 &types=food &name=harbour &key=YOUR_API_KEY
Lembre-se de que o Google recomenda fortemente restringir sua chave de API. As restrições proporcionam mais segurança e ajudam a garantir que apenas solicitações autorizadas sejam feitas com sua chave de API.
Como restringir a sua chave de API do Google Places
- Restrição de API. Este recurso permite restringir o uso da chave de API a sites, servidores web ou aplicativos móveis. Só pode haver uma restrição nessa categoria.
- Restrição de API. Este tipo de restrição limita o uso da chave de API a uma ou mais APIs ou SDKs.
Para restringir sua chave de API, você precisa de:
- Abra o Console do Google Cloud.
- Clique na lista suspensa de projetos e selecione o projeto que contém a chave de API que você deseja proteger.
- Clique no botão do menu e escolha APIs e Serviços > Credenciais.
- Clique no nome da chave de API que você precisa proteger na página Credenciais.
- Defina as restrições na página Restringir e renomeie a chave API.
Usando a API do Google Places: exemplos
Existem várias formas de usar a API do Google Places. Vamos ver algumas.
Busca por Locais
Conforme mencionado acima, a Places API permite pesquisar informações de locais em uma ampla variedade de categorias. O exemplo a seguir da Google Places API ilustra uma requisição Find Place para “Museum of Contemporary Art Australia”:
https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=photos,formatted_address,name,rating,opening_hours,geometry&key=YOUR_API_KEY
Detalhes do Local
Depois de obter um place_id a partir de uma pesquisa no Google Places, você pode obter mais informações sobre um estabelecimento ou ponto de interesse iniciando uma requisição de Detalhes do Local. Aqui vemos um exemplo de solicitação de detalhes de um lugar por place_id:
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name,rating,formatted_phone_number&key=YOUR_API_KEY
Adicionar Fotos
Este serviço permite adicionar conteúdo de fotos às suas aplicações. Ele dá acesso a milhões de fotos armazenadas no banco de dados Places. Segue um exemplo de solicitação:
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photoreference=CnRtAAAATLZNl354RwP_9UKbQ_5Psy40texXePv4oAlgP4qNEkdIrkyse7rPXYGd9D_Uj1rVsQdWT4oRz4QrYAJNpFX7rzqqMlZw2h2E2y5IKMUZ7ouD_SlcHxYq1yL4KbKUv3qtWgTK0A6QbGh87GB3sscrHRIQiG2RrmU_jF4tENr9wGS_YxoUSSDrYjWmrNfeEHSGSc3FyhNLlBU&key=YOUR_API_KEY
Autocompletar Localização
É um serviço web que retorna previsões de locais como resposta a uma requisição HTTP. Pode ser usado para oferecer autocomplete em pesquisas geográficas baseadas em texto. Abaixo está um exemplo de requisição para estabelecimentos:
https://maps.googleapis.com/maps/api/place/autocomplete/xml?input=Amoeba&types=establishment&location=37.76999,-122.44696&radius=500&key=YOUR_API_KEY
Autocomplete de Consulta
Este tipo de serviço oferece previsões de consulta para buscas geográficas por texto, retornando sugestões à medida que o usuário digita. Um exemplo de solicitação fica assim:
https://maps.googleapis.com/maps/api/place/queryautocomplete/json?key=YOUR_API_KEY&input=pizza+near%20par
Preços e limites da API do Google Places
Aqui, o Google usa um modelo de precificação pay-as-you-go. Isso significa que as APIs da Google Maps Platform são cobradas por SKU. O uso é rastreado para cada SKU de Produto, e uma API pode ter mais de um SKU de Produto.
Há 1.000 consultas gratuitas à Places API por 24 horas, mas você pode aumentá-las para 150.000 consultas gratuitas em 24 horas ativando o Faturamento no Google Cloud Console.
| Faixa de volume mensal (Preço por chamada) | 0–100.000 | 100,001–500,000 | 500.000+ | |
| Autocompletar | 0,00283 USD por unidade (2,83 USD por 1000) | 0,00227 USD por unidade (2,27 USD por 1000) | Fale com Vendas para preços por volume | |
| Autocompletar Consulta | 0,00283 USD por cada (2,83 USD por 1000) | 0,00227 USD por unidade (2,27 USD por 1000) | Fale com Vendas para preços por volume | |
| Detalhes do Local | 0,017 USD por cada (17,00 USD por 1.000) | 0,0136 USD por unidade (13,60 USD por 1.000) | Fale com Vendas para preços por volume | |
| Places Photo | 0,007 USD por item (7,00 USD por 1.000) | 0,0056 USD por unidade (5,60 USD por 1000) | Fale com Vendas para preços por volume | |
| Buscar | 0,032 USD por unidade (32,00 USD por 1000) | 0,0256 USD por cada um (25,60 USD por 1000) | Fale com Vendas para preços por volume |
FAQ
O Google Places API é um serviço gratuito?
A Places API usa um modelo de preços pay-as-you-go. Para ver mais detalhes sobre os preços, consulte a tabela acima ou a documentação.
Como posso usar a API do Google Places?
Para viabilizar, você precisa de uma chave de API. Você pode obtê-la através do Console da Nuvem, clicando na lista suspensa de projetos e escolhendo o projeto criado para você.
Como posso adicionar ou editar locais?
Se você é proprietário da empresa, pode fazer isso no Google Maps usando o Google My Business. Se você não for o proprietário do local que deseja editar, ainda pode sugerir alterações.
Como posso começar a usar APIs no meu site?
Primeiro, você precisa entender exatamente qual API você precisa. Consulte os guias Visão Geral, Desenvolvedor e Começar para a API ou SDK específica pela qual você tem interesse.
Conclusão
