science Este produto ou recurso está em pré-lançamento (pré-GA). Os produtos e recursos em pré-GA têm suporte limitado, e é possível que as mudanças neles não sejam compatíveis com outras versões nessa fase. As Soluções pré-GA são cobertas pelos Termos de Serviço específicos da Plataforma Google Maps. Para mais informações, consulte as descrições da fase de lançamento. Faça sua inscrição para testar o Places Insights.
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Places Insights 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 é uni-lo a uma consulta sobre os dados de lugar 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 é a contagem 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 dos EUA se chama places_insights___us___sample.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.
Usar o conjunto de dados de marcas em uma consulta
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 do lugar vai conter o ID da marca correspondente.
Uma consulta típica que faz referência ao conjunto de dados de marcas executa um JOIN com o conjunto de dados de lugares com base no campo brand_ids.
Por exemplo, para encontrar a quantidade de restaurantes McDonald's em um raio de 2.000 metros do Empire State Building em Nova York:
A próxima consulta retorna a contagem do número de cafés na cidade de Nova York que pertencem a uma marca, agrupados por nome da marca:
SELECTWITHAGGREGATION_THRESHOLDbrands.name,COUNT(*)ASstore_countFROMPROJECT_NAME.places_insights___us___sample.places_sampleplaces,UNNEST(brand_ids)ASbrand_idLEFTJOINPROJECT_NAME.places_insights___us___sample.brandsONbrand_id=brands.idWHEREbrands.category="Food and Drink"AND"cafe"INUNNEST(places.types)ANDbusiness_status="OPERATIONAL"GROUPBYbrands.nameORDERBYstore_countDESC;
A imagem a seguir mostra as contagens por marca:
Valores de categoria
O campo category de uma marca pode conter os seguintes valores:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-06 UTC."],[],[],null,["| **Note:** For the Preview release, the brands dataset is only available for New York City in the United States.\n\nPlaces Insights provides brand information for many categories of places. For\nexample:\n\n- For the category of \"ATMs, Banks, and Credit Unions\", the brands data contains an entry for each of the brands PNC, UBS, and Chase banks.\n- For the category \"Automotive Rentals\", the data contains an entry for each of the brands Budget, Hertz, and Thrifty.\n\nA typical use case for querying the brands dataset is to join it with a query on\nthe place data to answer questions such as:\n\n- What is the count of all stores by brand in an area?\n- What is the count of my top three competitor brands in the area?\n- What is the count of brands of a specific category, such as \"Fitness\" or \"Gas Station\", in the area?\n\nAbout the brands dataset\n\nThe brands dataset for the US is named `places_insights___us___sample.brands`.\n\nBrands dataset schema\n\nThe schema for the brands dataset defines three fields:\n\n- `id`: The brand ID.\n- `name`: The brand name, such as \"Hertz\" or \"Chase\".\n- `category`: The brand type, such as \"Gas Station\", \"Food and Drink\", or \"Lodging\". For a list of possible values, see [Category\n values](#category-values)\n\nUse brands dataset in a query\n\nThe **places dataset** schema defines the `brand_ids` field. If a place in the\nplaces dataset is associated with a brand, then the `brand_ids` field for the\nplace contains the corresponding brand ID.\n\nA typical query that references the **brands dataset** performs a `JOIN` with\nthe **places dataset** based on the `brand_ids` field.\n\nFor example, to find the count of the number of McDonald's restaurants within\n2000 meters of the Empire State Building in New York City: \n\n```googlesql\nSELECT WITH AGGREGATION_THRESHOLD\n COUNT(*)\nFROM places_insights___us___sample.places_sample places, UNNEST(brand_ids) AS brand_id\nLEFT JOIN places_insights___us___sample.brands ON brand_id = brands.id\nWHERE\nST_DWITHIN(ST_GEOGPOINT(-73.9857, 40.7484), point, 2000)\nAND brands.name = \"McDonald's\"\nAND business_status = \"OPERATIONAL\"\n```\n\nThe next query returns the count of the number of cafes in New York City that\nbelong to a brand, grouped by brand name: \n\n```googlesql\nSELECT WITH AGGREGATION_THRESHOLD\n brands.name,\n COUNT(*) AS store_count\nFROM places_insights___us___sample.places_sample places, UNNEST(brand_ids) AS brand_id\nLEFT JOIN places_insights___us___sample.brands ON brand_id = brands.id\nWHERE brands.category = \"Food and Drink\"\nAND \"cafe\" IN UNNEST(places.types)\nAND business_status = \"OPERATIONAL\"\nGROUP BY brands.name\nORDER BY store_count DESC;\n```\n\nThe following image shows the counts by brand:\n\nCategory values\n\nThe `category` field for a brand can contain the following values:\n\n| Category type value |\n|--------------------------------------|\n| `ATMs, Banks and Credit Unions` |\n| `Automotive and Parts Dealers` |\n| `Automotive Rentals` |\n| `Automotive Services` |\n| `Dental` |\n| `Electric Vehicle Charging Stations` |\n| `Electronics Retailers` |\n| `Fitness` |\n| `Food and Drink` |\n| `Gas Station` |\n| `Grocery and Liquor` |\n| `Health and Personal Care Retailers` |\n| `Hospital` |\n| `Lodging` |\n| `Merchandise Retail` |\n| `Movie Theater` |\n| `Parking` |\n| `Telecommunications` |"]]