Por que usar a API Places
Crie recursos com reconhecimento de local para disponibilizar facilmente dados detalhados de local aos usuários. Os dados disponíveis na API Places são criados com base em um dos modelos de lugares mais precisos, atualizados e abrangentes do mundo real. Aqui estão exemplos de casos de uso para aplicativos:
- Exiba aluguéis de condomínios nas principais áreas metropolitanas com resultados segmentados especificamente para cidades.
- incluir detalhes do lugar em uma atualização de status de retirada ou entrega;
- Mostre uma lista de parques em uma área com fotos e avaliações enviadas por usuários.
- Forneça às pessoas que planejam viagens dados de contato, avaliações e níveis de preço para estabelecimentos ao longo do caminho.
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 para 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, sejam consultas de texto específicas ou categóricas.
- Refine o tipo de detalhes retornados sobre um lugar, como horário de funcionamento, um 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 aceitam IDs de lugar, em que o ID identifica exclusivamente um local no banco de dados do Google Places e no Maps. Há muitas maneiras de conseguir um ID de lugar, inclusive pela API Places, mas também pela API Geocoding, pela API Routes e pela API Address Validation.
Com um ID de lugar, você pode usar a API Places para solicitar mais detalhes sobre um estabelecimento ou ponto de interesse, como o endereço completo, o número de telefone, a classificação do usuário e as avaliações.
Escolher sua versão da API Places
A API Places aceita duas versões: a API Places é a API atual e a API Places (nova) é a versão 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ê for um cliente novo ou um 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) aceita 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 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 existe uma nova versão do Find Place. O Text Search (novo) a substituiu. |
| Nearby Search | Nearby Search (novo) | Todas as solicitações que usam a API existente e incluem uma consulta de texto precisam usar o Text Search (novo), porque o Nearby Search (novo) não é compatível com a entrada de texto. |
| Pesquisa de texto | Text Search (novo) | |
| Place Details | Place Details (novo) | |
| Place Photo | Place Photo (novo) | |
| Place Autocomplete | Autocomplete (novo) | |
| Preenchimento automático de consultas | Autocomplete (novo) | Recursos adicionados ao Autocomplete (novo) |
Como usar a API Places
As etapas abaixo abrangem um cenário de caso de uso típico da API Places. À medida que você cria sua solução, pode usar outros endpoints, como o Nearby Search e o Place Photos.| 1 | Configuração | Comece com Configurar seu projeto do Google Cloud e conclua as instruções de configuração a seguir. Depois, aprenda como usar sua chave de API. Na API Places (nova), você também pode usar tokens OAuth. |
| 2 | Faça uma pesquisa de texto básica | Faça uma pesquisa de texto simples usando Text Search (novo) ou 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 de lugar para consultar detalhes sobre um lugar. Consulte Place Details (novo) e Place Details. |
| 4 | Tirar uma foto de um lugar | O serviço Place Photo dá acesso a milhões de fotos armazenadas no banco de dados do Places. Use o Place Photo (novo) ou o Place Details para acessar as fotos de um lugar. |