Função PLACES_COUNT_PER_GEO

A função PLACES_COUNT_PER_GEO usa uma matriz de áreas geográficas para pesquisar e retorna uma tabela de contagens de lugares por área. Por exemplo, se você especificar uma matriz de códigos postais como a área de pesquisa, a resposta vai conter uma tabela com uma linha separada para cada código postal.

Como a função PLACES_COUNT_PER_GEO retorna uma tabela, chame-a usando uma cláusula FROM.

• Parâmetros de entrada:

  • Obrigatório: o parâmetro de filtro geographies que especifica a área de pesquisa. O parâmetro geographies usa uma matriz de valores definidos pelo tipo de dados GEOGRAPHY do BigQuery, que é compatível com pontos, linestrings e polígonos.

  • Opcional: parâmetros de filtro adicionais para refinar sua pesquisa.

• Retorna:

  • Uma tabela com uma linha por área geográfica. A tabela contém as colunas geography (GEOGRAPHY), count (INT64) e place_ids (ARRAY<STRING>), em que place_ids contém até 250 IDs de lugar para cada área geográfica.

Exemplo: calcular o número de restaurantes em cada condado da cidade de Nova York

Este exemplo gera uma tabela de contagens de restaurantes em funcionamento por condado na cidade de Nova York.

Este exemplo usa o conjunto de dados público do BigQuery com dados do United States Census Bureau para receber os limites dos três condados da cidade de Nova York: "Queens","Kings" e "New York". Os limites de cada condado estão na coluna county_geom.

Em seguida, este exemplo usa a função ST_SIMPLIFY do BigQuery para retornar uma versão simplificada de county_geom. A função ST_SIMPLIFY substitui cadeias de bordas quase retas por uma única borda longa.

DECLARE geos ARRAY<GEOGRAPHY>;

SET geos = (SELECT ARRAY_AGG(ST_SIMPLIFY(county_geom, 100))
            FROM `bigquery-public-data.geo_us_boundaries.counties`
            WHERE county_name IN ("Queens","Kings", "New York") AND state_fips_code = "36");

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_GEO`(
  JSON_OBJECT(
      'geographies', geos,
      'types', ["restaurant"],
      'business_status', ["OPERATIONAL"]
      )
);

Exemplo: calcular as contagens por município filtradas por marca

O exemplo a seguir usa o filtro brand_ids para recuperar contagens de lugares e IDs de lugares de amostra para marcas específicas, como Starbucks "1413758728321880760":

DECLARE geos ARRAY<GEOGRAPHY>;

SET geos = (SELECT ARRAY_AGG(ST_SIMPLIFY(county_geom, 100))
            FROM `bigquery-public-data.geo_us_boundaries.counties`
            WHERE county_name IN ("Queens","Kings", "New York") AND state_fips_code = "36");

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_GEO`(
  JSON_OBJECT(
      'geographies', geos,
      'brand_ids', ["1413758728321880760"], -- Filter for Starbucks
      'business_status', ["OPERATIONAL"]
      )
);

Visualizar resultados

As imagens a seguir mostram esses dados exibidos no Looker Studio como um mapa preenchido, incluindo o contorno de cada condado:

Para importar seus dados para o Looker Studio:

1. Execute a função acima para gerar os resultados.

2. Nos resultados do BigQuery, clique em Abrir em -> Looker Studio. Os resultados são importados automaticamente para o Looker Studio.

3. O Looker Studio cria uma página de relatório padrão e a inicializa com um título, uma tabela e um gráfico de barras dos resultados.

   

4. Selecione tudo na página e exclua.

5. Clique em Inserir -> Mapa preenchido para adicionar um mapa preenchido ao relatório.

6. Em Tipos de gráfico -> Configuração, configure os campos conforme mostrado abaixo:

   

7. O mapa preenchido aparece como acima. Se quiser, selecione Tipos de gráfico -> Estilos para configurar ainda mais a aparência do mapa.

Para mais informações e exemplos sobre como visualizar os resultados do Insights de Lugares, consulte Visualizar resultados de consultas.