Informações gerais

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 com reconhecimento de local para disponibilizar dados de localização detalhados facilmente 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:

  • Exiba aluguéis em condomínios nas principais áreas metropolitanas com resultados segmentados especificamente para cidades.
  • Inclua detalhes do lugar em uma atualização do status de retirada ou entrega.
  • Mostre uma lista dos parques em uma área, além de avaliações e fotos enviadas pelos usuários.
  • Forneça às pessoas que planejam viagens dados de contato, avaliações e níveis de preços para os 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 da 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 de usuários.
  • Ative os recursos de preenchimento automático para diferentes tipos de pesquisa, seja para consultas de texto específicas ou categóricas.
  • Refine o tipo de detalhe retornado sobre um lugar, como horário de funcionamento, resumo, avaliações de usuários e 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, que identificam um lugar de maneira exclusiva no banco de dados do Google Places e no Maps. Existem muitas maneiras de conseguir um ID de local, inclusive pela API Places, mas também pela API Geocoding, API Routes e API Address Validation.

Depois de conseguir 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.

Escolha sua versão da API Places

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

Com o lançamento da API Places (nova), sua primeira tarefa é decidir qual conjunto de APIs usar. Isso é válido se você é um novo cliente ou um cliente atual que já usa as APIs. Use este guia para aprender 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 lugar solicitado e retornar os componentes de 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 recurso Text Search (novo) foi substituído.
Nearby Search (link em inglês) Nearby Search (novo) Todas as solicitações que usam a API existente que incluem uma consulta de texto precisam usar Text Search (New) porque o Nearby Search (novo) não é compatível com a entrada de texto.
Text Search (em inglês) Text Search (novo)
Place Details Place Details (novo)
Place Photo (em inglês) Place Photo (novo)
Place Autocomplete Preenchimento automático (novo) Em pré-lançamento
Preenchimento automático de consultas Preenchimento automático (novo) Recursos adicionados à versão de pré-lançamento do Autocomplete (novo)

Como usar a API Places

As etapas abaixo abrangem um cenário de caso de uso típico do serviço da API Places. Ao desenvolver sua solução, você pode usar outros endpoints, como o Nearby Search e o Place Photos.
1 Começar a configurar Comece com 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 Emita uma pesquisa de texto simples usando o Text Search (novo) ou o Text Search.
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 o 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.