Overview
Device location is managed via two main avenues:
- Location reported by the device
- Location set on partner space by administrators
The device reported location is used by default with the space's location being a fallback.
Device reported location
Any device type can pass its location information via the Send Telemetry API by adding two fixed keys:
| Key | Type | Value description |
|---|---|---|
| lat | Decimal | Latitude in degrees. Values will be clamped to the range [-90, 90]. This means that if the value specified is less than -90, it will be set to -90. And if the value is greater than 90, it will be set to 90. |
| lng | Decimal | Longitude in degrees. Values outside the range [-180, 180] will be wrapped so that they fall within the range. For example, a value of -190 will be converted to 170. A value of 190 will be converted to -170. This reflects the fact that longitudes wrap around the globe. |
Space location
Any space level administrator can use the End Customer portal to configure the space's (and all its children's) location via the Space's Settings tab.