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 local usando vários métodos. Ela retorna dados e imagens de local formatados sobre estabelecimentos, localizações geográficas ou pontos de interesse importantes.

Por que usar a API Places

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

  • Exiba aluguéis de condomínios nas principais áreas metropolitanas com resultados segmentados especificamente para cidades.
  • Inclua detalhes do lugar em uma atualização de status de retirada ou entrega.
  • Mostra uma lista de parques em uma área junto com fotos e avaliações enviadas pelos usuários.
  • Forneça às pessoas que planejam viagens dados de contato, avaliações e faixas de preços para estabelecimentos.

O que você pode fazer com a API Places

Você pode 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 do usuário.
  • Ative os recursos de preenchimento automático para diferentes tipos de pesquisa, seja com consultas de texto específicas ou categóricas.
  • Refine 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 veiculados pelo seu aplicativo.

Muitas APIs da Plataforma Google Maps são compatíveis com IDs de lugar, em que o ID de lugar identifica um lugar de forma exclusiva no banco de dados do Google Places e no Google Maps. Existem muitas maneiras de se conseguir um ID de local, incluindo a API Places, a API Geocoding, a API Routes e a API Address Validation.

Depois de criar 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 de usuários e avaliações.

Escolher sua versão da API Places

A API Places é compatível com duas versões: a API Places são as atuais, e a API Places (nova) são as versões de última geração.

Com o lançamento da API Places (nova), sua primeira tarefa é decidir qual conjunto de APIs usar. Isso acontece quando você é um cliente novo ou atual que já usa as APIs. Use este guia para saber as principais diferenças entre as duas APIs.

Como a API Places funciona

API Places (nova)

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) é compatível com a autorização por chave de API e token OAuth. O exemplo a seguir faz uma solicitação do Place Details para retornar os componentes de 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

API 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. A solicitação de serviço usa parâmetros relevantes para esse endpoint específico para refinar os dados retornados. O exemplo a seguir faz uma solicitação do Place Details para retornar os componentes de endereço de um ID de lugar 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 do endereço no formato JSON.

Recursos

A tabela a seguir resume os recursos disponíveis na API Places.

API Places API Places (nova) Observação
Find Place Text Search (novo) Não há nova versão do Find Place. O Text Search (novo) o substituiu.
Pesquisa de locais próximos Pesquisa do Nearby (novo) Todas as solicitações que usam a API atual e incluem uma consulta de texto precisam usar Text Search (nova), porque o Nearby Search (novo) não é compatível com entrada de texto.
Pesquisa de texto Text Search (novo)
Place Details Place Details (novo)
Place Photo Place Photo (novo)
Place Autocomplete Nenhuma versão da API Places (nova)
Preenchimento automático de consultas Nenhuma versão da API Places (nova)

Como usar a API Places

As etapas abaixo abrangem um cenário de caso de uso típico do serviço da API Places. À medida que você cria a solução, pode usar outros endpoints, como Nearby Search e Place Photos.
1 Começar a configurar Comece em Configurar seu projeto do Google Cloud, conclua as instruções de configuração a seguir. Depois, saiba como usar a chave de API. Para a API Places (nova), você também pode usar tokens OAuth.
2 Fazer uma pesquisa de texto básica Faça uma pesquisa de texto simples usando o Text Search (novo) ou o Text Search.
3 Use o ID de lugar para ver mais detalhes Muitas APIs da Plataforma Google Maps retornam um ID de lugar como parte de uma resposta. Use esse ID para ver detalhes sobre um lugar. Consulte Place Details (novo) e Place Details.
4 Tirar a foto de um lugar O serviço Place Photo dá acesso a milhões de fotos armazenadas no banco de dados do Places. Use Place Photo (novo) ou Place Details para acessar fotos de um lugar.