Hourly metrics for floors
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Example Queries
Path
/metrics/hourly/buildings?filter[local_date][gt]=2022-08-02&filter[local_date][lt]=2022-08-20&filter[local_hour][gt]=4&filter[building_ref_id]=Skyline_Blvd_HQ
Description
Retrieve all hourly building metrics where the local_date is greater than 2022-08-02 and local_date is less than 2022-08-20 and the local_hour is greater than 4 and the building_ref_id equals Skyline_Blvd_HQ.
Hourly Floor Metric Attributes
| Property | Type | Description |
|---|---|---|
local_date | String | Local date, formatted YYYY-MM-DD |
local_hour | Number | Local hour between 0-23 |
capacity | Number | Capacity of the floor which the metric belongs at the time when the metric was recorded. |
avg_person_count | String | Average person count of spaces on the floor during the hour. |
avg_occupied_person_count | String or null | Average person count of spaces on the floor when they are occupied during the hour. |
min_person_count | Number | Minimum amount of people on the floor during the hour. |
max_person_count | Number | Maximum amount of people on the floor during the hour. |
minutes_actively_occupied | String | Amount of minutes that the spaces on the floor were actively occupied during the hour. |
minutes_passively_occupied | String | Amount of minutes that the spaces on the floor were passively occupied during the hour. |
space_count | Number or null | The number of spaces on the floor that were included in the hourly floor metric. |
Query Parameters
local_date and local_hour have 6 different comparison operators.
filter[<local_date/local_hour>][<operator>]=<value to filter against>
| Operator | Description |
|---|---|
eq | == is equal to |
not_eq | != is not equal to |
lt | < is less than |
lte | <= is less than or equal to |
gt | > is greater than |
gte | >= is greater than or equal to |
Date Range Limits
filter[local_date] is required. A request without it returns 400 Must include local date filter.
A single request covers at most a month of dates. A wider range returns 400 Cannot request more than a month of data. Split a longer window into month-sized chunks and issue one request per chunk.
A request for one specific date is exempt from this limit. Pass filter[local_date]=2025-06-18 or filter[local_date][eq]=2025-06-18.
Filtering by Hour
filter[local_hour] has no default. If you omit it, the response covers all 24 hours of each day. Pass the filter to narrow the result and reduce the number of rows returned.
filter[local_hour][gte] must be lower than filter[local_hour][lte]. Equal or inverted values return 400 local_hour param order incorrect. To request a single hour, pass filter[local_hour]=8 or filter[local_hour][eq]=8.