EazyTrax Logo EazyTrax
Home chevron_right Documentation & Setup
description Developer & Admin Guides

EazyTrax Documentation & Integration Guides

Step-by-step instructions for provisioning BLE gateways, importing building blueprints, configuring asset tags, and ingesting telemetry through our high-throughput REST, gRPC & MQTT APIs.

rocket_launch Quickstart Guide

Deploying EazyTrax in 3 Simple Steps

From initial spatial CAD import to live sub-meter asset positioning.

01

Import Spatial Map

Upload your facility's CAD drawings (.DWG, .DXF) or GeoJSON vector polygons. Calibrate real-world dimensions and assign building levels and room zones.

POST /api/spatial/buildings/{id}/floors
02

Configure Gateways

Place gateway coordinates on the 2D/3D floor map. Configure your Cisco, Aruba, or Minew APs to forward BLE telemetry packets to EazyTrax MQTT or HTTP endpoints.

MQTT broker: mqtts://gateway.eazytrax.com:8883
03

Tag & Track Live

Attach BLE/UWB tags to equipment or staff badges. Bulk import tag MAC addresses via CSV and instantly watch positions update in sub-second real time.

WSS: wss://stream.eazytrax.com/rtls/live
api Developer API Reference

Gateway Telemetry Payload Example

Standard JSON payload format for ingesting BLE tag scans from gateways via REST POST or MQTT.

{
  "gatewayId": "GW-FLOOR4-EAST-01",
  "gatewayMac": "AC:8B:A9:12:34:56",
  "timestamp": "2026-08-19T08:15:30.450Z",
  "telemetry": [
    {
      "mac": "F4:8E:38:AB:12:34",
      "rssi": -58,
      "txPower": 0,
      "type": "iBeacon",
      "uuid": "E2C56DB5-DFFB-48D2-B060-D0F5A71096E0",
      "major": 104,
      "minor": 12,
      "battery": 98,
      "temperature": 21.4,
      "humidity": 45.2
    }
  ]
}