Query Weather Normalized Baseline
Use the getWnbDataByDateRange query to get utility consumption and spend set against a weather normalized baseline. This data can be used by facility managers to evaluate energy consumption and spend relative to local weather conditions.
Query Request
From your app or API client, use the below URL:
URL: https://api.abound.carrier.io/prod-ahs-api/graphql/
Argument:
- buildingId: Unique ID of the building. Building IDs can be obtained using the getNodeByType query.
- currency: Currency code for the building represented using the ISO 4217 standard
- fromDate: The starting point in time from which to retrieve alarms. This will be in an ECMAScript date time string format - YYYY-MM-DD YYYY-MM-DDTHH:mm:ss.sssZ
- toDate: The ending point in time from which to retrieve alarms. This will be in an ECMAScript date time string format - YYYY-MM-DD | YYYY-MM-DDTHH:mm:ss.sssZ
Query Response
As a response, the above query will fetch details about various assets for the entire building based on the specified buildingId.
QUERY
{
getWnbDataByDateRange(
buildingId: "f8a7b2d3-1c5e-4f9b-9d4f-0a8c2e3d7b6a"
currency: "USD"
fromDate: "2022-06-01"
toDate: "2023-05-31"
) {
wnbId
buildingId
disabled
utilityType
correlationCoefficient
rSquared
fromDate
toDate
intercept
slope
tippingTempUnit
coolingTippingTemp
heatingTippingTemp
updatedAt
monthlyExpectedUtilityUsage {
month
spend {
amount
currency
}
consumption {
expectedMonthlyTotal
unit
}
energy {
expectedMonthlyTotal
unit
}
}
}
}
RESPONSE
{
"data": {
"getWnbDataByDateRange": [
{
"wnbId": "86360df9-e6bb-4dc2-8dc8-30024f505e6e",
"buildingId": "f8a7b2d3-1c5e-4f9b-9d4f-0a8c2e3d7b6a",
"disabled": false,
"utilityType": "electricity",
"correlationCoefficient": -0.92,
"rSquared": 0.85,
"fromDate": "2022-06-01",
"toDate": "2023-05-31",
"intercept": 15021.448128603639,
"slope": -2499.6726969891192,
"tippingTempUnit": "Fahrenheit",
"coolingTippingTemp": 85,
"heatingTippingTemp": 60,
"updatedAt": "1711668203264",
"monthlyExpectedUtilityUsage": [
{
"month": 1,
"spend": {
"amount": 0,
"currency": "USD"
},
"consumption": {
"expectedMonthlyTotal": 449417.02,
"unit": "kWh"
},
"energy": {
"expectedMonthlyTotal": 1533410.87,
"unit": "kBtu"
}
},
{
"month": 2,
"spend": {
"amount": 49185.8,
"currency": "USD"
},
"consumption": {
"expectedMonthlyTotal": 433622.26,
"unit": "kWh"
},
"energy": {
"expectedMonthlyTotal": 1479519.15,
"unit": "kBtu"
}
},
{
"month": 3,
"spend": {
"amount": 52820.38,
"currency": "USD"
},
"consumption": {
"expectedMonthlyTotal": 465664.89,
"unit": "kWh"
},
"energy": {
"expectedMonthlyTotal": 1588848.6,
"unit": "kBtu"
}
}
]
}
]
}
}