XY Sense

XY Sense devices provide occupancy data based on their Area and Entry sensors. With this connector, you can query your occupancy status and headcount for floors and spaces from the Mapped graph.

Use Cases

Potential use cases include:

• Find the busiest parts of your offices
• Optimize your HVAC settings for underused spaces

Configuration

This connector requires the following credentials:

Credential	Description
API Key	The API Key you registered in the XY Sense dashboard, with both Read and Write permissions
API Secret	The API Secret generated for your API Key

Mapped Concepts

Connector Concept	Mapped Type
Location, Floors, FloorSpaces	Building, Floor, Space, Occupancy_Zone
Area/Entry Sensor	Occupancy_Sensing_Device
Occupancy Status	Occupancy_Status
Headcount	Occupancy_Count_Sensor

Sample Code

The following example shows how to retrieve the time series data for points associated with a specific Occupancy Sensor:

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