Função PLACES_COUNT_PER_GEO

A função PLACES_COUNT_PER_GEO recebe uma matriz de áreas geográficas para pesquisa e retorna uma tabela de contagens de lugares por área. Por exemplo, se você especificar uma matriz de CEPs como a área de pesquisa, a resposta vai conter uma tabela com uma linha separada para cada CEP.

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 geographies parâmetro de filtro que especifica a área de pesquisa. O geographies parâmetro usa uma matriz de valores definidos pelo tipo de dados GEOGRAPHY do BigQuery, que oferece suporte a pontos, linhas e polígonos.

  • Opcional: outros parâmetros de filtro 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 lugares para cada área geográfica.

Exemplo: calcular o número de restaurantes em cada município da cidade de Nova York

Este exemplo gera uma tabela de contagens de restaurantes operacionais por município na cidade de Nova York.

Observação: como a tabela de resposta contém um campo geographies, você pode visualizá-la usando ferramentas que oferecem suporte a tipos GEOGRAPHY do BigQuery. Para um exemplo de visualização dos resultados de uma função, consulte Visualize resultados. Para mais informações e exemplos sobre como visualizar os resultados do Insights de Lugares, consulte Visualizar resultados da consulta.

Este exemplo usa o United States Census Bureau Data BigQuery conjunto de dados públicos para receber os limites dos três municípios da cidade de Nova York: "Queens","Kings" e "New York". Os limites de cada município estão contidos na coluna county_geom.

Este exemplo usa a função do BigQuery ST_SIMPLIFY para retornar uma versão simplificada de county_geom. A função ST_SIMPLIFY substitui cadeias quase retas de bordas 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"]
      )
);

A resposta da função:

Visualizar resultados

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

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. Você também pode selecionar 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 da consulta.