Taxonomy
A structured representation of the place's category within the Overture taxonomy.
Provides the primary classification, full hierarchy path, and alternate categories.
Fields
| Name | Type | Description |
|---|---|---|
alternates | SnakeCaseString (list, optional) | Unordered list of additional categories that are known for this place but that are not part of the primary category hierarchy. Alternate categories allow a more complete picture of the place to be surfaced when it fits multiple unconnected branches in the taxonomy. For example a gas station that also sells groceries might have primary category of "gas_station" with an alternate of "grocery_store". Alternate categories are not part of the primary hierarchy or another alternate category's hierarchy. In other words, if a category is a parent in the hierarchy of another category, that category can't be a primary or alternate category itself. Note as well that this field is an unordered list of extra categories and does not represent a hierarchy. minimum length: 1Ensures all items in a collection are unique. ( UniqueItemsConstraint) |
hierarchy | SnakeCaseString (list) | The full primary hierarchy of categories known for this place, ordered from most general to most specific. An example hierarchy might be: ["food_and_drink", "restaurant", "casual_eatery", "gas_station_sushi"].The rightmost, or most specific, value in the hierarchy must always be equal to the primary field. The basic level category of the place will typically be found in the middle of the primary hierarchy. The primary hierarchy does not include any of the alternate categories found in the alternates field.minimum length: 1Ensures all items in a collection are unique. ( UniqueItemsConstraint) |
primary | SnakeCaseString | The primary, or most specific, category known about this place. The primary category value must always equal the last or rightmost entry in the hierarchy field. |