A API Places Aggregate é um serviço que fornece insights sobre lugares em uma área especificada com base em critérios como local, tipo, status de funcionamento, nível de preço e avaliações de usuários. Esse serviço pode ajudar a analisar a densidade de tipos de lugares específicos em um determinado local e responder a perguntas como "Quais ou quantos restaurantes $$$ com classificação de 5 estrelas estão em um raio de 5 km deste local?"
Os resultados são retornados como contagens agregadas ou como os IDs de lugares identificados na área de pesquisa de interesse. Os usuários podem usar a API Place Details para recuperar mais informações sobre esses IDs de lugares.
Por que usar a API Places Aggregate
A API Places Aggregate permite que os usuários tomem decisões orientadas por dados com base nas informações abrangentes que você fornece sobre vários lugares. Ela aproveita modelos de lugares 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: crie aplicativos que ofereçam recomendações personalizadas.
- Pesquisadores: examine tendências e padrões em áreas específicas.
O que você pode fazer com a API Places Aggregate
Com a API Places Aggregate, você pode receber as seguintes informações:
- Contagens: recupere o número de lugares que correspondem aos seus critérios.
- IDs de lugares: recupere IDs de lugares específicos que correspondem aos seus critérios.
Você também pode usar a filtragem para refinar a pesquisa com base em vários atributos, como tipos de lugares, horário de funcionamento, níveis de preço e avaliações de clientes.
Exemplos
Esta seção descreve exemplos de casos de uso da API Places Aggregate e inclui um código funcional para cada exemplo.
Abrir um novo café
O proprietário de um restaurante quer abrir um novo café. Para isso, ele primeiro quer 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 funcionamento, níveis de preço e avaliações de clientes para tomar uma decisão baseada em dados sobre onde abrir o próximo local.
Empresa de investimento imobiliário
Uma empresa de investimento imobiliário quer aprimorar os modelos financeiros e determinar com precisão o ROI dos investimentos imobiliários planejados. Ao usar a API Places Aggregate, ela pode coletar dados detalhados sobre as comodidades próximas a imóveis de investimento em potencial, como caixas eletrônicos, hospitais, estações de transporte público e supermercados, para entender as comodidades próximas a imóveis de investimento em potencial.
Serviço de entrega de varejo
Ao se expandir para uma nova cidade, um serviço de entrega de varejo precisa determinar o número de entregadores a serem alocados em uma região com base na densidade de destinos de consumo populares, 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 planejar e alocar recursos de maneira eficaz.
Como a API Places Aggregate funciona
A API Places Aggregate permite especificar filtros para restringir os critérios de pesquisa.
Depois de selecionar um tipo de insight INSIGHT_COUNT ou INSIGHT_PLACES, você pode adicionar critérios de filtro, incluindo o seguinte:
- Local: defina a área de interesse usando círculos, regiões ou polígonos personalizados.
- Tipo: especifique os tipos de lugares em que você está interessado.
- Status de funcionamento: filtre lugares com base no status operacional.
- Níveis de preço: filtre lugares com base nos níveis de preço.
- Avaliações: filtre lugares com base nas avaliações dos usuários.
O objeto de resposta da API ComputeInsightsResponse contém os resultados de
o insight da 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 lugares.
Como usar a API Places Aggregate
| 1 | Configure. | Comece com Configurar seu projeto do Google Cloud e siga as instruções. |
| 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
- Analise os preços e limites de uso
- Consulte a referência da API
- Consulte as perguntas frequentes
- Consulte as opções de suporte