Por que usar a API Places (nova)
Crie recursos com base na localização para disponibilizar dados de local detalhados 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:
- 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 níveis de preço dos estabelecimentos pelo caminho.
O que você pode fazer com a API Places (nova)
É possível usar a API Places (nova) para incluir os seguintes recursos nos seus apps:
- 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, seja 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 oferecem suporte a IDs de lugar, em que o ID identifica 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, você pode usar a API Places (nova) 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 (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 o Nearby Search (novo) e o Place Photos (novo).| 1 | Configurar | Comece por 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 receber Detalhes do lugar (novo). |
| 4 | Conseguir uma foto de um lugar | O Place Photos (novo) permite acessar milhões de fotos armazenadas no banco de dados do Places. Use Fotos do lugar (novo) para acessar as fotos de um lugar. |