As funções de contagem de lugares são outra maneira de consultar os dados do Places disponíveis no Places Insights. Essas funções são consultas SQL predefinidas que são executadas no BigQuery e complementam as consultas de dados de lugares. A principal diferença é que as funções não exigem um limiar mínimo de contagem, mas sim uma área mínima de pesquisa:
As consultas de conjuntos de dados de lugares só podem retornar contagens acima de 5, mas não impõem limitações ao tamanho da área de pesquisa.
As funções de contagem de lugares podem retornar qualquer contagem, incluindo 0, mas exigem uma área de pesquisa mínima de 40,0 metros por 40,0 metros (1.600 m2).
Use as funções de contagem de lugares se for importante saber quando uma consulta não retorna resultados ou se você precisar saber contagens baixas de lugares abaixo de 5. Por exemplo, a capacidade de retornar contagens baixas é importante para casos de uso de seleção de sites.
Funções e países compatíveis para contagem de lugares
O Places Insights é compatível com as seguintes funções:
PLACES_COUNT: retorna uma única linha contendo uma contagem de lugares.PLACES_COUNT_PER_TYPE: retorna uma tabela do BigQuery com a contagem de lugares por tipo.PLACES_COUNT_PER_GEO: retorna uma tabela do BigQuery com contagens de lugares por região geográfica.PLACES_COUNT_PER_H3: retorna uma tabela do BigQuery com contagens de lugares por célula H3.
Além das contagens de lugares, as funções PLACES_COUNT_PER_TYPE, PLACES_COUNT_PER_GEO e PLACES_COUNT_PER_H3 também retornam até 250 IDs de lugar por elemento da resposta.
Assim como os conjuntos de dados de lugares, as funções de contagem de lugares estão disponíveis para uma cidade principal de cada um dos países aceitos. Por exemplo, na Austrália, você pode acessar as funções de contagem de lugares para Sydney, Austrália.
Para conferir a lista completa de cidades e países em que o recurso está disponível, consulte Funções de contagem de lugares de referência no BigQuery.
Exemplo de função de contagem de lugares
O exemplo a seguir usa a função PLACES_COUNT para retornar o número de restaurantes
em funcionamento em um raio de 1.000 metros do Empire State Building em Nova
York:
SELECT `maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT`( JSON_OBJECT( 'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building 'geography_radius', 1000, -- Radius in meters 'business_status', ['OPERATIONAL'], 'types', ["restaurant"] ) ) as count;
A resposta contém uma única contagem:
Neste exemplo, a instrução SELECT faz referência à função PLACES_COUNT
para os Estados Unidos usando a sintaxe:
maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT
Para conferir a lista completa de cidades e países aceitos, consulte Funções de contagem de lugares de referência no BigQuery.
Use um
JSON_OBJECT
para transmitir argumentos à função. Este exemplo usa a função ST_GEOGPOINT do BigQuery para retornar um valor GEOGRAPHY de um ponto e transmitir esse valor ao parâmetro geography. Ele também transmite o raio de pesquisa ao redor do ponto e o tipo de lugar, "restaurant", a ser pesquisado.
Exemplo de contagem de lugares por tipo, região ou H3
Além das contagens de lugares, as funções PLACES_COUNT_PER_TYPE, PLACES_COUNT_PER_GEO e PLACES_COUNT_PER_H3 também retornam até 250 IDs de lugares incluídos na resposta.
Por exemplo, a função PLACES_COUNT_PER_TYPE retorna uma tabela de contagens de lugares por tipo de lugar. A resposta inclui uma matriz de IDs de lugar para os
lugares que correspondem a cada tipo. Você pode usar os IDs de lugar retornados para pesquisar informações sobre cada lugar.
A chamada de função a seguir retorna uma contagem de lugares com os tipos restaurant, cafe e bar:
SELECT * FROM `maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT_PER_TYPE`( JSON_OBJECT( 'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building 'geography_radius', 1000, -- Radius in meters 'types', ["restaurant", "cafe", "bar"], 'business_status', ['OPERATIONAL'] ) );
Essa função retorna uma tabela com três colunas: type, count e sample_place_ids. As colunas count mostram a contagem de lugares para cada type, e a coluna sample_place_ids mostra até 250 IDs de lugares para cada type.
Aplicar filtros à função
Aplique filtros para restringir os critérios de pesquisa. As funções de contagem de lugares são compatíveis com muitos filtros para refinar sua pesquisa. No próximo exemplo, você aplica filtros para limitar a pesquisa por classificação mínima do usuário, nível de preço, status da empresa e se o restaurante aceita cachorros:
SELECT `maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT`( JSON_OBJECT( 'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building 'geography_radius', 1000, -- Radius in meters 'business_status', ['OPERATIONAL'], 'types', ["restaurant"], 'min_rating', 1.3, 'price_level', ['PRICE_LEVEL_INEXPENSIVE', 'PRICE_LEVEL_MODERATE'], 'allows_dogs', TRUE ) ) as count;
Visualizar resultados
As ferramentas de análise e Business Intelligence são cruciais para ajudar você a descobrir insights dos seus dados do BigQuery. O BigQuery é compatível com várias ferramentas de visualização de dados do Google e de terceiros que podem ser usadas para analisar os resultados das suas funções nos dados do Places Insights.
Para um exemplo de como visualizar os resultados de uma função, consulte Visualizar resultados. Para mais informações e um exemplo de como visualizar os resultados do Places Insights, consulte Visualizar resultados da consulta.
Limitações e requisitos
As funções de contagem de lugares têm as seguintes limitações e requisitos:
- Há suporte apenas para insights
COUNT. - É necessário ter uma área de pesquisa mínima de 40,0 metros por 40,0 metros (1.600 m2).
- O tamanho da entrada do parâmetro de contagem da função de lugar é limitado a 1 MB.
- Não há suporte para filtragem por ID de lugar ou componente de endereço.
Comparar funções de contagem de lugares e consultas de conjuntos de dados de lugares
A tabela a seguir lista as principais diferenças:
| Funções de contagem de lugares | Fazer consultas de conjunto de dados | |
|---|---|---|
| Interface | Quatro funções SQL predefinidas que geram insights de COUNT: contagem única, contagem por tipo, contagem por região e contagem por célula H3. |
Usa SQL para executar funções de agregação, como COUNT, COUNT_IF, SUM e AVG.. Outros insights podem ser gerados usando JOIN, GROUP BY, WHERE e outras funções. |
| Restrições | Impõe uma área de pesquisa mínima de 40,0 metros por 40,0 metros (1.600 m2). Uma função retorna um resultado mesmo que a contagem de agregação seja menor que 5, desde que a área mínima de pesquisa seja atendida. | Impõe um limite de contagem de 5, mas não uma área de pesquisa mínima. |
| Filtros de atributos aceitos | Esquema completo compatível, exceto:
|
Esquema completo compatível |
| Benefícios |
|
|
Funções de contagem de lugares de referência no BigQuery
As funções de contagem de lugares são compatíveis com as seguintes cidades e países. Você precisa assinar cada cidade e país separadamente.
| Cidade, país | Nomes de tabela |
|---|---|
| Sydney, Austrália | maps-platform-analytics-hub.sample_places_insights_au.FUNCTION_NAME |
| São Paulo, Brasil | maps-platform-analytics-hub.sample_places_insights_br.FUNCTION_NAME |
| Toronto, Canadá | maps-platform-analytics-hub.sample_places_insights_ca.FUNCTION_NAME |
| Paris, França | maps-platform-analytics-hub.sample_places_insights_fr.FUNCTION_NAME |
| Berlim, Alemanha | maps-platform-analytics-hub.sample_places_insights_de.FUNCTION_NAME |
| Londres, Grã-Bretanha | maps-platform-analytics-hub.sample_places_insights_gb.FUNCTION_NAME |
| Mumbai, Índia | maps-platform-analytics-hub.sample_places_insights_in.FUNCTION_NAME |
| Jacarta, Indonésia | maps-platform-analytics-hub.sample_places_insights_id.FUNCTION_NAME |
| Roma, Itália | maps-platform-analytics-hub.sample_places_insights_it.FUNCTION_NAME |
| Tóquio, Japão | maps-platform-analytics-hub.sample_places_insights_jp.FUNCTION_NAME |
| Cidade do México, México | maps-platform-analytics-hub.sample_places_insights_mx.FUNCTION_NAME |
| Madri, Espanha | maps-platform-analytics-hub.sample_places_insights_es.FUNCTION_NAME |
| Zurique, Suíça | maps-platform-analytics-hub.sample_places_insights_ch.FUNCTION_NAME |
| Nova York, Estados Unidos | maps-platform-analytics-hub.sample_places_insights_us.FUNCTION_NAME |