Locations

A Location is a named physical place — a building, floor, room, outdoor site, or service area — that you attach Assets and Devices to. Locations have optional latitude/longitude, an optional address (via a Customer record), and an optional default Dashboard and Diagram that appear when someone opens an Asset assigned to that Location.

Overview

Use Locations when you have devices spread across multiple physical sites, when you want a map view of the fleet, or when different sites need different default dashboards. A Location is purely an organizational object — it does not generate data itself.

A Location can represent any spatial unit that's useful to you: a whole facility, a single floor, a piece of utility infrastructure, or an outdoor area. The platform does not enforce a hierarchy.

Properties

Field	Type	Notes
Name	string	Required. Shown in lists and on the map.
Latitude / Longitude	float / float	Optional. Required for map placement.
Customer	reference	Optional. Pulls the address from the linked Customer record.
Zoom	integer	Map zoom level shown when the Location is opened.
Bearing	float	Map rotation in degrees.
Pitch	float	3D camera tilt.
Dashboard	reference	Default Dashboard shown for Assets at this Location.
Diagram	reference	Default Diagram shown for Assets at this Location.

Creating a Location

Open Administration → Locations.
Click [+ New Location].
Enter a Name.
Optionally set latitude/longitude, link a Customer for the address, and set the map view (zoom, bearing, pitch).
Optionally pick a default Dashboard and Diagram.
Save.

Attaching Assets and Devices

From a Location's detail page, open the Assets tab and click Attach Asset. Pick the Assets you want at this Location and save. Devices follow whichever Asset they belong to — there is no separate "attach Device to Location" step.

To detach, open the same tab and remove the Asset.

Default Dashboard and Diagram

When a Location has a default Dashboard set, that Dashboard appears on the Asset page for every Asset attached to the Location. The same applies to Diagrams — useful for showing a SCADA-style view of the systems at one site.