Skip to content

Positioning settings reference

Complete reference for all positioning settings configurable per network.

Basic settings

Setting API field Default Min Max Description
Positioning enabled positioning_enabled true Enable or disable positioning for this network. Positioning is available on Pro and Enterprise plans.
Coordinate system positioning_coordinate_system gps gps (lat/lon) or local (x/y/z meters)

Update behaviour

Setting API field Default Min Max Unit Description
Movement threshold positioning_movement_threshold_meters 30 10 10,000 meters Minimum movement to trigger a position update
Heartbeat interval positioning_heartbeat_seconds 600 60 86,400 seconds Periodic update interval (even without movement)
Zone timeout positioning_zone_timeout_seconds 70 60 3,600 seconds Delay before reporting zone exit

Data collection

Setting API field Default Min Max Unit Description
Collection window positioning_window_seconds 90 30 3,600 seconds Time window for collecting measurements before calculating a position
Max measurement age positioning_max_measurement_age_seconds 900 60 86,400 seconds Oldest data included in calculation

Quality targets

Setting API field Default Min Max Unit Description
Target accuracy positioning_quality_target_accuracy 20 meters Positions meeting this threshold are delivered faster
Target age positioning_quality_target_age 120 60 3,600 seconds Positions calculated within this age of signal data are delivered faster

System thresholds

These values are not configurable but affect positioning behaviour:

Parameter Value Description
Good accuracy tier < 50 m Preferred hotspots for positioning
Acceptable accuracy tier 50–100 m Used when no good hotspots available
Max hotspot location age ~17 min (1,000 s) Hotspots with location data older than this are excluded

Questions? Contact Blecon support — we're happy to help.