Consultar mudanças de PDI entre meses (PLACES_COUNT_CHANGE)

A função PLACES_COUNT_CHANGE calcula as mudanças nas contagens de lugares de interesse e recupera exemplos de IDs de lugares adicionados e removidos entre dois meses específicos em várias regiões geográficas de entrada.

Assim como PLACES_COUNT_V2, essa função foi projetada para processamento em lote eficiente, aceitando um parâmetro de tabela de entrada de regiões geográficas, permitindo que você avalie tendências de crescimento e mudanças comerciais em vários locais simultaneamente.

Sintaxe

SELECT *
FROM
  `PROJECT_NAME.LINKED_DATASET_NAME.PLACES_COUNT_CHANGE`(
    TABLE input_geographies,
    filters
  );

Parâmetros

• PROJECT_NAME: o nome do seu projeto na nuvem do Google Cloud;
• LINKED_DATASET_NAME: o nome do conjunto de dados do BigQuery que contém as funções do Insights de Lugares (por exemplo, places_insights___us).
• input_geographies: uma tabela do BigQuery que contém as regiões geográficas a serem analisadas. Essa tabela precisa incluir as seguintes colunas:
  • geo_id (STRING): um identificador exclusivo para cada região geográfica.
  • geo (GEOGRAPHY): O objeto GEOGRAPHY do BigQuery que representa a área. Pode ser um ponto, um polígono ou outro tipo de região geográfica.
• filters (JSON): um objeto JSON que contém pares de chave-valor para filtrar os lugares. Consulte Parâmetros de filtro. Ele precisa incluir os seguintes filtros:
  • month1 (STRING): o primeiro mês em que os lugares serão procurados.
  • month2 (STRING): o segundo mês em que os lugares serão procurados.

Esquema da tabela de saída

A função PLACES_COUNT_CHANGE retorna uma tabela com colunas:

Os resultados são classificados por percentage_change e start_count em ordem decrescente.

Como funciona

A função processa cada linha na tabela input_geographies. Para cada geo objeto, ela conta o número de lugares que estão dentro da região geográfica (ou dentro do geography_radius se o geo for um ponto e o raio for especificado nos filters) nos dois meses especificados em month1 e month2 nos filters. Usando esses lugares, ela calcula outras estatísticas úteis, como a mudança percentual e a taxa de crescimento mensal composta do primeiro para o segundo mês.

A contagem inclui apenas os lugares que correspondem a todas as condições definidas no objeto JSON filters.

Exemplo: calcular mudanças nas contagens de POIs entre dois meses

Este exemplo demonstra como consultar as mudanças nas contagens de POIs entre dois meses específicos usando os parâmetros month1 e month2, com um raio de 5.000 de um determinado ponto de geolocalização.

WITH my_locations AS (
  SELECT
    'loc_1' AS geo_id,
    ST_GEOGFROMTEXT('POINT(-122.4194 37.7749)') AS geo
  -- Add more target locations as needed...
)

SELECT *
FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_CHANGE`(
  TABLE my_locations,
  JSON_OBJECT(
    'geography_radius', 5000,
    'month1', '2026-01', -- Baseline snapshot month (YYYY-MM)
    'month2', '2026-02'  -- Comparison snapshot month (YYYY-MM)
  )
);

Analisar a saída

A consulta retorna uma tabela com uma linha para cada região geográfica de entrada.

• Métricas de crescimento:a saída mostra a contagem de linha de base (start_count: 89.560) e a contagem de comparação (end_count: 90.923), resultando em uma net_change de +1.363 lugares (+1,52% percentage_change).
• Inspeção de verdade básica:a matriz sample_added_place_ids lista IDs de lugares específicos que ficaram ativos em month2 (fevereiro de 2026), enquanto sample_removed_place_ids lista IDs de lugares que não estão mais presentes.
• Ponte para a API Places:é possível transmitir esses IDs de lugares de amostra diretamente para a API Place Details (New) para pesquisar nomes de lojas, endereços e atributos de empresas recém-abertas ou fechadas.