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. 

Internationalization custom-fields #

Please take a look at Situm Dashboard Internationalization section to know more about how to use custom fields to internationalize cartography elements.

Map Viewer custom-fields #

In addition to what’s explained here, our Map Viewer has its own set of custom-fields. Take a look at them here.

Building custom-fields #

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

For this level there are the following modes:

Setting a building’s beacon filters #

Situm SDK, by default, only uses beacons with Situm UUID. 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: 

KeyValue
beacons_uuids059e0694-60d0-4c48-a6cd-ef4ee2987a93

Example for multiple beacon filters (separated by commas): 

KeyValue
beacons_uuids4afa9e5b-1445-4525-a5e2-3fa25ba98656,b05ab4c0-5e3e-4007-ade1-e6593f86b644

 To check that they are scanned correctly, in the Positioning menu, the number of WiFi APs and BLE beacons scanned is updated in real-time (1). By clicking on the dialog, you may see all the BLE beacon (2). In Layout you can see the number of uuidd if the beacon isn´t of Situm.

(1)
(2)
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.  

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

KeyValue
use_gpsfalse
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. These are true by default, if floor changes do not work properly, disabling them may improve transitions.

Wifi classifier : 

KeyValue
use_wifi_floor_classifiertrue/false

BLE classifier: 

KeyValue
use_ble_floor_classifiertrue/false
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:

KeyValue
filter-beaconList of macs in hexadecimal separated by commas

Time window size: 

KeyValue
update_window_minutesInteger representing the window size in minutes that will be used to group positions

Geofence custom-fields #

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

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:

Activating the Uncalibrated Indoor Geolocation Mode #

This method is used in 90% of the buildings. It can also be called enhanced GPS because, in addition to the GPS signal provided by Google, it adds the phone’s sensors, which provides greater accuracy.

To activate it go to the dashboard and 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. 

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.

Example: 

KeyValue
trainer_metadata{"passable":"true", "use_gps":"true"}
Random Forest #

Apply or not the RF weighing WiFi / BLE to the particles of the plant and defined area:

Wifi RF : 

KeyValue
use_rf_wifitrue/false

BLE RF: 

KeyValue
use_ble_floor_classifiertrue/false
Passable #

Defines an area as passable or non-passable on the navigation map.

  • Set the value to true if you want the GPS to be heavier in a certain area with good GPS accuracy and low WiFi.
  • Set the value to false, for example, to separate 2 areas with different uses or activities. For example to separate two zones that when calibrating by rail width have come together.
KeyValue
passabletrue/false
Weight Factor #

Refers to the weight factor or weighting factor that is assigned to different elements or variables in a positioning algorithm. This factor determines the relative importance of each element or variable in the final position calculation.

When positioning, a variety of signals or information are used to determine the location of an object or device. These signals may include GPS signal strength, time measurements, radio signals, and other relevant data. Each of these signals or data may have a different accuracy or reliability.

The weight factor is used to assign a weight to each signal or data based on its accuracy or reliability.

KeyValue
weight_factorfloat
Stationary Alarms #
  • max_stay_time: Configuration of the maximum time (in seconds) that a user can spend inside a geofence before triggering the alarm.
  • time_outside_limit: Following the request to be able to also parameterize the time to leave the geofence before resetting the counter we have created this parameter. That is, setting the maximum time (in seconds) that a user can leave the geofence before closing the session.
KeyValue
max_stay_timeinteger
time_outside_limitinteger

The following configuration has been used mostly in COVID times and for enclosures where you want to control the number of people inside:

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 Capacity:

A maximum number of people can be in the geofence.

KeyValue
max_capacityinteger

Warning Capacity Threshold:

Percentage of capacity at which the user is notified.

KeyValue
warning_capacity_thresholdinteger

POI custom-fields #

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

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

Suscríbete a nuestro boletín

INFORMACIÓN BÁSICA SOBRE PROTECCIÓN DE DATOS

Responsable del tratamiento: SITUM TECHNOLOGIES, S.L.
Contacto: Responsable del tratamiento: situm@situm.es
Responsable de protección: dpo@situm.es
Finalidad y base legal: Gestionar el envío de newsletter de SITUM sólo con consentimiento.
Legitimación: Consentimiento expreso del interesado.
Destinatarios: Los datos no serán cedidos a terceros salvo obligación legal.
Plazo de conservación: Mientras la parte interesada permanezca suscrita al newsletter (en cada newsletter enviado por Situm estará disponible un link para darse de baja).
Derechos: El interesado podrá revocar en cualquier momento su consentimiento, así como ejercitar los derechos de oposición, acceso, conservación, rectificación, limitación, supresión de datos y no ser objeto de una decisión basada únicamente en el tratamiento automatizado de datos, dirigiéndose por escrito a SITUM en las direcciones indicadas.
Información Adicional: Puede consultar la información adicional y detallada sobre Protección de Datos en nuestra política de privacidad.

Por favor, descarga tu copia aquí.

Muchas gracias por descargar nuestro whitepaper. No dudes en contactar con nosotros si quieres saber más sobre cómo nuestras soluciones pueden ayudar a tu negocio.


Cerrar ventana