Introdução
A API Places é um serviço que aceita solicitações HTTP de dados de local por vários métodos. Ele retorna dados de localização formatados e imagens sobre estabelecimentos, localizações geográficas ou pontos de interesse importantes.Por que usar a API Places (nova)
Crie recursos com reconhecimento de local para disponibilizar dados detalhados de localização aos usuários. Os dados disponíveis na API Places (nova) 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:
- Mostre aluguéis de apartamentos em grandes áreas metropolitanas com resultados segmentados especificamente para cidades.
- Inclua detalhes do lugar em uma atualização de status de retirada ou entrega.
- Mostrar uma lista de parques em uma área com fotos e avaliações enviadas pelos usuários.
- Forneça informações de contato, avaliações e níveis de preços de estabelecimentos ao longo do caminho para pessoas que estão planejando viagens.
O que você pode fazer com a API Places (nova)
É possível usar a API Places (New) para incluir os seguintes recursos nos seus aplicativos:
- Fornecer 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 recursos de preenchimento automático para diferentes tipos de pesquisa, seja consultas de texto específicas ou consultas categóricas.
- Refine o tipo de detalhes retornados sobre um lugar, como horário de funcionamento, um resumo, avaliações dos usuários e uma foto.
- Adicione fotos de alta qualidade aos locais atendidos pelo seu aplicativo.
Muitas APIs da Plataforma Google Maps oferecem suporte a 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 (nova), a API Geocoding, a API Routes e a API Address Validation.
Depois de ter um ID de lugar, use a API Places (nova) para pedir mais detalhes sobre um estabelecimento ou ponto de interesse específico, como endereço completo, número de telefone, classificação e avaliações de usuários.
Como a API Places (nova) funciona
A API Places (New) aceita solicitações como uma URL padrão com um endpoint de serviço específico, como /places ou places:searchText, e retorna uma resposta JSON.
A API Places (New) é compatível com autorização por chave de API e token OAuth.
O exemplo a seguir faz uma solicitação de detalhes do lugar (novo) 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
Como usar a API Places (nova)
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 Photos (novo).| 1 | Começar a configurar | Configure o faturamento, ative a API Places (nova) e faça sua primeira solicitação. |
| 2 | Fazer uma pesquisa de texto básica | Faça uma pesquisa de texto usando a Pesquisa de texto (nova). |
| 3 | Usar o ID do lugar para mais detalhes | Muitas APIs da Plataforma Google Maps retornam um ID de lugar como parte de uma resposta. Use IDs de lugar para receber Place Details (New). |
| 4 | Receber uma foto de um lugar | Com o Place Photos (novo), você tem acesso a milhões de fotos armazenadas no banco de dados do Places. Use Place Photos (nova) para acessar fotos de um lugar. |