Visão geral

Selecione a plataforma: Android iOS JavaScript Serviço da Web
A API Places é um serviço que aceita solicitações HTTP para dados de localização por meio de vários métodos. Ela retorna dados de localização formatados e imagens sobre estabelecimentos, localizações geográficas ou pontos de interesse de destaque.

Por que usar a API Places

Crie recursos com reconhecimento de local para disponibilizar dados de localização detalhados aos usuários com facilidade. Os dados disponíveis por meio da API Places são criados em um dos modelos de lugar mais precisos, atualizados e abrangentes do mundo real. Veja alguns exemplos de casos de uso de aplicativos:

  • Exibir aluguel de condomínios em grandes áreas metropolitanas com resultados segmentados especificamente para cidades.
  • Inclua detalhes do lugar em uma atualização do status de retirada ou entrega.
  • Exiba uma lista de parques em uma área junto com fotos e comentários enviados pelos usuários.
  • Forneça aos usuários que planejam viagens dados de contato, avaliações e níveis de preços para estabelecimentos durante o trajeto.

O que você pode fazer com a API do Google Places

Você pode usar a API Places para incluir os seguintes recursos nos seus aplicativos:

  • Forneça resultados de pesquisa de lugar de diferentes tipos de consultas de usuários, como entrada de texto, locais próximos e consultas de usuário ambíguas ou categóricas.
  • Ative os recursos de preenchimento automático para diferentes tipos de pesquisa, sejam elas consultas de texto específicas ou categóricas.
  • Refine o tipo de detalhes retornados sobre um lugar, como horário de funcionamento, um resumo, avaliações de usuários e uma foto.
  • Adicione fotos de alta qualidade aos locais atendidos pelo seu aplicativo.

Como funciona a API do Google Places

A API Places aceita solicitações como um URL padrão com um endpoint de serviço específico, como /place ou /photo. Os endpoints também aceitam o tipo de formato especificado na solicitação, JSON ou XML. Por fim, a solicitação de serviço usa parâmetros relevantes para esse endpoint específico para refinar os dados retornados. Por exemplo, a solicitação do Place Details a seguir para componentes de endereço funciona da seguinte maneira, supondo um retorno no formato JSON: 

https://maps.googleapis.com/maps/api/place/details/json
  ?place_id=ChIJrTLr-GyuEmsRBfy61i59si0
  &fields=address_components
  &key=YOUR_API_KEY

Nesse caso, o serviço usa o ID de lugar fornecido para encontrar o local solicitado e retornar os componentes de endereço no formato JSON.

Recursos

A tabela a seguir resume os recursos disponíveis por meio da API Places junto com os dados retornados.

Recursos de dados Dados retornados Formato de retorno
Pesquisa de local Retorna uma lista de lugares com base na localização de um dispositivo ou em uma string de pesquisa.

Veja detalhes das respostas de pesquisa de local, pesquisa de local próximo e respostas de pesquisa de texto.

  • JSON
  • XML
Detalhes do lugar Retorna informações mais detalhadas sobre um local específico, incluindo comentários de usuários.

Veja detalhes nas respostas do Place Details.

  • JSON
  • XML
Fotos do lugar Fornece acesso a milhões de fotos relacionadas a lugares armazenados no banco de dados de locais do Google.

Veja os detalhes da resposta do Place Photos.

  • JSON
  • XML
Preenchimento automático de lugares Preenche automaticamente o nome e/ou o endereço de um lugar à medida que os usuários digitam.

Veja os detalhes das respostas do Place Autocomplete.

  • JSON
  • XML
Preenchimento automático de consulta Fornece um serviço de previsão de consulta para pesquisas geográficas baseadas em texto, retornando consultas sugeridas à medida que os usuários digitam.

Veja os detalhes das respostas de preenchimento automático de consulta.

  • JSON
  • XML

Como usar a API Places

As etapas abaixo abrangem um cenário típico de caso de uso para usar três dos endpoints no serviço da API Places. Ao criar sua solução, é possível usar endpoints adicionais, como Nearby Search, Place Photos e Query Autocomplete.
1 Começar a configurar Comece com Configurar seu projeto do Google Cloud e siga as instruções de configuração a seguir. Em seguida, veja como usar a chave de API.
2 Fazer uma pesquisa de texto básica Quando você tiver uma chave de API, faça uma pesquisa de texto simples, conforme indicado nos exemplos básicos de pesquisa de texto, no guia Pesquisa de texto.
3 Usar uma solicitação do Find Place As solicitações do Find Place retornam um ID de lugar, além dos campos de dados solicitados, como horário de funcionamento, endereço e fotos. Veja exemplos de Find Place e tente um mais relevante para seu caso de uso.
4 Noções básicas sobre a resposta do Find Place Explore os dados retornados da resposta do Find Place. Consulte Encontrar respostas sobre lugares para ver mais detalhes.
5 Usar o ID de lugar para ver mais detalhes As respostas do Find Place não fornecem todos os dados disponíveis para um determinado local. Você pode usar o ID de local retornado de uma resposta do Find Place para ver ainda mais detalhes sobre ele. Consulte Place Details.

Bibliotecas de clientes disponíveis

Chame essa API no idioma de sua escolha por meio de uma das seguintes bibliotecas de cliente:

Os clientes Java, Python, Go e Node.js dos serviços do Google Maps são bibliotecas de cliente com suporte da comunidade e código aberto sob a Licença Apache 2.0 (em inglês). Faça o download deles no GitHub, onde também é possível encontrar instruções de instalação e códigos de amostra.

A seguir