Overview
A Device's effective location comes from one of two sources:
- Device-reported location — coordinates the Device sends via Telemetry.
- Space location — coordinates set by an administrator on the Device's Space.
The Device-reported location takes priority. The Space location is used only as a fallback when the Device has not reported its own.
Device-reported location
Any Device can report its location via the Send Telemetry API using two reserved keys:
| Key | Type | Description |
|---|---|---|
lat | Decimal | Latitude in degrees. Values are clamped to [-90, 90] — anything below -90 becomes -90, anything above 90 becomes 90. |
lng | Decimal | Longitude in degrees. Values outside [-180, 180] are wrapped — -190 becomes 170, 190 becomes -170 — to reflect that longitudes wrap around the globe. |
Space location
A Space-level administrator can set the location for a Space (and inherit it down to all child Spaces) from the Customer Portal, on the Space's Settings tab.