Dados do Insights de Lugares
O Insights de Lugares oferece conjuntos de dados completos e de amostra no BigQuery.
Os conjuntos de dados de amostra permitem que você teste o Insights de Lugares para avaliar a usabilidade e o valor do produto antes de decidir comprar o conjunto de dados completo. O conjunto de dados de amostra contém apenas dados da cidade. Ele não contém dados da área metropolitana ao redor.
A listagem de amostra inclui dados de uma cidade principal para cada um dos países aceitos:
| Amsterdã (NL) | Helsinque (FI) | Plovdiv (BG) |
| Ancara (TR) | Hong Kong (HK) | Riffa (BH) |
| Arequipa (PE) | Jacarta (ID) | Roma (IT) |
| Atenas (GR) | Jidá (SA) | Santiago (CL) |
| Bad Gastein (AT) | Joanesburgo (ZA) | São Paulo (BR) |
| Berlim (DE) | Kuala Lumpur (MY) | Xarja (AE) |
| Brno (CZ) | Lisboa (PT) | Singapura (SG) |
| Bruxelas (BE) | Londres (GB) | Estocolmo (SE) |
| Bucareste (RO) | Lusail (QA) | Sydney (AU) |
| Buenos Aires (AR) | Madri (ES) | Taipei (TW) |
| Busan (KR) | Manila (PH) | Tel Aviv-Yafo (IL) |
| Cairo (EG) | Medellín (CO) | Tóquio (JP) |
| Chiang Mai (TH) | Cidade do México (MX) | Toronto (CA) |
| Copenhague (DK) | Mumbai (IN) | Varsóvia (PL) |
| Cork (IE) | Nova York (US) | Wellington (NZ) |
| Debrecen (HU) | Oslo (NO) | Zurique (CH) |
| Hanói (VN) | Paris (FR) |
Os conjuntos de dados completos incluem dados de cada país aceito e precisam ser comprados. Se você tiver interesse em se inscrever no Insights de Lugares, preencha o formulário de solicitação. Somente o assinante de dados precisa solicitar acesso ao conjunto de dados do Insights de Lugares. Depois que a assinatura estiver ativa em um projeto do BigQuery, qualquer usuário com acesso a esse projeto poderá consultar os dados do Insights de Lugares.
Cada conjunto de dados de país tem uma listagem própria a que você precisa se inscrever separadamente. Para mais informações sobre como se inscrever em uma listagem, 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 do país que define componentes de esquema específicos desse país.
Por exemplo, se você estiver trabalhando com o conjunto de dados da Espanha (ES), consulte o esquema principal e o esquema específico da ES.
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 Insights de Lugares
O Insights de Lugares 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, comoAVG,SUMeGROUP BY. Consulte a documentação. - Consultar o conjunto de dados usando as 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. Elas fornecem insights mais detalhados, como retornar IDs de lugares para procurar detalhes sobre locais individuais. Consulte a documentação.
Consultas diretas
A consulta direta dos dados impõe um limite de agregação. Um resultado é retornado somente se a consulta agregar pelo menos cinco lugares. Por exemplo, se o critério de pesquisa resultar em uma contagem de 0, 1, 2, 3 ou 4, o resultado será omitido da resposta. Por exemplo, uma consulta para a contagem total de restaurantes em uma determinada área só retornará uma resposta se a contagem total for igual ou maior que 5. Caso contrário, nenhuma resposta será retornada.
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 procurar informações de locais individuais usando outros produtos do GMP, como a API Places e o Places UI Kit.
As funções de contagem de lugares não impõem um limite de agregação, mas sim impõem uma área de pesquisa mínima de 40,0 metros por 40,0 metros (1.600 m2). Isso significa que, desde que a consulta de pesquisa seja maior que a área de pesquisa mínima, você sempre receberá um resultado, mesmo que não haja lugares correspondentes à consulta.
Quando consultar os dados diretamente e quando usar funções
Consulte os dados diretamente se você não precisar de contagens de resultados baixas, se quiser receber insights além das contagens, como AVG, SUM ou COUNTIF, ou se precisar realizar consultas mais complexas, como unir conjuntos de dados.
Consulte usando as funções se precisar saber se há um número baixo ou zero de resultados ou se precisar recuperar informações de locais individuais, 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 |
|
|
| Interface | Quatro funções SQL predefinidas que geram insights de COUNT: contagem única, contagem por tipo, contagem por geografia, 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 de pesquisa mínima seja atendida. | Os resultados com contagens menores que 5 são omitidos dos resultados (ou seja, a linha é excluída). |
| Filtros de atributos aceitos | Os parâmetros de filtro da função de contagem de lugares são os mesmos dos filtros de atributos de consulta direta, exceto para:
|
Esquema completo aceito. |