Visão geral

A API Places Insights é um serviço que fornece insights sobre lugares em uma área especificada com base em critérios como localização, tipo, status de operação, nível de preço e classificações do usuário. Esse serviço pode ajudar a analisar a densidade de tipos de lugares específicos em torno de um determinado local e responder a perguntas como "Quantos ou quais restaurantes $$$ com classificação de 5 estrelas estão a um raio de 5 km desse local?"

Os resultados são retornados como contagens agregadas ou os IDs de lugar identificados na área de pesquisa de interesse. Os usuários podem usar a API Place Details para extrair mais informações sobre esses IDs de lugar.

Por que usar a API Places Insights

A API Places Insights permite que seus usuários tomem 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:

  • Empresas: analise a concorrência e os locais em potencial para novas filiais.
  • Desenvolvedores: crie aplicativos que ofereçam recomendações personalizadas.
  • Pesquisadores: examinam tendências e padrões em áreas específicas.

O que você pode fazer com a API Places Insights

Com a API Places Insights, é possível receber insights das seguintes maneiras:

  • Insights de contagem: extraia o número de lugares que correspondem aos seus critérios.
  • Insights de lugares: extraia IDs de lugar de lugares específicos que correspondem aos seus critérios.
  • Filtragem: refine sua pesquisa com base em vários atributos, como tipos de lugar, horário de funcionamento, faixas de preço e classificações dos clientes.

Exemplos

Abrir um novo café

O proprietário de um restaurante quer abrir um novo café. Para isso, primeiro ele quer visualizar onde estão os pontos de acesso dos cafés para identificar áreas de alta e baixa concentração e informar a decisão de negócios. A API Places Insights 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ço e classificações do cliente para tomar uma decisão com base em dados sobre onde abrir a próxima unidade.

Amostra

Um mapa de São Francisco e as notas de entretenimento por CEP.

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 planejados em propriedades. Ao usar a API Places Insights, eles podem coletar dados detalhados sobre as comodidades próximas a possíveis investimentos, como caixas eletrônicos, hospitais, estações de transporte e supermercados, para entender as comodidades próximas a possíveis investimentos.

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 entregadores a serem alocados em uma região com base na densidade de destinos de consumidores populares, como restaurantes, lojas de conveniência e armazém de bebidas alcoólicas. 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.

Amostra

Mapa de calor de restaurantes por volume em Mountain View.

Como a API Places Insights funciona

A API Places Insights permite especificar filtros para restringir os critérios de pesquisa. Depois de selecionar um tipo de insight (INSIGHT_COUNT ou INSIGHT_PLACES), é possível 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.
  • Níveis de preço: filtre lugares com base nos níveis de preço.
  • Avaliações: filtre lugares com base nas classificações dos usuários.

O objeto ComputeInsightsResponse da resposta da API contém os resultados do 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 lugar.