Skip to content
Console(opens in a new tab)

OperatingLocationRank

Indicates how the card revenue of this operating location compares to other operating locations of the same enigma industry within the geographical area.

Selection. This type is a selection. You reach it through a connection, and you choose which of its fields come back.

Indicates how the card revenue of this operating location compares to other operating locations of the same enigma industry within the geographical area.

For example, if Joe’s Pizza has a position of 5 and cohort size of 17, this means, of all the pizza restaurants near Joe’s Pizza, four locations have higher card revenue and twelve locations have lower card revenue.

The geographic area is defined as the H3 index (resolution 4) of the address of the operating location.

There are a few reasons why an operating location does not have an operating location rank

  • we’re unable to determine the card revenue for the operating location
  • fewer than ten operating locations with card revenue exist nearby within the same industry (too few businesses to form a cohort)

Shortest path from a primary entity: Brand → operatingLocations → OperatingLocation → ranks → OperatingLocationRank.

Field Label Type Description
id ID UUID! The unique identifier of this object.
firstObservedDate First Observed Date String The earliest date of a source record that supports this attribute or relationship. The source date is, for example, the date when Enigma collected the record or when the source last updated it. Most values have a date, a time, and a UTC offset, but some have the date only.
lastObservedDate Last Observed Date String The latest date of a source record that supports this attribute or relationship. It uses the same source dates and the same format as firstObservedDate.
rank Rank Int Determines the display order of the attribute, with lower values shown first
quantityType Quantity Type String The quantity we’re using to determine the ranking within a cohort.
period Period String The period we’re using to determine the ranking within a cohort.
position Position Int The absolute position of the operating location relative to its cohort.
cohortSize Cohort Size Int The number of operating locations in the cohort.
periodStartDate Period Start Date Date The date on which the period begins.
periodEndDate Period End Date Date The date on which the period ends.
internalId String A numeric identifier that Enigma assigns to this object when it builds its data. On most attribute objects, id is the UUID form of this number.
internalOperatingLocationId String The internalId of the operating location that this attribute describes.

Every record of this type answers count, countDistinct, has, sum, min, max, avg, collect, minDateTime, maxDateTime. Each takes field and an optional conditions. See Selection.

query {
search(searchInput: {
entityType: BRAND
name: "Safeway"
conditions: { limit: 1 }
}) {
... on Brand {
id
operatingLocations(first: 1) {
edges { node {
ranks(first: 1) {
edges { node {
id
firstObservedDate
lastObservedDate
rank
quantityType
} }
}
} }
}
}
}
}

Response, as returned:

{
"data": {
"search": [
{
"id": "0f26fbef-3436-4f85-8bcd-31fe12a4f99a",
"operatingLocations": {
"edges": [
{
"node": {
"ranks": {
"edges": [
{
"node": {
"id": "00000002-0000-c6ae-0000-098000000000",
"firstObservedDate": null,
"lastObservedDate": null,
"rank": 0,
"quantityType": "card_revenue_amount"
}
}
]
}
}
}
]
}
}
]
}
}