Measurement Types Reference

Complete reference of all Haltian IoT measurement types and their data formats

This page provides a complete reference of all measurement types available in Haltian IoT, including their descriptions, value formats, and typical use cases.

Overview

Measurements are sensor data values sent by Haltian IoT devices. Each measurement has:

Type - Identifier for the measurement kind
Timestamp - When the measurement was taken (measured_at)
Value - The measurement data (varies by type)

Environmental Measurements

ambient_temperature

Ambient air temperature reading.

Property	Value
Unit	Degrees Celsius (°C)
Value Type	Number
Typical Range	-40 to +85

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": 23.5
}

humidity

Relative humidity percentage.

Property	Value
Unit	Percent (%)
Value Type	Number
Typical Range	0 to 100

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": 45.2
}

air_pressure

Atmospheric pressure reading.

Property	Value
Unit	Hectopascals (hPa)
Value Type	Number
Typical Range	870 to 1084

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": 1013.25
}

co2

Carbon dioxide concentration.

Property	Value
Unit	Parts per million (ppm)
Value Type	Number
Typical Range	400 to 5000

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": 850
}

tvoc

Total Volatile Organic Compounds.

Property	Value
Unit	Parts per billion (ppb)
Value Type	Number
Typical Range	0 to 60000

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": 125
}

ambient_light

Ambient light level.

Property	Value
Unit	Lux
Value Type	Number
Typical Range	0 to 100000

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": 450
}

Presence & Occupancy Measurements

presence

Binary presence detection.

Property	Value
Unit	Boolean
Value Type	Boolean
Values	true (present), false (absent)

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": true
}

occupancy_state

Occupancy status with confidence.

Property	Value
Unit	Object
Value Type	Object

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": {
    "occupied": true,
    "confidence": 0.95
  }
}

occupants_count

Number of occupants in a space.

Property	Value
Unit	Count
Value Type	Integer
Typical Range	0 to N (space capacity)

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": 5
}

directional_movement

Entry and exit counts for directional sensors.

Property	Value
Unit	Object
Value Type	Object

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": {
    "in": 12,
    "out": 8,
    "net": 4
  }
}

pir_count

PIR sensor trigger count.

Property	Value
Unit	Count
Value Type	Integer

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": 47
}

Position & Movement Measurements

position

Device position coordinates.

Property	Value
Unit	Object (coordinates)
Value Type	Object

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": {
    "position_local": {
      "x": 12.5,
      "y": 8.3,
      "z": 0.0
    },
    "position_global": {
      "type": "Point",
      "coordinates": [24.9384, 60.1699]
    },
    "accuracy": 2.5
  }
}

position_zone

Zone-based position.

Property	Value
Unit	Object
Value Type	Object

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": {
    "zone_id": "zone-uuid",
    "zone_name": "Meeting Room A",
    "entered_at": "2025-01-28T10:25:00.000Z"
  }
}

acceleration

3-axis acceleration data.

Property	Value
Unit	m/s² or g
Value Type	Object

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": {
    "x": 0.02,
    "y": -0.01,
    "z": 9.81
  }
}

orientation

Device orientation angles.

Property	Value
Unit	Degrees
Value Type	Object

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": {
    "roll": 2.5,
    "pitch": -1.2,
    "yaw": 45.0
  }
}

angle

Single axis angle (for door/lid sensors).

Property	Value
Unit	Degrees
Value Type	Number
Typical Range	0 to 360

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": 90.5
}

Device Status Measurements

battery_level

Battery charge percentage.

Property	Value
Unit	Percent (%)
Value Type	Number
Typical Range	0 to 100

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": 85
}

battery_voltage

Battery voltage reading.

Property	Value
Unit	Volts (V)
Value Type	Number
Typical Range	2.0 to 4.2

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": 3.7
}

rssi

Received Signal Strength Indicator.

Property	Value
Unit	dBm
Value Type	Number
Typical Range	-100 to 0

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": -65
}

device_temperature

Internal device temperature.

Property	Value
Unit	Degrees Celsius (°C)
Value Type	Number

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": 28.5
}

Distance & Ranging Measurements

distance

Distance to object (ToF sensors).

Property	Value
Unit	Millimeters (mm)
Value Type	Number
Typical Range	0 to 4000

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": 1250
}

radar_distance

Radar-based distance measurement.

Property	Value
Unit	Meters (m)
Value Type	Number

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": 3.5
}

Utility Measurements

hall_effect

Magnetic field detection (door/window sensors).

Property	Value
Unit	Boolean
Value Type	Boolean
Values	true (magnet present), false (magnet absent)

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": false
}

button_press

Button press event.

Property	Value
Unit	Event
Value Type	Object or Boolean

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": {
    "button_id": 1,
    "press_type": "short"
  }
}

energy_consumption

Energy usage reading.

Property	Value
Unit	Watt-hours (Wh)
Value Type	Number

{
  "measured_at": "2025-01-28T10:30:00.000Z",
  "value": 125.5
}

Measurement Availability by Device

Device Type	Common Measurements
Presence Sensor	presence, pir_count, ambient_temperature, humidity, battery_level
Environment Sensor	ambient_temperature, humidity, co2, tvoc, air_pressure, ambient_light
Door/Window Sensor	hall_effect, angle, battery_level
Asset Tag	position, rssi, battery_level, acceleration
People Counter	directional_movement, occupants_count
Radar Sensor	presence, radar_distance, occupants_count

Querying Measurements

Get Available Measurement Types

query GetDeviceMeasurementTypes($deviceId: ID!) {
  device(id: $deviceId) {
    deviceModel {
      supportedMeasurementTypes
    }
  }
}

Query Specific Measurement Type

query GetTemperatureHistory($deviceId: ID!, $from: DateTime!, $to: DateTime!) {
  device(id: $deviceId) {
    measurements(
      filter: {
        types: ["ambient_temperature"]
        from: $from
        to: $to
      }
    ) {
      edges {
        node {
          measuredAt
          value
        }
      }
    }
  }
}

Next Steps

Stream API - Subscribe to real-time measurements
Data API - Export measurement data to Parquet
Service API Queries - Query historical data