HVAC data reporting is crucial for understanding and optimizing the performance of heating, ventilation, and air conditioning systems within buildings. This section introduces the queries available for your HVAC use case, providing the necessary tools to build detailed reports and integrate seamlessly with the API. By following these steps, you can ensure accurate data collection and analysis, ultimately enhancing the efficiency and reliability of your HVAC systems.

Using the AHS API for an HVAC 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 HVAC 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.