Types
The types of the Data Fusion Layer model, what each one may contain, the properties it carries, and the sub-types available for zones, rooms and assets.
Every object in the Data Fusion Layer carries one or more types. The type states what the object is, a floor, a meeting room, a desk, a door. The type also determines where the object may sit in the hierarchy, which properties it carries, and how a question about "the meeting rooms on the second floor" resolves to a set of data points.
Types come from a tailored subset of the Brick Schema ontology, narrowed down to the entities that occur in facility management and extended where a building operator needs distinctions that Brick leaves open.
An object usually carries several types at once, because the specific type implies the general one. A room typed Standard Meeting Room is also a Meeting Room and a Room, so it answers a question about meeting rooms and a question about rooms, without anyone maintaining those groupings by hand.
The four families
Every type belongs to one of four families:
Region
Region
An organizational grouping of sites, by geography, ownership, or operating structure.
Space
Site, Building, Level, Zone, Room
Physical space, from a campus down to a single room.
Asset
Asset
A physical thing inside a space: equipment, furniture, or a structural element.
Point
Point
A measurable aspect of a space or an asset, bound to one data key of one device.
What each type may contain
The hierarchy is not free-form. Each type accepts a fixed set of child types:
Region
Region, Site
Site
Building, Asset, Point
Building
Level, Zone, Asset, Point
Level
Zone, Room, Asset, Point
Zone
Room, Asset, Point
Room
Asset, Point
Asset
Point
Point
nothing, a point is always a leaf
Read downwards, that gives the familiar chain of region, site, building, level, zone, room, asset, point. Read across, it gives the shortcuts that make real buildings modelable:
Region is the only type that nests into itself. A country region can hold city regions, which hold the sites. Every other type appears once in the chain.
Zones may attach to a building directly, not only to a level, which is what lets a zone span several floors. A department spread over three floors is one zone on the building.
Assets do not need a room. A photovoltaic panel belongs to the building, a fire extinguisher to a level, a charging station to a site. Anything from a site downwards can carry assets.
Points may attach at any level of the hierarchy except to a region. A people counter at the main entrance is a point on the building, without a room ever being modeled for the lobby.
Categories and sub-types
Some types are categories rather than choices. Zone, Room and Asset are never assigned directly: an object under a level is not "a room", it is a meeting room, a toilet, or a workshop. The same applies one level further down, where Meeting Room, Personal Hygiene, Lounge, Food Handling Room, Equipment, Furniture, Architectural Asset, Barrier Asset, Desk and Focus Room are categories that group the types you actually pick.
The rest are assignable as they stand, and any sub-types they have are optional refinements. Level is a type in its own right, and Roof Level or Warehouse Level narrow it where the distinction matters. The same holds for Toilet, Shower Room, Locker Room, Loading Bay, Conference Room, Open Office and Parking Space.
Assigning the most specific type that fits costs nothing and keeps the general ones available, since they come with it. Where no sub-type is right, the category's assignable parent is the honest choice, and a refinement can be added later.
Point is the exception in both directions. It has no sub-types and is not picked from a list at all: a point comes into being when you bind a data key of a device to an object.
Properties
Common properties
Three properties recur across nearly every type:
name
string
yes
1 to 255 characters
How the object appears in the model, in dashboards, and in answers from Genio. This is what "meeting room Zurich" matches against, so it is worth naming consistently.
objectId
string
no
up to 255 characters
Your own identifier for the object, as it is known in the system the model was built from, such as a CAFM, BIM, or floor plan tool. Regions have no objectId.
description
string
no
up to 1024 characters, 255 for buildings and levels
Free text.
Region
name
string
yes
1 to 255
description
string
no
up to 1024
Site
name
string
yes
1 to 255
objectId
string
no
up to 255
description
string
no
up to 1024
address
string
no
up to 255
workspaceId
string
yes
a 16 character akenza ID
workspaceId binds the site to a workspace. That is the link between the semantic model and the devices: the points below a site resolve against the devices in that workspace.
Building
name
string
yes
1 to 255
objectId
string
no
up to 255
description
string
no
up to 255
address
string
yes
up to 255
capacity
integer
no
1 or greater
Level
name
string
yes
1 to 255
objectId
string
no
up to 255
description
string
no
up to 255
levelNumber
integer
yes
-10 to 100
area
number
no
0.1 or greater
capacity
integer
no
1 or greater
levelNumber is what orders the levels of a building, and it is signed, so basements are negative. The name stays free for whatever the building itself calls that floor.
Zone and Room
Zones and rooms carry the same properties.
name
string
yes
1 to 255
objectId
string
no
up to 255
description
string
no
up to 1024
area
number
no
0.1 or greater
capacity
integer
no
1 or greater
capacity is the number of people or workplaces the space is designed for, and area its floor area. They are what turn a count of occupied desks into a utilization figure, so a space whose occupancy you report on is worth filling in. See Occupancy monitoring for how capacity is used.
Asset
name
string
yes
1 to 255
objectId
string
no
up to 255
description
string
no
up to 1024
Point
akenzaDeviceId
string
yes
a 16 character akenza ID
topic
string
yes
at least 2 characters
dataKey
string
yes
at least 1 character
A point is one value, not one device. A multi-sensor reporting temperature, humidity, and CO₂ becomes three points, and they need not sit on the same object: the CO₂ reading can describe the room while a door contact on the same device describes the door.
The three properties are the binding itself. akenzaDeviceId names the device, topic and dataKey name the value inside its samples, exactly as they appear in the message logs on the device detail page. See Querying device data for how topics and data keys are structured.
Sub-type reference
Level
Mezzanine Level
An intermediate floor, open to the floor below or covering only part of it.
Manufacturing Level
A level given over to production, fabrication, or assembly.
Workshop Level
A level for craftsmanship, maintenance, prototyping, or repair work.
Warehouse Level
A level for storage, staging, inventory, and distribution.
Roof Level
The uppermost level, often carrying outdoor plant, solar, or environmental sensors.
Zone
Open Office
A broad, shared office workspace. Contains Working Places, individual desks or cubicles.
Open Space
A broad, shared space for work or leisure.
Event Space
A flexible area for gatherings, conferences, or social functions.
Parking Space
A demarcated area for one vehicle. Refined by EV Parking Space, which typically also carries a charger.
Outdoor Seating
An exterior area for seating and gathering.
Auditorium
A large venue for an audience, lectures, or performances.
Forum
An open gathering space for assembly, events, or informal collaboration.
Garden
An indoor or outdoor space for planting, green space, or recreation.
Informal Collaboration Space
An open area for spontaneous teamwork, with no reservation required.
Living Zone
A domestic-style area for relaxation, socializing, or flexible work.
Mindfulness Zone
An area for mental well-being, meditation, and stress reduction.
Visitor Waiting Area
A space near an entrance or reception where guests wait.
Quiet Space
A low-noise environment for silent tasks, reading, or rest.
Innovation Hub
A multi-disciplinary space for research, experimentation, and prototyping.
Restaurant
Commercial food service, covering both preparation and dining.
Café
Casual food and beverage consumption, with a counter, barista station, or vending.
Fitness Zone
Physical exercise and conditioning, including the wet rooms that serve it.
Room
Rooms carry the largest set of sub-types. The categories in bold are not assignable themselves, you pick one of the types below them.
Meeting Room
Standard Meeting Room, Phone Booth, Customer Meeting Room, Huddle Room, Collaboration Room, Meeting Pod, Meeting Point, Workshop Room, Team Room, Board Room, and under the Focus Room category, Focus Box and Standard Focus Room
Personal Hygiene
Toilet, and below it Washroom with WC F, WC M, WC Unisex and WC Disabled; Shower Room with Shower Room F, Shower Room M and Shower Room Disabled; Sauna
Lounge
Service Lounge, Lounge Area, Visitor Lounge
Food Handling Room
Cafeteria, Dining Room, Cooking Room, Pantry, Walk-in Fridge, Kitchenette
Conference Room
Assignable, refined by Video Conference Room
Locker Room
Assignable, refined by Locker Room F, Locker Room M, Locker Room Disabled
Loading Bay
Assignable, refined by Loading & Receiving Room
Office
A workspace for professional, administrative, or commercial activity
Workshop
Manual labor, fabrication, maintenance, or repair
Service Room
Mechanical plant, maintenance equipment, or storage
Electricity Room
Breaker panels and power distribution
Quiet Room
Deep focus, meditation, or mental restoration
Exercise Room
Fitness training and workout equipment
First Aid Room
Treatment of minor injuries, or holding until transfer
Multipurpose Room
Reconfigurable for meetings, training, events, or collaboration
Retail Room
Display and sale of goods and services
Warehouse
Storage, staging, and management of inventory or bulk materials
Disposition
Storage, handling, removal, or recycling of waste and decommissioned assets
Other Workplace
A functional area that fits none of the standard workspace classifications
Asset
Equipment
Fridge, Fire Extinguisher, AED (Automated External Defibrillator), Photovoltaic Panel, Waste Meter
Furniture
Chair, Art, Other Workplace, and under the Desk category, Standard Desk, Hot Desk, Allocated Desk, Quiet Desk
Architectural Asset
Under the Barrier Asset category, Door
Several asset types exist because of the sensor that usually accompanies them. A fire extinguisher, an AED, or a piece of art carries a presence sensor that raises an alert when the item is removed. A door carries a reed contact that counts openings or reports its current state. A desk or chair carries an occupancy sensor.
Last updated
Was this helpful?