Visão geral

Selecione a plataforma: Android iOS JavaScript Web Service
A API Places é um serviço que aceita solicitações HTTP para dados de local usando vários métodos. Ele retorna dados de localização formatados e imagens sobre estabelecimentos, locais geográficos ou pontos de interesse importantes.

Por que usar a API Places

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

  • Mostrar aluguéis de apartamentos em grandes áreas metropolitanas com resultados segmentados especificamente para cidades.
  • Incluir detalhes do lugar em uma atualização do status de retirada ou entrega.
  • Mostrar uma lista de parques em uma área com fotos e avaliações enviadas pelos usuários.
  • Forneça às pessoas que planejam viagens informações de contato, avaliações e preços dos estabelecimentos pelo caminho.

O que você pode fazer com a API Places

É possível usar a API Places para incluir os seguintes recursos nos seus aplicativos:

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

Muitas APIs da Plataforma Google Maps aceitam IDs de lugar, que identificam de forma exclusiva um lugar no banco de dados do Google Places e no Google Maps. Há muitas maneiras de conseguir um ID de lugar, incluindo a API Places, mas também a API Geocoding, a API Routes e a API Address Validation.

Depois de ter um ID de lugar, você pode usar a API Places para solicitar mais detalhes sobre um estabelecimento ou ponto de interesse específico, como endereço completo, número de telefone, classificação do usuário e avaliações.

Como a API Places (nova) funciona

A API Places (nova) aceita solicitações como um URL padrão com um endpoint de serviço específico, como /places ou places:searchText, e retorna uma resposta JSON. A API Places (nova) oferece suporte à autorização por chave de API e token OAuth. O exemplo a seguir faz uma solicitação de Place Details (New) para retornar os componentes do endereço de um ID de lugar usando uma chave de API:

https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents&key=YOUR_API_KEY

Como usar a API Places

As etapas abaixo abrangem um cenário de caso de uso típico para usar o serviço da API Places. Ao criar sua solução, você pode usar outros endpoints, como Nearby Search (novo) e Place Photo (novo).
1 Configurar Comece com Configurar seu projeto do Google Cloud e siga as instruções de configuração. Depois, aprenda como usar sua chave de API.
2 Fazer uma pesquisa de texto básica Faça uma pesquisa de texto usando o Text Search (novo).
3 Usar o ID de lugar para mais detalhes Muitas APIs da Plataforma Google Maps retornam um ID de lugar como parte de uma resposta. Use os IDs de lugares para conferir os Detalhes do lugar (novo).
4 Adicionar uma foto a um lugar O serviço Place Photo (New) permite acessar milhões de fotos armazenadas no banco de dados do Places. Use Foto do lugar (novo) para acessar as fotos de um lugar.