A API Places Aggregate é um serviço que fornece insights sobre lugares em uma área especificada com base em critérios como localização, tipo, status operacional, nível de preço e avaliações dos usuários. Esse serviço pode ajudar a analisar a densidade de tipos de lugares específicos em torno de um local determinado e responder a perguntas como: "Quais ou quantos restaurantes com classificação de 5 estrelas e $$$ estão em um raio de 5 km deste local?"
Os resultados são retornados como contagens agregadas ou os IDs de lugar identificados na área de interesse da pesquisa. Os usuários podem usar a API Place Details para recuperar mais informações sobre esses IDs de lugar.
Por que usar a API Places Aggregate
Com a API Places Aggregate, seus usuários podem tomar decisões baseadas em dados com base nas informações abrangentes que você fornece sobre vários lugares. Ele usa modelos de lugar precisos e atualizados, que oferecem suporte aos seguintes casos de uso principais:
- Empresas: analise a concorrência e os locais em potencial para novas filiais.
- Desenvolvedores: criar aplicativos que ofereçam recomendações personalizadas.
- Pesquisadores: analisam tendências e padrões em áreas específicas.
O que você pode fazer com a API Places Aggregate
Com a API Places Aggregate, é possível receber as seguintes informações:
- Contagens: recupera o número de lugares que correspondem aos seus critérios.
- IDs de lugares: recupere IDs de lugares de locais específicos que correspondem aos seus critérios.
Você também pode usar a filtragem para refinar sua pesquisa com base em vários atributos, como tipos de lugar, horário de funcionamento, níveis de preço e avaliações dos clientes.
Exemplos
Esta seção descreve exemplos de casos de uso da API Places Aggregate e inclui código funcional para cada exemplo.
Abrir um novo café
O proprietário de um restaurante quer abrir um novo café. Para isso, primeiro eles querem visualizar onde estão os pontos de interesse dos cafés para identificar áreas de alta e baixa concentração e informar a decisão de negócios. A API Places Aggregate pode ajudar a analisar o número de cafés em um raio específico com base em atributos como status de operação, níveis de preços e classificações dos clientes para tomar uma decisão baseada em dados sobre onde abrir a próxima unidade.
Empresa de investimento imobiliário
Uma empresa de investimento imobiliário quer melhorar os modelos financeiros e determinar com precisão o ROI dos investimentos planejados em imóveis. Ao usar a API Places Aggregate, eles podem coletar dados detalhados sobre as comodidades próximas a possíveis propriedades de investimento, como caixas eletrônicos, hospitais, estações de transporte público e supermercados, para entender as comodidades próximas a possíveis propriedades de investimento.
Serviço de entrega de varejo
Ao expandir para uma nova cidade, um serviço de entrega de varejo precisa determinar o número de motoristas a serem alocados em uma região com base na densidade de destinos populares para consumidores, como restaurantes, lojas de conveniência e lojas de bebidas. Usando a API, o serviço de entrega conta o número total desses estabelecimentos em toda a cidade para que eles possam planejar e alocar recursos de maneira eficaz.
Como a API Places Aggregate funciona
Com a API Places Aggregate, é possível especificar filtros para restringir os critérios de pesquisa.
Depois de selecionar um Tipo de insight de INSIGHT_COUNT ou INSIGHT_PLACES, você pode adicionar critérios de filtro, incluindo:
- Local: defina a área de interesse usando círculos, regiões ou polígonos personalizados.
- Tipo: especifique os tipos de lugares em que você tem interesse.
- Status das operações: filtre lugares com base no status operacional deles.
- Níveis de preço: filtre lugares com base nos níveis de preço.
- Classificações: filtre lugares com base nas classificações dos usuários.
O objeto ComputeInsightsResponse da resposta da API contém os resultados do insight de solicitação. Por exemplo, se você selecionou INSIGHT_COUNT, a resposta
contém um número total de lugares. Se você selecionou INSIGHT_PLACES, a
resposta contém uma lista de IDs de lugar.
Como usar a API Places Aggregate
| 1 | Comece a configuração. | Comece com Configurar seu projeto do Google Cloud e siga as instruções abaixo. |
| 2 | Faça uma solicitação para receber a contagem de lugares correspondentes. | Consulte Fazer sua primeira solicitação. |
| 3 | Saiba mais sobre os parâmetros de solicitação. | Consulte Parâmetros de solicitação. |
A seguir
- Verifique os preços e limites de uso
- Acessar a referência da API
- Consulte as perguntas frequentes
- Conferir as opções de suporte