Device location is managed via two main avenues:

  1. Location reported by the device
  2. 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:

KeyTypeValue description
latDecimalLatitude 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.
lngDecimalLongitude 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.