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 automóveis", os dados contêm uma entrada para cada uma das marcas Budget, Hertz e Thrifty.

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

  • Qual é o número de todas as lojas por marca em uma área?
  • Qual é a contagem das minhas 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 é chamado 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 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 SQL JOIN complexas.

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 da marca correspondente.

Para filtrar por uma marca, primeiro consulte a tabela brands para encontrar o ID correspondente à 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 conseguir o ID da marca, transmita-o para o parâmetro de filtro brand_ids.

Neste exemplo, você consulta a densidade de restaurantes do McDonald's em um raio de 2.000 metros do Empire State Building, em 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 marcas 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