Optionaloptions: GpsOptionsOptional ReadonlyoptionsOptionalackTimeoutMs?: numberAck wait timeout when waitForAck is true. Default is 15000
OptionalautoStart?: booleanStart browser GPS automatically after a token is available. Set false when an app already owns GPS collection and only wants api.gps.send(...).
OptionaldeviceId?: stringStable device ID. Default is stored in localStorage
Optionalfield?: stringField key used by socket-server GPS storage. Default is coords
OptionalheartbeatMs?: numberSend a heartbeat even when the GPS position has not changed. Default is 5000
OptionalhighAccuracy?: booleanUse browser high-accuracy GPS. Default is true
Optionallabel?: stringHuman-readable label passed through to listeners
OptionalmaxAccuracyMeters?: numberDo not send non-heartbeat positions worse than this accuracy. Default is 200
OptionalmaxStaleMs?: numberReject GPS fixes older than this. Default is 4000
OptionalminDistanceMeters?: numberMinimum movement before sending a non-heartbeat update. Default is 3
Slice used by socket-server GPS storage
OptionalsocketUrl?: stringDedicated GPS socket URL override. Defaults to the standard socket-server URL
Optionalsource?: stringSource/app label passed through to listeners
OptionaltimeoutMs?: numberBrowser geolocation timeout. Default is 10000
OptionaltrackingId?: stringStable tracking ID for the object/person/vehicle being tracked.
If omitted, datalynk-client generates a unique tracker ID for this Gps instance. The default tracking ID is intentionally not based on sessionId, because one logged-in session/device may start more than one active tracker.
OptionalwaitForAck?: booleanWait for socket-server ack on manual send(). Default is false
OptionalwatchdogMs?: numberRestart watchPosition if no fresh fix arrives. Default is 60000
Listen to GPS updates for the configured slice/field
Send a position from an app-owned GPS engine.
By default returns after the message is queued/sent; set waitForAck to await server confirmation.
Start sharing browser GPS to socket-server
Stop sharing GPS and close the dedicated GPS socket
Browser/manual GPS sender backed by socket-server Redis GPS storage