Sobre os dados e as consultas do Places Insights

Dados do Insights de Lugares

O Insights de Lugares fornece 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 própria cidade. Ele não contém dados sobre a área metropolitana ao redor.

A listagem de amostra inclui dados de uma cidade importante para cada um dos países compatíveis:

  • Amsterdã (NL)
  • Ancara (TR)
  • Arequipa (PE)
  • Atenas (GR)
  • Bad Gastein (AT)
  • Berlim (DE)
  • Brno (CZ)
  • Bruxelas (BE)
  • Bucareste (RO)
  • Buenos Aires (AR)
  • Busan (KR)
  • Cairo (EG)
  • Chiang Mai (TH)
  • Copenhague (DK)
  • Cork (IE)
  • Debrecen (HU)
  • Hanói (VN)
  • Helsinque (FI)
  • Hong Kong (HK)
  • Jacarta (ID)
  • Jidá (SA)
  • Joanesburgo (ZA)
  • Kuala Lumpur (MY)
  • Lisboa (PT)
  • Londres (GB)
  • Lusail (QA)
  • Madri (ES)
  • Manila (PH)
  • Medellín (CO)
  • Cidade do México (MX)
  • Mumbai (IN)
  • Cidade de Nova York (EUA)
  • Oslo (NO)
  • Paris (FR)
  • Plovdiv (BG)
  • Riffa (BH)
  • Roma (IT)
  • Santiago (CL)
  • São Paulo (BR)
  • Xarja (AE)
  • Singapura (SG)
  • Estocolmo (SE)
  • Sydney (AU)
  • Taipé (TW)
  • Tel Aviv-Yafo (IL)
  • Tóquio (JP)
  • Toronto (CA)
  • Varsóvia (PL)
  • Wellington (NZ)
  • Zurique (CH)

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 que você precisa assinar separadamente. Para mais informações sobre como assinar 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:

Por exemplo, se você estiver trabalhando com o conjunto de dados da Espanha (ES), consulte o esquema principal e o esquema específico da Espanha.

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 a maior flexibilidade para filtragem complexa, mesclagem 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 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 as tarefas comuns de recuperação de dados. Eles fornecem insights mais detalhados, como retornar IDs de lugar para pesquisa rápida de detalhes sobre lugares específicos. Consulte a documentação.

Consultas diretas

A consulta direta dos dados aplica um limite de agregação de 1. Uma linha de resultado só será retornada se agregar pelo menos um lugar. Se os critérios de pesquisa corresponderem a 0 lugares, essa linha será omitida da resposta.

Consultas da função Places Count

As funções de contagem de lugares podem retornar uma lista de IDs de lugar, que podem ser usados para procurar informações de lugares individuais usando outros produtos da GMP, como a API Places e o Kit de Interface do 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 x 40 metros (1.600 m2). Isso significa que, desde que sua consulta de pesquisa seja maior que a área de pesquisa mínima, você sempre vai receber um resultado, mesmo que não haja lugares correspondentes à sua consulta.

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

Consulte os dados diretamente se quiser receber insights além das contagens, como AVG, SUM ou COUNTIF, ou se precisar realizar consultas mais complexas, como mesclar conjuntos de dados.

Consulte usando as funções se precisar retornar IDs de lugar para pesquisar informações de lugares individuais, como nome ou endereço, ou se quiser que as consultas retornem explicitamente contagens de 0 em vez de omiti-las.

Esta tabela oferece uma comparação detalhada das diferenças entre as consultas diretas e as 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.
  • Retorna contagens explícitas de 0.
  • Otimizado para desempenho e baixo custo de processamento.
  • Fácil de usar. Não é preciso 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 mesclagens.
  • Não aplica uma área de pesquisa mínima.
  • Oferece suporte a 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 geográfica 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, incluindo uma contagem de 0, desde que a área de pesquisa mínima seja atendida. Os resultados com contagens de 0 são omitidos dos resultados (ou seja, a linha é excluída).
Filtros de atributos de suporte compatíveis Os parâmetros de filtro da função Places Count são os mesmos dos filtros de atributos de consulta direta, exceto:
  • Local id
  • Componentes de endereço
Esquema completo compatível.