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 |