VergeSense

The VergeSense Connector provides access to live occupancy and people count data for your workspaces. Use this data to build applications that need to know if a particular workspace is occupied, or which workspaces are the least/most popular.

Use Cases

Potential use cases include:

• Analyze the performance of return-to-office strategies
• Build live occupancy based HVAC equipment operation programs
• Create dynamic office plans based on actual workspace usage

Configuration

The VergeSense Connector requires a URL (like api.azure.vergesense.com) as well as an API Key retrieved from within VergeSense. You'll need a VergeSense admin account to generate the API Key - once you're logged in as an admin, navigate to Integrations and click Generate API Key. On the popup screen, enter an API Token Name, select buildings to which the API key applies, then click Save.

Credential	Description
API Url	The URL for Vergesense's API
API Key	The API Key issued to you by Vergesense

Mapped Concepts

Connector Concept	Mapped Type
Place	Building, Floor, Space
Thing	Occupancy_Sensing_Device
Point	Occupancy_Count_Sensor, Humidity_Sensor, Temperature_Sensor, Air_Quality_Sensor, Occupancy_Status

Sample Code

Here's an example showing how to retrieve occupancy data from VergeSense sensors for a particular space. A float value of 1 indicates someone is present; you may see a value of 0 when the room is empty, or no data at all. Also note the filter for "latest" in the series field; this means you're getting the most recent value sent by the sensor:

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