Introdução
A API Places é um serviço que aceita solicitações HTTP de dados de localização usando vários métodos. Ela retorna dados de localização formatados e imagens sobre estabelecimentos, localizações geográficas ou pontos de interesse.Por que usar a API Places (nova)
Crie recursos com reconhecimento de localização para disponibilizar dados detalhados de localização aos usuários. Os dados disponíveis na API Places (nova) são baseados 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 direcionados especificamente para cidades.
- Incluir detalhes do lugar em uma atualização de status de coleta ou entrega.
- Mostrar uma lista de parques em uma área com fotos e avaliações enviadas pelos usuários.
- Fornecer 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)
Você pode usar a API Places (nova) 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 consultas de usuários.
- Ativar recursos de preenchimento automático para diferentes tipos de pesquisa, consultas de texto específicas ou consultas categóricas.
- Refinar o tipo de detalhes retornados sobre um lugar, como horário de funcionamento, um resumo, avaliações de usuários e uma foto.
- Adicionar fotos de alta qualidade aos locais atendidos pelo seu aplicativo.
Muitas APIs da Plataforma Google Maps oferecem suporte a IDs de lugar, onde 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 de a API Places (nova), mas também da API Geocoding, da API Routes e da API Address Validation.
Depois de ter um ID de lugar, você pode usar 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 (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 (nova) 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 (nova) e Place Photos (nova).| 1 | Configurar | Configure o faturamento, ative a API Places (nova) e faça sua primeira solicitação. |
| 2 | Testar 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 IDs de lugar para receber Place Details (nova). |
| 4 | Receber uma foto de um lugar | O Place Photos (novo) oferece acesso a milhões de fotos armazenadas no banco de dados do Places. Use Place Photos (novo) para acessar fotos de um lugar. |