Occupancy data refers to information about the presence or absence of people within different areas of a building. This data provides insights into how spaces within the building are used and can help inform decisions that impact energy spend, occupant comfort and operational efficiency.

Using the AHS API for an Occupancy Data Use Case

The AHS API serves multiple purposes. The example in this section illustrates how to utilize the API to generate dashboards or reports for a building leveraging the occupancy data. We'll begin by replicating the space hierarchy, retrieving assets assigned to particular spaces, and collecting device telemetry data.

Step 1: Query Space Hierarchy

Use the getNodeByType query to create a mapping of the building, including floors and rooms.

Step 2: Query for Assets

Use the getAssetsForAllBuildingByAboundId query to get all assets assigned to the building and information about where the assets are located.

Step 3: Query Telemetry Data

Use the getNodeById query to retrieve telemetry data for each asset assigned to the building using the device ID. You can query for up to 2 weeks of data.