Criar uma consulta usando dados de marcas

O Insights de Lugares fornece informações de marca para muitas categorias de lugares. Por exemplo:

  • Para a categoria "Caixas eletrônicos, bancos e cooperativas de crédito", os dados de marcas contêm uma entrada para cada uma das marcas PNC, UBS e Chase.
  • Para a categoria "Aluguel de veículos", os dados contêm uma entrada para cada uma das marcas Budget, Hertz e Thrifty.

Um caso de uso típico para consultar o conjunto de dados de marcas é analisar a presença da marca ou combiná-lo com o conjunto de dados de lugares para responder a perguntas como:

  • Qual é a contagem de todas as lojas por marca em uma área?
  • Qual é a contagem das três principais marcas concorrentes na área?
  • Qual é o número de marcas de uma categoria específica, como "Fitness" ou "Posto de gasolina", na área?

Sobre o conjunto de dados de marcas

O conjunto de dados de marcas está disponível nos EUA, no Reino Unido, na Austrália e no Canadá. Por exemplo, o conjunto de dados de marcas dos EUA se chama places_insights___us.brands.

Esquema do conjunto de dados de marcas

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: o tipo de marca, como "Posto de gasolina", "Alimentos e bebidas" ou "Hospedagem". Para conferir uma lista de valores possíveis, consulte Valores de categoria.

Consultar dados de marcas

O método recomendado para analisar dados de marcas é usar as funções de contagem de lugares. As funções de contagem de lugares oferecem suporte nativo à filtragem por IDs de marca usando o parâmetro brand_ids, retornando contagens exatas (incluindo zero) e IDs de lugar de amostra sem exigir operações complexas de SQL JOIN.

Etapa 1: encontrar o ID da marca

O esquema do conjunto de dados de lugares define o campo brand_ids. Se um lugar no conjunto de dados de lugares estiver associado a uma marca, o campo brand_ids vai conter o ID correspondente.

Para filtrar por uma marca, primeiro consulte a tabela brands para encontrar o ID correspondente da marca de interesse:

SELECT id, name
FROM PROJECT_NAME.places_insights___us.brands
WHERE name = "McDonald's"

Etapa 2: usar brand_ids em uma função de contagem de lugares

Depois de receber o ID da marca, transmita-o ao parâmetro de filtro brand_ids.

Neste exemplo, você consulta a densidade dos restaurantes McDonald's em um raio de 2.000 metros do Empire State Building na cidade de Nova York usando PLACES_COUNT_PER_H3:

SELECT *
FROM PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_H3(
  JSON_OBJECT(
      'geography', ST_BUFFER(ST_GEOGPOINT(-73.9857, 40.7484), 2000),
      'business_status', ['OPERATIONAL'],
      'brand_ids', ["13992718219781496405"], -- McDonald's brand ID
      'h3_resolution', 8
  )
);

Também é possível usar PLACES_COUNT_V2 para contar em lote os locais de marca em áreas de pesquisa personalizadas:

SELECT *
FROM PROJECT_NAME.places_insights___us.PLACES_COUNT_V2(
  TABLE PROJECT_NAME.YOUR_DATASET.my_search_areas,
  JSON_OBJECT(
      'geography_radius', 2000,
      'business_status', ['OPERATIONAL'],
      'brand_ids', ["13992718219781496405"]
  )
);

Valores de categoria

O campo category de uma marca pode conter os seguintes valores:

Valor do tipo de categoria
ATMs, Banks and Credit Unions
Automotive and Parts Dealers
Automotive Rentals
Automotive Services
Dental
Electric Vehicle Charging Stations
Electronics Retailers
Fitness
Food and Drink
Gas Station
Grocery and Liquor
Health and Personal Care Retailers
Hospital
Lodging
Merchandise Retail
Movie Theater
Parking
Telecommunications