Zone Occupancy
Last updated
Last updated
Zone occupancy refers to the number of people detected in a specific zone at a given time. It is calculated by consolidating data from multiple presence sensors within the zone.
Below are sample queries for retrieving zone-level occupancy data to analyze peak, and average within a selected time range.
Recommended Practices
Function Selection for Occupancy Metrics:
Use the max
function to capture peak values within the specified time window.
Use the mean
function to capture average values within the specified time window.
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
Include Zero Values in Output: To ensure zero values are included in the results, add the filter:
Use the sample queries below to retrieve the total occupancy for areas covered by presence sensors in the zone. Keep in mind that the sensor coverage area influences the count and may not represent the zone's actual occupancy.
Query the peak hourly occupancy of a room with presence sensors installed:
Use measurement: zone_occupancy
Use function: max
Query the average hourly occupancy of a room with presence sensors installed:
Use measurement: zone_occupancy
Use function: mean