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 por meio da API Places são baseados em um dos bancos de dados mais precisos, modelos abrangentes de lugares 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 no seu 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 de usuários.
- Ativar 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 dos usuários e uma foto.
- Adicione fotos de alta qualidade aos locais atendidos pelo seu aplicativo.
Muitas APIs da Plataforma Google Maps são compatíveis IDs de lugar, em que o ID de lugar é exclusivo identifica um local no banco de dados do Google Places e no Google 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.
Quando você tiver um ID de lugar, poderá 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, e avaliações de usuários.
Escolher sua versão da API Places
A API Places é compatível com duas versões da API: API Places são as as APIs atuais e a API Places (Novos) 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 a ser usado. Isso é válido se você é um cliente novo ou atual cliente que já usa as APIs. Usar este guia para conhecer os principais as 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 uma
endpoint de serviço, como /places ou places:searchText
e retorna uma resposta JSON. A API Places (nova) aceita autorização de
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 uma
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 valor
endpoint de serviço, como /place ou /photo. Os endpoints também
aceitam o tipo de formato especificado na solicitação, JSON ou XML. O serviço
solicitação usa parâmetros relevantes para aquele 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 uma
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 local fornecido para encontrar o local solicitado e retornar os componentes de endereço no formato JSON.
Recursos
A tabela a seguir resume os recursos disponíveis no 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 usarem a API existente e que incluírem uma consulta de texto deverão usar 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. Conforme você constrói sua solução, é possível usar endpoints adicionais, como Nearby Search e Place Photos.| 1 | Configuração | Comece com a etapa Configurar seu projeto do Google Cloud e conclua as instruções de configuração a seguir e, em seguida, saiba como usar sua chave de API. Na API Places (nova), também é possível usar Tokens OAuth. |
| 2 | Faça uma pesquisa de texto básica | Emita uma pesquisa de texto simples usando Text Search (novo) ou Pesquisa de texto. |
| 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 obter detalhes sobre um local. 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 Places no seu banco de dados. Usar o Place Photo (novo) ou Place Details para acessar as fotos de um lugar. |