Request the Position of an Asset Tag

Example: Where is my Asset Tag located?

In https://iot.bluerange.io/asyncapi.html find the specification for asset_tracking. The topic looks like this:

rltn-iot/{organizationUuid}/{siteUuid}/{estimatorUuid}/indoor/{assetUuid}/positionEstimate

You can find the meaning of the elements and the necessary payload in this topic.

To find out whether an asset tag is currently moving or not, we utilize the speed sensor data given by the accelerometer on an asset beacon.

Get required information

This is the information required:

  • Organization UUID

  • Site UUID

  • Estimator UUID - the site Mesh Gateway

  • Asset UUID

Send GET request to endpoint /gofer/security/rest/organizations and retrieve parameter uuid as organizationUuid.

Example: 8893B9A0-78EB-4547-B80C-B8FF242A139B

Send GET request to endpoint /relution/api/v1/sites filter for parameter name and retrieve parameter uuid as siteUuid.

Example: 1ECF4C49-FFE0-4723-9EA4-7E95359E6D02

Send GET request to endpoint /relution/api/v1/devices filter for parameter deviceId(equals serial) and retrieve parameter uuid as estimatorUuid.

Example: 232BAD65-B2F9-4A2B-9293-72840E64D897

Send GET request to endpoint /relution/api/v1/devices filter for parameter deviceId(equals serial) and retrieve parameter uuid as assetUuid.

Example: CF4C41E9-FFE0-7234-EA94-D027E95359E6

Alternatively you can type a + instead of a assetUuid, you then created a single-level wildcard and would get the positionEstimates for every available Asset Beacon in this site.

So in total our topic would now look like this:

rltn-iot/8893B9A0-78EB-4547-B80C-B8FF242A139B/1ECF4C49-FFE0-4723-9EA4-7E95359E6D02/232BAD65-B2F9-4A2B-9293-72840E64D897/indoor/CF4C41E9-FFE0-7234-EA94-D027E95359E6/positionEstimate

You can now subscribe to this topic with a program like MQTT.fx and receive the MQTT messages with the specified payload. On how to use a program like MQTT.fx see: MQTT.

Get MQTT.fx here: https://mqttfx.jensd.de/

You will get values for a x and y coordinate each, determining the position of this asset on the BlueRange map.