FAQs

What if one of my buildings or floors doesn’t have an Entry sensor?

  • If the building doesn’t have Entry sensors, the data is aggregated from the Open Area floor-level data.
  • If a floor doesn’t have an Entry sensor, the data is aggregated from the Open Area sensors of that floor. Density unions the Open Area Field of View Polygons from all sensors within the floor to deduplicate the overlapping areas.

How do nested spaces roll up at floor level?

Each space has a unique space ID, so the query will return the metrics for each space ID. If a floor doesn’t have an Entry sensor, the data is aggregated from Open Area sensors of that floor. Density unions the Open Area Field of View Polygons from all sensors within the floor to deduplicate the overlapping areas.

For Utilization metric, what value does the API returns if the capacity is not configured for a space?

Utilization is calculated as Occupancy/Capacity. Today Capacity is configured during your onboarding period via Density Support. Capacity is a mandatory field for Space (Area of Interests) and Floor and Building if they have Entry sensors. For edge case where a space capacity is missing, the space (AOI) is not included in the calculation.

How fresh is the data?

  • For Presence , Short-Term Analytics , and Current Occupancy endpoints you can usually query live data from events within 1s.
  • For historical measurements, the availability of data depends on the sensor type. See this support article for more details. In general, we recommend query the data from the previous day to ensure there is no missing data for all sensor types.

Note that Density can't control for customer network speed/reliability, which is a factor both in the sensor data making it to the Density cloud and API response making it from the Density cloud to the customer.

Does the API support Pagination?

No, this version of the API doesn’t support pagination.

What are the rate limits for the API?

Our API services are rate-limited to prevent unintentional use of our service and ensure a reliable experience for all of our developers and integrations. The API is limited to 60 requests per minute, per token.