Example Queries

Path

/metrics/aggregate/spaces?filter[local_date][gte]=2022-08-02&filter[local_date][lte]=2022-08-20&&filter[building_id]=654321

Description

Retrieve aggregated metrics for all spaces contained in building 654321 for the period where local_date is greater than 2022-08-02 and local_date is less than 2022-08-20.

Response

Property	Type	Description
`avg_person_count`	Int	Average number of people in the space over the selected time period.
`avg_person_count_when_used`	Int	Average number of people in the space, but only considering times when it was in use.
`peak_person_count`	Int	Maximum number of people present in the space at any given time during the time period.
`avg_daily_peak_person_count`	Int	Average of the highest number of people present in the space each day.
`active_minutes_used`	Int	Total minutes the space was actively occupied (e.g., when people were engaged in a primary activity).
`passive_minutes_used`	Int	Total minutes the space was passively occupied (e.g., when people were present but not actively using it).
`total_hours_actively_occupied`	Int	Total hours the space was actively used during the time period.
`pct_active_time`	Int	Percentage of total available time the space was actively in use.
`pct_passive_time`	Int	Percentage of total available time the space was passively occupied.
`avg_capacity_usage`	Int	Average percentage of the space’s capacity used over the time period.
`avg_capacity_usage_when_used`	Int	Average percentage of the space’s capacity used, only considering times when it was occupied.

200200

400400