Por que usar a API Places
Crie recursos com base na localização para disponibilizar dados de local detalhados aos usuários. Os dados disponíveis na API Places 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.
- Inclua 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 preços dos estabelecimentos pelo caminho.
O que você pode fazer com a API Places
É possível usar a API Places para incluir os seguintes recursos nos seus aplicativos:
- 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, como 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 veiculados pelo seu app.
Muitas APIs da Plataforma Google Maps aceitam IDs de lugar, que identificam um lugar de forma exclusiva no banco de dados do Google Places e no Google Maps. Há muitas maneiras de conseguir um ID de lugar, incluindo a API Places, mas também a API Geocoding, a API Routes e a API Address Validation.
Depois de ter um ID de lugar, você pode 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, classificação do usuário e avaliações.
Escolher a versão da API Places
A API Places oferece suporte a duas versões: a API Places são as APIs atuais, e a API Places (nova) são as versões de próxima geração.
Com o lançamento da API Places (nova), sua primeira tarefa é decidir qual conjunto de APIs usar. Isso é verdadeiro se você for um cliente novo ou 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) oferece suporte à autorização por chave de API e token OAuth.
O exemplo a seguir faz uma solicitação de detalhes do lugar 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
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 de detalhes do lugar para retornar os componentes do 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 | Pesquisa de texto (nova) | Não há uma nova versão do Find Place. O Text Search (novo) substituiu essa opção. |
| Pesquisa por proximidade | Pesquisa por proximidade (novo) | Todas as solicitações que usam a API atual e incluem uma consulta de texto precisam usar a Pesquisa de texto (nova), porque a Pesquisa nas proximidades (nova) não oferece suporte à entrada de texto. |
| Pesquisa de texto | Pesquisa de texto (nova) | |
| Detalhes do lugar | Detalhes do lugar (novo) | |
| Place Photo | Place Photo (novo) | |
| Place Autocomplete | Preenchimento automático (novo) | |
| Query Autocomplete | Preenchimento automático (novo) | Recursos adicionados ao preenchimento automático (novo) |
Como usar a API Places
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 a Pesquisa por proximidade e o Place Photos.| 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. Na API Places (nova), também é possível usar tokens OAuth. |
| 2 | Fazer uma pesquisa de texto básica | Faça uma pesquisa de texto 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 receber detalhes sobre um lugar. Consulte Place Details (novo) e Place Details. |
| 4 | Conseguir uma foto de um lugar | O serviço Place Photo permite acessar milhões de fotos armazenadas no banco de dados do Places. Use Place Photo (New) ou Place Details para acessar as fotos de um lugar. |