Room Occupancy
Room occupancy refers to the number of people detected in a specific room at a given time. There are two ways to measure room occupancy: traffic-based or presence-based. Each method uses a different approach depending on the available sensor data and the type of insights required.

Below are sample queries for retrieving room-level occupancy data to analyze peak, and average within a selected time range.
Recommended Practices
Recommended Aggregation by Query Interval: To ensure accurate interpretation of occupancy data, we recommend different aggregation methods based on the query interval:
1-Minute Interval (we recommend query for <24h time ranges only due to performance)
Use
median
: this smooths out short-term fluctuations (e.g. quick in-and-outs) and best reflects actual occupancy minute-to-minute.Larger Intervals (e.g. hourly, daily)
Use
mean
for average occupancy over the interval to help identify overall usage patterns.Use
max
for peak occupancy within the interval to understand the busiest times or capacity thresholds.
Avoid Relative Time Queries: Do not use relative time functionality (e.g.,
-5m
) as it may result in missing data depending on query timing. Always specify absolute start and stop times.Timezone Configuration: Always provide a timezone when querying traffic-based occupancy
To mitigate traffic drift due to miscounts, we recommend adding the filter:
"calibrated": "true"
Include Zero Values in Output: To ensure zero values are included in the results, add the filter:
Traffic-based Room Occupancy
If traffic sensors are installed at the room entrance(s), you can use the sample queries below to retrieve the estimated room occupancy counts.

Query the peak hourly occupancy of a room with traffic sensor installed:
Query the average hourly occupancy of a room with traffic sensor installed:
Presence-based Room Occupancy
Use the sample queries below to retrieve the total occupancy for areas covered by presence sensors in the room. Keep in mind that the sensor coverage area influences the count and may not represent the room's actual occupancy.

Query the peak hourly occupancy of a room with presence sensors installed:
Query the average hourly occupancy of a room with presence sensors installed:
Last updated