Kaiterra

The Kaiterra connector allows you to connect your Kaiterra indoor air quality sensors to your Mapped structures, giving you access to temperature, humidity, and air quality data.

Note: Due to restrictions in the Kaiterra API, you will need to supply the Device UUID for your Kaiterra devices, and provide the location for them in the Place Mapping UI.

Use Cases

Potential use cases include:

• Tracking temperature across a floor
• Viewing TVOC levels across a building
• Creating your own air quality metric from a mixture of metrics

Configuration

The Kaiterra Connector requires the following credentials to authenticate:

Credential	Description
API Key	The API Key provided by Kaiterra

The Kaiterra API does not expose a "get all devices" endpoint. Therefore, you will need to enter the Kaiterra Device UUIDs on the 'Thing Id's' tab before you are able to map them in the Mapping tab. Once you have added all Kaiterra devices, you will be able to map them to your Mapped graph.

Mapped Concepts

Connector Concept	Mapped Type
Device	Air_Quality_Sensing_Device
Point	Ozone_Level_Sensor, TVOC_Level_Sensor, PM_2_5_Level_Sensor, CO2_Level_Sensor, PM_10_Level_Sensor, Temperature_Sensor, Relative_Humidity_Sensor

Sample Code

The following example pulls the series data for a specific Kaiterra sensor, which will include multiple types of data including temperature, humidity and air quality:

Request Response
Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  things(filter: {id: {eq: "THGD5NLUsAndK3EAcAuJwAbCd"}}) {
    name
    exactType
    points {
      id
      name
      exactType
      series(latest: true) {
        timestamp
        value {
          float64Value
        }
      }
    }
  }
}