Some special custom fields trigger certain behaviours or enable certain functionalities. Below, the custom fields are explained according to the application level.
Custom fields building level #
To do this we go to the left sidebar and click Buildings:
Later we select the edit building button
, located next to the Cartography title on the top menu:
Finally, we click on Other Fields, and a button will appear 
, which when we click on it, the key and value options will appear to insert the custom field:
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:
Key = beacons_uuids
Value = 059e0694-60d0-4c48-a6cd-ef4ee2987a93
Example for multiple beacon filters (separated by commas):
Key = beacons_uuids
Value = 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 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:
Key = wifi_virtual_mac_support
Value = true
Deactivate the GPS Indoor Mode (Calibrated & Uncalibrated) #
Both methods can be deactivated by setting the following custom-field at the building level: use_gps = False. This will cause Situm to not use GPS at all (regardless of how the app is configured).
Example:
Key = use_gps
Value = false
Random Forest #
Allows you to enable/disable the Wifi / BLE classifier for a building. It is used to give a better positioning in the change of plants with the SDK.
Wifi classifier :
Key = use_wifi_floor_classifier
Value: Boolean
BLE classifier:
Key: use_ble_floor_classifier
Value: Boolean
Asset Localization #
It allows filtering the devices to be positioned in the asset location service (location).
It allows to indicate a non-sliding temporary size, in minutes, that will be used to group positions.
Filter devices:
Key = filter-beacon
Value = List of macs in hexadecimal separated by commas
Time window size:
Key = update_window_minutes
Value = Integer representing the window size in minutes that will be used to group positions
Custom fields geofence level #
To add a custom Geofence field we go to Cartography-> Geofences:
When we click on Other fields, the button will appear , the key and value options will appear to insert the custom field:
Activating the Uncalibrated Indoor Geolocation Mode #
From the Dashboard, you can add configuration fences for a building.
To do this, a fence must be created in the area/plant in which you want to use that configuration parameter, with a custom field, whose key is trainer_metadata and a valid JSON value with the desired configuration parameter.
Example:
Key = trainer_metadata
Value = {“use_rf_ble”:”false”}
| Key | Value | Example | Behaviour |
|---|---|---|---|
| use_rf_ble | true/false | {"use_rf_ble":"true"} | Apply or not the RF weighing BLE to the particles of the plant and defined area |
| use_rf_wifi | true/false | {"use_rf_wifi":"true"} | Apply or not the weighing of Wi-Fi Random Forest to the particles of the plant and defined area |
| weight_factor | float | {"weight_factor":"0.9"} | applies a weighting factor to the particles in the defined area to prime or penalize them |
| passable | true/false | {"passable":"true"} | defines an area as passable or non-passable on the navigation map. |
| trainer_metadata | true | {"passable":"true", "use_gps":"true"} | generally used with “passable” to use GPS in uncalibrated areas. If the GPS gives the position in this area it reduces the confidence in the Wi-Fi |
• Functionality:
It allows modifying the positioning behaviour by indicating to the Real-Time Locating System that it should apply different behaviours in the area defined by the fence. Important: To apply the changes it is necessary to force the retraining of the model.
Capacity control in MRM Tracker #
Below we see the configurable options that notify users by notification when the capacity is going to be exceeded:
| Key | Value | Example | Behaviour |
|---|---|---|---|
| max_capacity | integer | {"max_capacity":"20"} | A maximum number of people that can be in the geofence. |
| warning_capacity_threshold | integer | {"warning_capacity_threshold":"80"} | Porcentaje de capacidad en el cual se notifica al usuario. |
Custom fields POIS level #
To add a custom POIS field we go to Cartography-> Points of interest:
When we click on Other fields, the button will appear , 2 fields will appear to enter Key and Value:
Custom fields organization level #
In addition to these, the Situm Team can implement others such as:
MRM Tracker Configuration PIN #
When a user tries to access the configuration section of the MRM Tracker, the system will ask them to enter a PIN to access. For this to happen we will put in Key pin_config and in Value the numerical value.
When you try to enter the configuration of the App, the following screen will appear:
MRM Tracker Logout PIN #
When a user tries to log out of the MRM Tracker, it will ask for a PIN in order to perform that action. To configure it we will put in Key pin_logout and in Value the numerical value.
Custom fields for internationalization #
Please take a look at Situm Dashboard Internationalization section to know more about how to use custom fields to internationalize cartography elements.
