Some special keys trigger certain behaviors or enable certain functionalities

• Setting a building's beacon filters

Situm SDK, by default, only uses Situm beacons. If you want to use your own beacons, add a custom field with a key called beacons_uuids, and also add the list of beacon identifiers as a value of this key.

Example for one beacon filter:

beacons_uuids:059e0694-60d0-4c48-a6cd-ef4ee2987a93 

Example for multiple beacon filters (separated by commas):

beacons_uuids:4afa9e5b-1445-4525-a5e2-3fa25ba98656,b05ab4c0-5e3e-4007-ade1-e6593f86b644
 

• Activating WiFi enterprise mode
  

On certain corporate buildings, routers can emit on different MAC addresses, where the last hexadecimal digit changes. If this happens, it is necessary to activate the WiFi enterprise mode, in order to guarantee an accurate location information. In order to activate this mode, it is necessary to create a custom field with a key called wifi_virtual_mac_support and a value of true. 

Example:

 wifi_virtual_mac_support:true

• Activating the Uncalibrated Indoor Geolocation Mode

To activate this mode, the building must contain geofences in the outdoor areas where the GPS information will be used and each geofence must have the following custom-field: trainer_metadata = {"passable":"True","use_gps":"True"}

• Desactivate the GPS Indoor Mode (Calibrated & Uncalibrated)

Both methods can be deactivated by setting the following custom-field at building level:  use_gps = False. This will cause Situm to not use GPS at all (regardless of how the app is configured).