Função PLACES_COUNT_PER_H3

A função PLACES_COUNT_PER_H3 usa uma área geográfica para pesquisa e retorna uma tabela de contagens de lugares por célula H3 na área de pesquisa.

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

• Parâmetros de entrada:

  • Obrigatório: O geography parâmetro de filtro que especifica a área de pesquisa. O parâmetro geography tem um valor definido pelo tipo de dados GEOGRAPHY do BigQuery, que aceita pontos, linhas e polígonos.

    Para exemplos de uso de diferentes tipos de geografias de pesquisa, como janelas de visualização e linhas, consulte a função PLACES_COUNT.

  • Obrigatório: o h3_resolution parâmetro de filtro que especifica a resolução H3 usada para agregar a contagem de lugares em cada célula H3. Os valores compatíveis são de 0 a 11.

  • Opcional: outros parâmetros de filtro para refinar a pesquisa.

• Retorna:

  • Uma tabela com uma linha por célula H3. A tabela contém as colunas h3_cell_index (STRING), geography (GEOGRAPHY), que define o polígono que representa a célula H3, count (INT64) e place_ids (ARRAY<STRING>), em que place_ids contém até 250 IDs de lugares para cada célula H3.

Exemplo: contar lojas de conveniência e supermercados acessíveis para cadeirantes por célula H3

O exemplo abaixo calcula o número de lojas de conveniência e supermercados acessíveis para cadeirantes em funcionamento por célula H3 na cidade de Nova York. As células H3 usam um nível de resolução de 8.

Este exemplo usa o Overture Maps Data BigQuery conjunto de dados públicos para acessar a geografia da cidade de Nova York.

DECLARE geo GEOGRAPHY;

-- Get the geography for New York City.
SET geo = (SELECT geometry FROM `bigquery-public-data.overture_maps.division_area`
  WHERE country = 'US' AND subtype = 'locality' AND names.primary = 'New York'  LIMIT 1);

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_H3`(
  JSON_OBJECT(
      'geography', geo,
      'types', ["convenience_store","grocery_store"],
      'wheelchair_accessible_entrance', true,
      'business_status', ['OPERATIONAL'],
      'h3_resolution', 8
    )
);

A resposta da função:

Visualizar resultados

As imagens a seguir mostram esses dados exibidos no Looker Studio como um mapa preenchido. Quanto mais escura a célula H3, maior a concentração de resultados:

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 da consulta.