Last modified: May 21, 2019 @ 11:10



Locations are where you register Gateways and Devices. Locations can easily be arranged in hierarchies through parent/child relationships, for example:

  • Country -> City -> Office Address
  • City -> Building -> Floor -> Room

Since hierarchies are agnostic to vertical, they are defined by the administrator and can have unlimited levels.

A Location does not have to be a geographically static place; it can be a vehicle such as a car, a bus, or a truck. Nor does it have to refer to a single, specific point. Since locations group things into logical categories, you could use Locations like Engines, Fans, Cows, or Boxes for asset tracking.

The position of a Location, Device, and Gateway can be plotted on a map or a drawing and shown on the Dashboard. This information can also be exposed via APIs and used when building end-user applications where information about position is needed.

Access Locations

Navigation: Dashboard -> Left-hand sidebar

  • Click on a Location to open it.
  • Click on the arrow to the right of any Location to see its child Locations.

Create/Edit Location

Navigation: Settings -> Locations

The Locations page shows the hierarchy of all Locations in the Device Network.

  • Click on the Device Network (has a cloud icon) to add a top level Location.
  • Click on any Location (has a house icon) to edit it or add child Locations to it.

Note that to delete a Location, you first have to delete its Devices and then its Gateways; see Gateway.