BrandLocationDescription

Description

A human-readable description of where a brand operates geographically, based on the states of its operating locations.

For brands with multiple locations, this shows the top states where the brand has a significant presence (either more than 10% of locations or more than 5 locations). Up to 5 states are listed alphabetically (e.g., "CA, FL, NY, TX, WA" or "CA, FL, NY, TX, WA and others" if there are more than 5 significant states).

For brands with a single location, this shows the specific city and state of that location (e.g., "San Francisco, CA").

This attribute provides a quick summary of a brand's geographic footprint without needing to examine all individual locations.

Time Structure

This attribute does not include time series data and reflects the most current state of the brand's locations.

Data Sources

This attribute is derived from:

Brand to operating location relationships
Operating location to address relationships
Address state and city information

type BrandLocationDescription implements MathFunctions {
  id: UUID!
  firstObservedDate: String
  lastObservedDate: String
  locationDescription: String
  internalId: String
  internalBrandId: String
  count(
    field: String!
    conditions: Conditions
  ): Int
  sum(
    field: String!
    conditions: Conditions
  ): Int
  min(
    field: String!
    conditions: Conditions
  ): Int
  max(
    field: String!
    conditions: Conditions
  ): Int
  avg(
    field: String!
    conditions: Conditions
  ): Float
  collect(
    field: String!
    separator: String
    conditions: Conditions
  ): String
  minDateTime(
    field: String!
    conditions: Conditions
  ): DateTime
  maxDateTime(
    field: String!
    conditions: Conditions
  ): DateTime
}

Fields

`BrandLocationDescription.id` ● `UUID!` non-null scalar

`BrandLocationDescription.firstObservedDate` ● `String` scalar

`BrandLocationDescription.lastObservedDate` ● `String` scalar

`BrandLocationDescription.locationDescription` ● `String` scalar

A text description of the brand's geographic presence based on its operating locations.

For brands with multiple locations, this shows up to 5 states where the brand has a significant presence, listed alphabetically. If there are more than 5 significant states, "and others" is appended (e.g., "CA, FL, NY, TX, WA and others").

For brands with a single location, this shows the specific city and state of that location (e.g., "San Francisco, CA").

A state is considered significant if it contains either more than 10% of the brand's locations or more than 5 locations.