Como usar a API do Google Places e obter uma chave de API

O que é a API do Google Places

A API do Places é um serviço que retorna informações sobre lugares usando solicitações HTTP. Os lugares aqui são geralmente definidos dentro desta API como estabelecimentos, localizações geográficas ou pontos de interesse proeminentes. 

Há cinco tipos de solicitações disponíveis dentro da API. São eles:

• Pesquisa de Local que retorna uma lista de lugares com base na localização do usuário ou string de pesquisa.
• Detalhes do Local que fornece informações detalhadas sobre um lugar específico, incluindo avaliações de usuários.
• Fotos do Local concede acesso às milhões de fotos relacionadas ao local mantidas no banco de dados do Google Places.
• Avaliações do Local permite alcançar e incorporar avaliações do Google da plataforma.
• Autocompletar Local está lá para preencher automaticamente o nome ou endereço de um lugar conforme os usuários digitam.
• Autocompletar de Consulta fornece um serviço de previsão de consulta para pesquisas geográficas baseadas em texto, retornando consultas sugeridas conforme os usuários digitam.

Para trabalhar com a API de lugares, você precisa de uma chave que deve ser incluída com cada solicitação da API de lugares. Vamos descobrir o que é exatamente e como obter a chave da API para a API do Google Places. 

Como criar uma chave da API do Google Places

A chave da API é um identificador exclusivo que está lá para autenticar solicitações associadas ao seu projeto para fins de uso e faturamento. Ao usar uma chave da API para autenticar solicitações, você pode:

• Gerenciar suas APIs no Console do Google Cloud.
• Acessar dados de uso em tempo real e 30 dias de dados de uso histórico no Console da Google Cloud Platform. 
• Observar relatórios de uso com mais de 30 dias de informações no Portal de Suporte da Google Cloud.

Você pode encontrar mais informações sobre relatórios disponíveis para clientes do Plano Premium aqui. Agora você pode prosseguir para obter a chave. 

Você sempre é livre para tentar uma maneira 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 codificar.

Obtenha sua chave da API do Places e adicione-a à sua solicitação

Para obter sua chave da API, você precisa realizar as seguintes ações:

• Abra o Console da Plataforma Google Cloud.
• Clique na lista suspensa do projeto e escolha o projeto criado para você. Seu nome deve começar com APIs do Google Maps para Empresas ou Google Maps para Trabalho ou Google Maps.
• Em seguida, clique no botão de menu e escolha APIs & Serviços > Credenciais.
• Na página Credenciais, escolha Criar credenciais > Chave de API. Lá você verá um diálogo de criação de chave da API demonstrando sua chave recém-criada.
• Feche a aba. Sua nova chave da API é listada na página de credenciais na seção de chaves da API.

Depois, você precisa adicionar a chave da API a cada solicitação da API de lugares. Usando o exemplo a seguir, basta substituir SUA_CHAVE_DA_API por sua chave da API:

https://maps.googleapis.com/maps/api/place/nearbysearch/json
  ?location=-33.8670522,151.1957362
  &radius=500
  &types=food
  &name=harbour
  &key=SUA_CHAVE_DA_API

Lembre-se de que o Google recomenda fortemente que você restrinja sua chave da API. As restrições concedem segurança adicional e ajudam a garantir que apenas solicitações autorizadas sejam feitas com sua chave da API.

Como restringir sua chave da API do Google Places

Há duas restrições e você precisa configurar ambas. Elas são:

• Restrição de Aplicativo. Este recurso permite limitar o uso da chave da API a sites, servidores da web ou aplicativos móveis. Há apenas uma restrição desta categoria que pode ser escolhida. 
• Restrição de API. Este tipo de restrição limita o uso da chave da API a uma ou mais APIs ou SDKs. 

Para restringir sua chave da API, você precisa:

• Abra o Console da Google Cloud.
• Clique na lista suspensa do projeto e escolha o projeto que contém a chave da API que você deseja proteger.
• Clique no botão de menu e escolha APIs & Serviços > Credenciais.
• Clique no nome da chave da API que você precisa proteger na página de Credenciais. 
• Defina as restrições na página Restringir e renomear chave da API. 

Depois que as restrições forem definidas, tudo o que resta é simplesmente clicar no botão Salvar. 

Usando a API do Google Places: exemplos

Há várias maneiras de usar a API do Google Places. Vamos ver alguns deles.

Pesquisa de Local

Como mencionado acima, a API de Lugares permite pesquisar informações de lugar usando uma enorme quantidade de categorias. O seguinte exemplo da API do Google Places demonstra uma solicitação de Localização para “Museu de Arte Contemporânea da Austrália”:

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=SUA_CHAVE_DA_API

Detalhes do Local

Depois de obter um place_id de uma Pesquisa de Lugares do Google, você está livre para obter mais informações sobre um estabelecimento ou ponto de interesse específico iniciando uma solicitação de Detalhes do Local. Aqui podemos ver uma solicitação de detalhes de um lugar pelo place_id: 

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name,rating,formatted_phone_number&key=SUA_CHAVE_DA_API

Fotos do Local

Este serviço permite adicionar conteúdo de foto às suas aplicações. Ele dá acesso a milhões de fotos armazenadas no banco de dados de Lugares. Aqui está um exemplo de solicitação:

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photoreference=CnRtAAAATLZNl354RwP_9UKbQ_5Psy40texXePv4oAlgP4qNEkdIrkyse7rPXYGd9D_Uj1rVsQdWT4oRz4QrYAJNpFX7rzqqMlZw2h2E2y5IKMUZ7ouD_SlcHxYq1yL4KbKUv3qtWgTK0A6QbGh87GB3sscrHRIQiG2RrmU_jF4tENr9wGS_YxoUSSDrYjWmrNfeEHSGSc3FyhNLlBU&key=SUA_CHAVE_DA_API

Autocompletar Local

É um serviço da web que retorna previsões de lugar como resposta a uma solicitação HTTP. Pode ser usado para fornecer funcionalidade de autocompletar para pesquisas geográficas baseadas em texto. Aqui está um exemplo de uma solicitação para estabelecimentos:

https://maps.googleapis.com/maps/api/place/autocomplete/xml?input=Amoeba&types=establishment&location=37.76999,-122.44696&radius=500&key=SUA_CHAVE_DA_API

Autocompletar de Consulta

Este tipo de serviço é usado para fornecer uma previsão de consulta para pesquisas geográficas baseadas em texto, retornando consultas sugeridas conforme o usuário digita. Uma solicitação de exemplo se parece com isso:

https://maps.googleapis.com/maps/api/place/queryautocomplete/json?key=SUA_CHAVE_DA_API&input=pizza+near%20par

Preços e limites da API do Google Places

Aqui o Google utiliza um modelo de preços pay-as-you-go. Isso significa que as APIs da Google Maps Platform são faturadas por SKU. O uso é rastreado para cada SKU de Produto, e uma API pode ter mais de um SKU de Produto. 

Há 1.000 pesquisas gratuitas na API de Lugares a cada 24 horas, mas você pode aumentá-las para 150.000 pesquisas gratuitas por 24 horas habilitando a faturação no Console da Google Cloud. 

Você pode verificar a API do Google Place documentação para encontrar mais detalhes sobre todos os preços e limites. 

FAQ

Conclusão

Neste artigo, discutimos o que é a API do Google Places, como obter uma chave da API, como restringir a chave da API, exemplos de como usar a API e os preços e limites associados. A API de Lugares do Google é uma ferramenta poderosa para integrar informações de localização em suas aplicações ou sites.