Sobre os dados e as consultas do Places Insights

Dados do Places Insights

O Places Insights oferece conjuntos de dados completos e de amostra no BigQuery.

Os conjuntos de dados de exemplo permitem que você teste o Places Insights para avaliar a usabilidade e o valor do produto antes de decidir comprar o conjunto de dados completo. O conjunto de dados de exemplo contém apenas dados da cidade. Ele não contém dados da área metropolitana ao redor.

A lista de amostra inclui os dados de uma cidade principal para cada um dos países aceitos: Sydney (AU), São Paulo (BR), Toronto (CA), Zurique (CH), Berlim (DE), Madri (ES), Paris (FR), Londres (UK), Jacarta (ID), Mumbai (IN), Roma (IT), Tóquio (JP), Cidade do México (MX) e Nova York (US).

Os conjuntos de dados completos incluem dados de cada país aceito e precisam ser comprados. Se você tiver interesse em comprar o conjunto de dados completo, preencha o formulário de solicitação. Apenas o assinante de dados precisa solicitar acesso ao conjunto de dados do Places Insights. Depois que a assinatura é ativada em um projeto do BigQuery, qualquer usuário com acesso a esse projeto pode consultar os dados do Places Insights.

Cada conjunto de dados de país tem uma página que precisa ser assinada separadamente. Para mais informações sobre como assinar uma ficha, consulte Configurar o Places Insights.

Esquemas de conjuntos de dados

O esquema do conjunto de dados de lugares para cada país é composto por duas partes:

• O esquema principal que é comum aos conjuntos de dados de todos os países.
• Um esquema específico de um país que define componentes específicos desse país.

Por exemplo, se você estiver trabalhando com o conjunto de dados da Espanha (ES), faça referência ao esquema principal e ao esquema específico do país.

O esquema do conjunto de dados de marcas define três campos:

• id: o ID da marca.
• name: o nome da marca, como "Hertz" ou "Chase".
• category: a categoria de alto nível da marca, como "Posto de gasolina", "Alimentos e bebidas" ou "Hospedagem".

Consultar dados do Places Insights

O Places Insights oferece duas maneiras de consultar os conjuntos de dados:

• Consultar o conjunto de dados diretamente usando SQL: execute consultas SQL padrão do BigQuery nas tabelas do conjunto de dados. Isso oferece mais flexibilidade para filtragem complexa, junção com seus próprios dados, análise personalizada e suporte para outras funções de agregação além de COUNT, como AVG, SUM e GROUP BY. Consulte a documentação.
• Consultar o conjunto de dados usando funções de contagem de lugares: as funções de contagem de lugares são consultas SQL predefinidas e otimizadas que são executadas diretamente no BigQuery e simplificam tarefas comuns de recuperação de dados. Eles oferecem insights mais detalhados, como o retorno de IDs de lugar para pesquisar detalhes sobre locais individuais. Consulte a documentação.

Consultas diretas

Consultar os dados diretamente impõe um limite de agregação. Um resultado só será retornado se a consulta agregar pelo menos cinco lugares. Por exemplo, se o resultado dos seus critérios de pesquisa for uma contagem de 0, 1, 2, 3 ou 4, ele será omitido da resposta. Por exemplo, uma consulta sobre o número total de restaurantes em uma determinada área só vai retornar uma resposta se o total for 5 ou mais. Caso contrário, nenhuma resposta será retornada.

Fazer consultas de função de contagem de lugares

As funções de contagem de lugares podem retornar uma lista de IDs de lugares, que podem ser usados para pesquisar informações de lugares individuais usando outros produtos do GMP, como a API Places e o kit de interface do usuário Places.

As funções de contagem de lugares não aplicam um limite de agregação, mas sim uma área de pesquisa mínima de 40,0 metros por 40,0 metros (1.600 m²). Isso significa que, desde que sua consulta seja maior que a área mínima de pesquisa, você sempre vai receber um resultado, mesmo que não haja lugares correspondentes.

Quando consultar os dados diretamente e quando usar funções

Consulte os dados diretamente se não precisar de contagens de resultados baixas, se quiser insights além das contagens, como AVG, SUM ou COUNTIF, ou se precisar realizar consultas mais complexas, como junção de conjuntos de dados.

Consulte usando as funções se você precisar saber se há um número baixo ou zero de resultados, ou se precisar recuperar informações individuais do lugar, como nome ou endereço.

Esta tabela oferece uma comparação detalhada das diferenças entre consultas diretas e funções de contagem de lugares.

	Funções de contagem de lugares	Consultas diretas de conjuntos de dados
Benefícios	Retorna IDs de lugar que podem ser usados para consultar outras APIs. Pode retornar qualquer contagem. Otimizado para desempenho e baixo custo de processamento. Fácil de usar. Não é necessário escrever consultas complexas. Valida os parâmetros de entrada e retorna um erro, facilitando o uso e a depuração.	Permite consultas complexas, como filtragem avançada e junções. Não exige uma área de pesquisa mínima. Compatível com outras funções de agregação além de COUNT, como AVG, SUM e GROUP BY.
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. Um JSON_OBJECT transmite argumentos para a função.	Escreva seu próprio 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 outros.
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.	Os resultados com contagens menores que 5 são omitidos (ou seja, a linha é excluída).
Filtros de atributos aceitos	Os parâmetros de filtro da função de contagem de lugares são compatíveis com os mesmos filtros de atributos de consulta direta, exceto: Lugar id Componentes de endereço Horários de funcionamento Opções de recarga de VE Marcas	Esquema completo compatível.