Locuna

Documentation

Documentation

Last updated: October 2025 · Developer: Sean O'Connor · Contact: support@locuna.net

Users

Users can logon via email, or OAuth (gmail or apple)

Groups

A user can create a group and be the group manager. Other users can join the group by entering the group secret code, provided by the group manager via some means, email etc. Group members will see the location updates and device information of all other members All users except the group manager can leave a group. The group manager must be a member, they only have the option of deleting the group. Users can only belong to one group. Group settings include the group name, and setting of work hours. These hours will be the times at which devices in the group will report their location. Users can customize the display name, and location icon of their device, within the group.

GPS location

Designed to try to filter out noise, and give accurate readings, through out the day, but also try to conserve battery.

The current location is sampled every geo reading with distance filter:50m, timeFilter:60s, accuracy:high (10m on iOS and between 0m and 100m on Android.) 10 second poll while the app is active

Geo events are written to the Locations/geo_events_{date}.log file The readings are filtered for one off, low accuracy readings, unexpected large jumps, and too small a change.

The UI receives these filtered locations.

Further filtering is performed to determine if the location should be uploaded. The outcome is written to the Locations/geo_smoothed_{date}.log file

Entering and exiting of zones is checked at this point

It is not uploaded if there is no network, or it is outside of business hours

If the distance moved is either beyond the accuracy, or beyond the configured minimum send distance threshold (default 50m) or we have a more accurate reading. We then check if enough time has elapsed, (foreground 60s, background 3mins) then send the updated location.