10 – Special custom-fields

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: 

Edit building

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: 

Custom fields building

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.  


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).   


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

Custom fields geofence

When we click on Other fields, the button will appear , the key and value options will appear to insert the custom field: 

Create Geofence with 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. 


Key = trainer_metadata 

Value = {“use_rf_ble”:”false”}  

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_metadatatrue {"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:

max_capacityinteger {"max_capacity":"20"} A maximum number of people that can be in the geofence.
warning_capacity_thresholdinteger {"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

Cartography Menu – POIS

When we click on Other fields, the button will appear , 2 fields will appear to enter Key and Value: 

Create POI with Custom Field

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: 

Pin Config

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.

Subscribe to our newsletter


Data controller: SITUM TECHNOLOGIES, S.L.
Contact: Data controller: situm@situm.es
Responsible for protection: dpo@situm.es
Purpose and legal basis: To manage the sending of SITUM newsletters only with consent.
Legitimation: Express consent of the interested party.
Recipients: The data will not be passed on to third parties with the exception of legal obligations.
Retention period: As long as the interested party remains subscribed to the newsletter (a link to unsubscribe will be available in each newsletter sent by Situm).
Rights: The interested party may at any time revoke their consent, as well as exercise their rights of opposition, access, conservation, rectification, limitation, deletion of data and not be subject to a decision based only on automated data processing, by writing to SITUM at the addresses indicated.
Additional Information: You can consult additional and detailed information on Data Protection in our privacy policy.

Please, download your copy here

Thank you for downloading our whitepaper. Please do not hesitate to contact us if you would like to know more about how our solutions can help your business. Download whitepaper

Close window